kharmanskyi/open-steps

这是什么？

核心功能

• 01以一屏结论汇报工作，涵盖完成状态、需要用户做的事和新增技术债。
• 02为非技术用户提供编号步骤，并先尝试自行完成任务再提问。
• 03把其他会话的声明与实际发生的情况逐条核对。
• 04在不丢失事实的前提下，把偏工程化的文本改写成通俗语言。
• 05维护 BIG-PICTURE.md，跟踪功能进度、无人使用的代码和排队中的任务。
• 06支持 Claude Code、Codex CLI、Cursor CLI 和 Gemini CLI。

适用场景

• 借助 AI 编程 Agent 做产品、需要判断工作是否完成的非工程人员。
• 希望获得通俗状态汇报而非提交日志的创始人或产品经理。
• 希望在接受 Agent 结果前，用另一个会话核实其说法的团队。
• 在迁移或上线等难以撤销的变更前进行风险评估。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/kharmanskyi/open-steps.git
2. 2

   将此套件安装为 Claude Code 插件

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

   将路由块添加到你的 Claude Code 指令文件中

   grep -q 'os-done-or-not' ~/.claude/CLAUDE.md 2>/dev/null || cat open-steps/docs/routing-block.md >> ~/.claude/CLAUDE.md

使用前须知

• !README 只完整测试了 Claude Code；在 Codex CLI、Cursor CLI 和 Gemini CLI 上的权限行为尚未测试。
• !套件可在检查通过且评审获批后自行合并拉取请求，除非任务中的备注另有说明。
• !更新需要同时在克隆目录执行 git pull 并更新插件，否则会保留旧版本。

标签

常见问题

open-steps 是什么？

面向 Claude Code、Codex CLI、Cursor CLI 和 Gemini CLI 的通俗语言 Agent 技能包，把会话汇报改写成普通人也能看懂的结论。 Open Steps 是一组 Agent 技能，用来改变编程 Agent 汇报工作的方式。它不输出提交哈希和工程术语，而是给出简短报告和明确结论：工作是否完成、是否需要用户介入、产生了哪些新的技术债，以及会话能否安全关闭。

open-steps 可以免费使用吗？用的什么许可证？

open-steps 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

open-steps 还在维护吗？

活跃维护中。open-steps 最近一次提交是在 2026年10月5日。

open-steps 适合用来做什么？

借助 AI 编程 Agent 做产品、需要判断工作是否完成的非工程人员。 希望获得通俗状态汇报而非提交日志的创始人或产品经理。 希望在接受 Agent 结果前，用另一个会话核实其说法的团队。 在迁移或上线等难以撤销的变更前进行风险评估。

open-steps 怎么安装和运行？

克隆仓库: git clone https://github.com/kharmanskyi/open-steps.git 将此套件安装为 Claude Code 插件: claude plugin marketplace add ./open-steps && claude plugin install open-steps@open-steps 将路由块添加到你的 Claude Code 指令文件中: grep -q 'os-done-or-not' ~/.claude/CLAUDE.md 2>/dev/null || cat open-steps/docs/routing-block.md >> ~/.claude/CLAUDE.md

在哪里获取 open-steps？

源代码和安装说明在 GitHub 上：https://github.com/kharmanskyi/open-steps