Open Steps Skill：让 AI 编码 Agent 改用大白话汇报的关键插件

Skill超级捕获手 技术创作者 2026-09-24 12 阅读

当 AI 编码 Agent 用「session TTL misconfig in auth middleware caused 401 cascades after key rotation; patched the refresh path, invalidated stale JWTs, redeployed api+web. p95 back to 180ms」这样的术语汇报工作时，不是工程师的产品人根本无法判断「这件事到底做完没有」。这正是 Open Steps Skill 要解决的核心痛点——强制 Agent 用大白话汇报，结论单独成行，坏消息不许藏进段落中间。它由非工程师创始人 Pavlo Kharmanskyi 于 2026 年 8 月推出，仅一个月就冲上 GitHub Trending 与多个 Skill 目录热门。

功能与原则

Open Steps 是一组 8 个可加载 Skill（os-done-or-not、os-step-by-step、os-ask-simple、os-whats-next、os-check-work、os-say-simple、os-what-could-go-wrong、os-big-picture）+ 2 个 hook（session-start.sh、stop-report.sh）+ 一段路由块（写入 ~/.claude/CLAUDE.md）。

核心原则三条：

  • 诚实优于完整：git、gh 是可选，没装就老实写「未检查」，不编一份看似完整的结论。
  • 结论与风险分离：用固定结构把「是否完成 / 需要你做什么 / 新增技术债 / 可否关闭」拆成独立行，坏消息单独成行而不混在叙述中。
  • 零工程友好：作者本人不是工程师，公司里带 50+ 开发者，自己 vibecoding 做产品撞墙后写的——所以输出专门优化给不懂工程的人读。

认可度

  • GitHub Stars 870（截至 2026-09-22，来自 GitHub Digest）
  • Forks 66（截至 2026-09-22）
  • 触发率实测：21 句短语各问 3 次；Haiku 4.5 = 87%、Sonnet 5 = 95%、Opus 5 = 100%（README 2026-08-29 表格）
  • Trending 经历：进入 linny006/trending-claude-skills 自动榜 9/22 当周收录；GitHub Digest 2026-09-22 当期收录
  • 多平台收录：agentskillshub.top、claudeers.com、myaiexp.com、opensteps.ai（官方主页）

链接

GitHub：https://github.com/kharmanskyi/open-steps

官方主页：https://opensteps.ai

原作者

Pavlo Kharmanskyi（GitHub: @kharmanskyi）。二十年产品经验的「市场驱动型 builder」——专挑已有需求但基础设施缺位的缝隙建东西。公司带 50+ 开发者，日常从产品视角切入。Open Steps 是他自己 vibecoding 做产品时撞墙的副产物，「不会写代码、但要判断 AI 干得对不对」这个真实场景逼出来的工具。

介绍

Open Steps 不改 Agent 怎么写代码，只改 Agent 怎么汇报。装上之后，Claude Code 在每个会话结束时会自动调用 os-done-or-not，把刚才做的工作翻译成一张一屏可读完的结论表：

People can sign in again. A bug was logging people out because their
sessions expired far too early. The fix is live for everyone.

✅ Response times are back to normal
⚠️ Until this shipped, people were being logged out over and over.

Fully done? Yes
Anything needed from you? No
New debt? Two small ones, written down
Safe to close? Yes

而同一件事，原始 Claude Code 输出是：「Hotfix deployed: session TTL misconfig in auth middleware caused 401 cascades after key rotation; patched the refresh path, invalidated stale JWTs, redeployed api+web. p95 back to 180ms. Root cause: env drift after the 09-14 rollout. Two flaky e2e specs quarantined (known, tracked)…」

事实一字不减，但人话版可以让产品人、PM、技术 lead 一眼判断能不能发版、能不能睡觉。

特点

  • 8 个 Skill 全场景覆盖：os-done-or-not 一屏结论、os-step-by-step 逐步讲解、os-ask-simple 简化解说、os-what-could-go-wrong 主动暴露风险、os-big-picture 全局视图。
  • 诚实优于完整：git/gh 未安装时输出写「not checked」而非编造，把不确定性显性化。
  • 零工程友好：专门为不懂代码的产品人、独立开发者设计，输出结构对非技术读者透明。
  • 跨 Agent 兼容：Claude Code 零额外步骤全功能可用，技能与路由块也支持 Codex、Cursor、Gemini CLI。
  • 两段路由块写入 CLAUDE.md：把「模型偶尔想起来用」变成「长对话里也不会丢」的硬规则。

使用方法

Claude Code 完整接线（推荐）：

git clone https://github.com/kharmanskyi/open-steps.git
cd open-steps   # 注意是从 clone 的父目录运行
claude plugin marketplace add ./open-steps
claude plugin install open-steps@open-steps
claude plugin details open-steps

然后在 agent 里跑 /open-steps:os-install-check，它会报告哪些接好了、哪些没接。

Codex / Cursor / Gemini CLI：把 Skill 文件夹拷到 ~/.agents/skills/。

手写路由块：在 ~/.claude/CLAUDE.md 里追加一段，让 Skill 从「可选」变「必触发」。

使用场景与人群

  • 非技术创始人 / 独立开发者：vibecoding 做产品时每天要判断「能不能发版、能不能睡觉」。
  • 产品经理 + 技术负责人：把 Agent 会话记录当向上汇报的原材料，坏消息自动单列成行。
  • 带小团队的技术 lead：让非工程同事也能看懂 AI 干完的活，省掉一道人工翻译。
  • 教育场景：带学生上手 Claude Code，让学习者拿到的是「做了什么 / 结果如何 / 风险在哪」而不是技术流水账。

输入与输出案例

输入（原始 Agent 输出）：

Hotfix deployed: session TTL misconfig in auth middleware caused 401 cascades after key rotation; patched the refresh path, invalidated stale JWTs, redeployed api+web. p95 back to 180ms. Root cause: env drift after the 09-14 rollout. Two flaky e2e specs quarantined (known, tracked)…

输出（Open Steps 处理后）：

People can sign in again. A bug was logging people out because their sessions expired far too early. The fix is live for everyone.

✅ Response times are back to normal
⚠️ Until this shipped, people were being logged out over and over.

Fully done? Yes
Anything needed from you? No
New debt? Two small ones, written down
Safe to close? Yes

第二个例子：生产发布完成后，问 Agent「Are we done?」

  • 输入触发：All done? 或 /open-steps:os-done-or-not
  • 输出：四行结构化判断（完成度 / 需要人做什么 / 新增债务 / 是否可关闭），均带 ✅/⚠️ 标识

Open Steps 把「AI 在干活但说不清楚干完没」这个最容易被忽视的体验痛点，变成了一行命令就能装的解决方案。它不是炫技框架，是写给每一个「被 Agent 汇报困住过的产品人」的实用工具。

GitHub: https://github.com/kharmanskyi/open-steps

评论区

0 条评论

登录后可评论。

Skill超级捕获手 12 阅读