Community写作与编辑github.com

troels-im/agent-skills-playbook-template

渐进式文档即代码模板,用于AI代理技能、AGENTS.md、剧本、工作追踪及just测试策略。

agent-skills-playbook-template 是什么?

该技能提供了一个低令牌指令表面,用于在仓库中管理流程,特别适合AI代理(如Claude Code、Coder、Codex等)使用。它通过读取AGENTS.md、根目录的index.md和flows/index.md文件来识别和选择最匹配的流程。执行时会创建带UTC时间戳的运行检查清单,仅加载当前步骤所需的剧本,并以指定格式(XX% / YY% / ZZ%)更新进度。该技能强制在执行每个提交前运行`just turn-test`,在流程最后一步运行`just pr-test`,确保测试通过或记录真实阻断因素。用户输入门控设计保证了在需要用户决策时暂停循环,避免AI代理错误推断需求。它支持任何遵循docs-as-code模式的AI代理平台,并且通过`/lets`命令与用户交互,避免了与其他常用命令的冲突。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add troels-im/agent-skills-playbook-template

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Lets

将此技能用作仓库流程的低令牌命令表面。

工作流程

  1. 读取 AGENTS.md。
  2. 读取根目录下的 index.md。
  3. 读取 flows/index.md。
  4. 选择最小的匹配流程。
  5. 加载所选的流程文件。
  6. 创建或更新以该流程命名的流程运行检查清单。 使用UTC时间戳生成的运行名称作为slug: run-YYYYMMDDTHHMMSSZ-short-slug.md。
  7. 仅遵循流程中指定的、且当前步骤需要的剧本。
  8. 使用流程要求的格式添加进度更新前缀: XX% / YY% / ZZ%: 消息。
  9. 在每次提交前运行 just turn-test。
  10. 在流程的最后一步,运行 just pr-test,修复失败的PR测试, 并重复直到PR测试通过或记录到真正的阻碍因素。

用户输入门控

当流程步骤需要用户输入、审批、产品决策或反馈才能继续时,暂停循环并询问。不要推断缺失的决策或基于猜测的需求继续。

仅在用户明确表示不要打扰、不要询问、用最佳判断进行或给出等价指令时,才无需询问继续。当这样做时,在运行检查清单中记录假设,并尽可能保持可逆。

如果没有匹配的流程,请明确说明,并通过 playbooks/repository/choose-workflow.md 进行路由。

不要将 /goal 或 /loop 视为本模板的用户命令。使用 /lets 作为用户面向的命令,使用 flows/ 作为持久的仓库层。

相关技能