Community寫作與編輯github.com

dustinkeeton/wafflestack

🧇 一份麵糊,適用於所有儲存庫 — 將可重複使用的 AI 代理與技能定義,轉譯為各平台原生檔案 (.claude/, .codex/, .agents/)。

wafflestack 是什麼?

WaffleStack 是一個技能定義工具,旨在標準化並自動化 AI 代理的文件編排流程。它提供了一個管道,用於稽核程式碼庫的變更,並自動更新機讀文件 (AGENTS.md) 以及人讀文件 (DECISIONS.md, STATUS.md, ARCHITECTURE.md)。該技能支援以 Claude Code 為主的 AI 代理平台,並透過明確的步驟依賴關係,確保文件與實際專案狀態保持一致,從而減少開發者的手動維護工作。其核心概念是將可重複使用的定義「渲染」成各平台的原生檔案格式,提升跨平台的可攜帶性。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add dustinkeeton/wafflestack

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

文件編排

當呼叫此技能時,請執行以下管道:

步驟 1:架構稽核

生成 general-purpose 代理程式,並使用以下提示:

稽核目前程式碼庫,找出自上次文件更新以來的任何變更。讀取現有的機器文件(單一根目錄 AGENTS.md 註冊表),並與實際專案進行比較。產出簡潔的變更報告,涵蓋:

  • 新增或移除的 bundle、技能、代理程式、設定鍵或 CLI 命令
  • 變更的安裝程式匯出或範本語意 (installer/lib/*.mjs)
  • 與預留位置使用不同步的 bundle.yaml 設定宣告
  • 渲染輸出漂移:node installer/cli.mjs doctor --allow-missing 狀態為乾淨 (已提交的渲染與鎖定檔案同步 — 在編輯 bundle 後重新渲染並提交); .gitignore 仍涵蓋刻意不追蹤的渲染(標籤鉤子工作流程、工作樹、.waffle/ 概觀文件)

僅輸出結構化的文字變更報告。請勿修改任何檔案。

步驟 2:代理文件

取得變更報告,並生成 docs-agent 代理程式,使用以下提示:

這是 wafflestack 程式碼庫的架構變更報告:

{步驟 1 的輸出}

更新機器文件 — 單一根目錄 AGENTS.md 註冊表 — 以反映專案的當前狀態。請讀取實際的原始碼檔案以驗證細節 — 不要僅依賴變更報告。遵循 docs-agent 技能的格式與結構指南。

步驟 3:人讀文件

在 docs-agent 完成後,生成 docs-human 代理程式,使用以下提示:

機器文件剛剛更新完畢。請更新人讀文件 — 儲存庫根目錄下的 DECISIONS.md、STATUS.md 和 ARCHITECTURE.md — 使其一致。

請閱讀更新後的機器文件與實際原始碼以確保準確性。遵循 docs-human 技能的格式、結構指南及其保護措施(屬於所有者口吻的文件會被標記,絕不重寫)。

重要事項

  • 每個步驟必須完成後才能開始下一步 — 各步驟的輸出會影響下一步。
  • 步驟 1 為唯讀 — 稽核代理程式僅進行回報。
  • docs-agent 和 docs-human 應修改各自的文件檔案。

相關技能