文件編排
當呼叫此技能時,請執行以下管道:
步驟 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 應修改各自的文件檔案。