Community寫作與編輯github.com

troels-im/agent-skills-playbook-template

漸進式文檔即程式碼模板,適用於 AI 代理技能、AGENTS.md、操作手冊、工作軌跡與 just 測試原則

agent-skills-playbook-template 是什麼?

此技能作為低 Token 消耗的命令介面,用於管理儲存庫工作流程。它提供一套結構化流程,透過讀取 AGENTS.md、根目錄 index.md 與 flows/index.md 來引導 AI 代理,並自動選取最小匹配流程,使用 UTC 時間戳記建立工作清單(如 run-YYYYMMDDTHHMMSSZ-short-slug.md)。技能定義了明確的步驟順序,包括進度更新格式(XX% / YY% / ZZ%)、強制執行 just turn-test 與 just pr-test 測試門檻,以及在需要使用者輸入時暫停循環的閘控機制。該技能支援任何可執行 Markdown 流程的 AI 代理平台(如 Claude Code、Cursor、Codex),並強調「文件即程式碼」原則,確保工作流程可重複、可追溯且易於版本控制。

相容平台~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

將此技能用作儲存庫流程的低 Token 命令表面。

工作流程

  1. 讀取 AGENTS.md。
  2. 讀取根目錄 index.md。
  3. 讀取 flows/index.md。
  4. 選取最小的匹配流程。
  5. 載入選取的流程檔案。
  6. 建立或更新由該流程命名的流程執行清單。 對產生的執行名稱使用 UTC 時間戳記的短語: run-YYYYMMDDTHHMMSSZ-short-slug.md。
  7. 僅遵循流程中指名且目前步驟需要的操作手冊。
  8. 以流程要求的格式加上進度更新前綴: XX% / YY% / ZZ%: message。
  9. 每次提交前執行 just turn-test。
  10. 在流程的最後步驟,執行 just pr-test,修正未通過的 PR 測試,然後重複直到 PR 測試通過或記錄到真正的阻礙。

使用者輸入閘控

當流程步驟需要使用者輸入、核准、產品決策或回饋才能正確繼續時,暫停循環並提問。不要推測缺少的決策或在猜測的需求上繼續。

僅在使用者明確表示不要打擾、不要詢問、請依最佳判斷繼續或給出同等指示時,才在無需詢問的情況下繼續。這樣做時,將假設記錄在執行清單中,並儘可能保持可逆性。

如果沒有匹配的流程,請清楚說明,並路由至 playbooks/repository/choose-workflow.md。

不要將 /goal 或 /loop 視為此模板的使用者命令。請使用 /lets 作為使用者面向的命令,並將 flows/ 作為持久的儲存庫層。

相關技能