open-steps

1. 基本信息

2. 功能介绍与亮点

open-steps 是一套围绕“把 agent 的技术输出翻译成不懂代码的人也能看懂的话”设计的技能包，共 8 个 SKILL.md，各自负责会话生命周期里的一个环节：

• os-done-or-not：会话收尾时产出十行以内的报告——一句话结论、结果对照表、验收裁定（是否完成/需要你做什么/是否有新债务），每个“是”都要求给出证据，查不到就写“未核实”。
• os-check-work：验收另一个会话交付的工作，逐项核对声称与实测（如“检查通过”要看具体通过数，而非复述结论），核实通过的工作可在同一轮直接合并。
• os-whats-next：读取最近报告、本地改动与开放 PR，给出唯一推荐的下一步，并注明它解锁了什么。
• os-step-by-step：需要用户亲自操作时（跑命令、粘贴密钥、点击确认），拆成无术语的单步指令。
• os-ask-simple：向用户提技术问题或选项前，先把问题改写为大白话，并给出一个带标记的推荐项。
• os-say-simple：把任意一段话（回答、评审意见、报错）压缩重述，保留全部数字与警告。
• os-what-could-go-wrong：重大决策前的预先验尸（premortem），假设方案已失败并倒推原因，覆盖九个风险维度。
• os-big-picture：维护一份 BIG-PICTURE.md，记录项目整体进度、哪些部分长期未碰、下一步排期。

亮点：

• 所有报告与状态文件保存在仓库之外（~/.claude/open-steps/reports/），不会污染代码提交历史。
• 配套两个 hook（session-start / stop）：工作有实质进展时自动拦截会话结束，强制先出报告，而非依赖用户记得手动触发。
• 附带 evals/ 评测框架（测试用例、评分脚本、结果记录）与四份跨 Agent 实测记录（docs/other-agents.md），作者亲自在 Codex、Cursor、Gemini CLI 上跑通并记录每个平台的差异与限制，诚实标注“未测试”的部分。
• 版本迭代密集（v0.4.1→v0.4.3 三天内三次发布），仓库最近一次提交为 2026-09-14。

3. 适用场景

所属分类：元技能与 Agent 增强

• 不写代码的产品经理/创始人独立使用 agent 开发产品，需要每次会话结束都拿到一份能看懂的进度与验收结论，而不是 commit 记录和工程术语
• 多个 agent 会话协作时，需要一个环节负责验收其他会话的交付物、决定能否合并
• 面向非技术用户做重大变更前，需要一份“预先验尸”式风险清单，而不是工程师视角的技术评审
• 与 handoff-mattpocock-skills（面向工程师本人的会话交接摘要）、session-viewer-openclaw-agent-skills（会话记录查看）功能相邻但受众不同：本技能包面向“看不懂代码的人”，前两者面向工程师本人

4. 跨 Agent 兼容性

• Claude Code：原生支持——插件市场一条命令安装，技能与两个 hook 均自动接线，是作者主要开发与测试的平台。
• Codex：原生支持——作者在 Codex CLI 0.145/0.151 实测，技能经共享目录 ~/.agents/skills/ 直接生效，两个 hook 脚本无需修改即可运行，仅需在 ~/.codex/config.toml 手动接线并信任 hook。
• OpenClaw：需适配——官方文档要求 SKILL.md 放在 ~/.openclaw/skills/<name>/SKILL.md，理论上可手动复制，但作者未测试，hook 自动化不确认可用。
• Hermes Agent：需适配——官方技能目录为 ~/.hermes/skills/，同样只能手动搬运 SKILL.md 本体，hook 联动未经验证。

5. 推荐理由

初中级用户最常见的落差不是“agent 做不好活”，而是“activity 做完了，但看不懂 agent 说了什么、能不能收工”。open-steps 把这道翻译工序做成了可复用的技能包，而不是每次让用户自己追问“能不能说人话”：报告结构固定（结论先行、证据可查、明确验收结论），配套的 stop hook 还替用户记住“这次有实质改动，该出报告了”，免去人工触发这一步。8 个技能覆盖了从提问、验收到风险预判的整条链路，对独立开发、不熟悉工程黑话的用户尤其友好。

6. 评分

安全检查清单： ① Shell 命令：allowed-tools 逐技能白名单，多数技能仅能读自身缓存目录；os-check-work/os-whats-next 额外开放 gh pr 系列命令，其中包含 gh pr merge——SKILL.md 正文明确写明“验证通过的工作可自动合并，除非任务指定仅按指令合并”，是公开设计而非隐藏行为，但确属较广权限 ② 联网外发：仅通过用户本机已登录的 gh CLI 访问 GitHub API 处理 PR，未见其他外发 ③ 凭据存储：复用用户既有的 gh 登录态，技能本身不索取或存储新凭据 ④ 可疑指令：通读全部 8 份 SKILL.md 及 hooks 脚本，未发现夹带推广、隐蔽外发或 prompt injection 迹象 ⑤ 作者信誉：真实具名开发者，2023 年注册的 GitHub 老账号，58 个关注者，公开身份与经营中的公司（与本技能包无关联业务），无造假或刷星迹象（fork 时间分布 23 天无爆发） ⑥ License：MIT，明确 ⑦ 维护时间：最近提交 2026-09-14，评估当周仍在活跃发布新版本

综合评分 = (6+9+8)/3 = 7.67

7. 跟同类 Skills 相比的优势

open-steps 的差异化在于把整条“agent 干完活→怎么让不懂代码的人验收”的链路拆成 8 个各司其职的技能，并用 hook 强制触发报告环节，而不是只提供单一的摘要或查看功能。

8. 用户评价

该技能目前在第三方平台尚无具名用户评价；已观察到的独立信号是 GitHub 上有多个外部账号将仓库 fork 后保留原名继续使用，以及具名外部贡献者提交过功能性 Issue 与 Pull Request（如新增 os-whats-built 技能的 PR #21）。

9. 其他补充

仓库自带 evals/ 目录（测试用例、多模型评分脚本、结果记录），以及六种语言的 README 翻译（西、法、俄、乌克兰、韩、中）。

10. 安装使用方式

Claude Code（推荐路径）：

git clone https://github.com/kharmanskyi/open-steps.git
cd open-steps  # 命令实际从该目录的上一级运行，见下

在存放 open-steps/ 的父目录下执行：

claude plugin marketplace add ./open-steps && claude plugin install open-steps@open-steps

安装后技能与两个 hook（会话开始时加载路由说明、会话结束前检测实质改动并要求生成报告）自动生效，无需重启。

Codex / Cursor / Gemini CLI：

mkdir -p ~/.agents/skills && cp -R open-steps/skills/os-* ~/.agents/skills/

随后按 docs/other-agents.md 说明手动接线各平台的 hook 配置文件（Codex 为 ~/.codex/config.toml，Cursor 为 ~/.cursor/hooks.json，Gemini CLI 为 ~/.gemini/settings.json），并追加 docs/routing-block.md 到对应的规则文件（AGENTS.md/GEMINI.md）。

OpenClaw / Hermes Agent：可手动将 skills/os-* 复制到各自的技能目录（~/.openclaw/skills/、~/.hermes/skills/），但 hook 自动化未经作者验证，需自行测试。

不需要时可用环境变量 OPEN_STEPS_DISABLE=1 临时关闭 stop hook 的拦截。

11. 注意事项

• os-check-work、os-whats-next 两个技能在验证通过后可自动执行 gh pr merge，直接合并 Pull Request——如需人工把关合并环节，应在任务说明中显式要求“仅按指令合并”。
• hook 自动化目前只在 Claude Code、Codex、Cursor、Gemini CLI 上验证过；OpenClaw、Hermes Agent 只能手动安装 SKILL.md 本体，进度拦截与自动出报告不保证生效。
• 报告与状态文件保存在 ~/.claude/open-steps/（跨平台复用同一路径，与工具名无关），删除该目录会丢失历史报告与去重指纹。