writing-plans

writing-plans 技能是為程式設計 AI 代理量身打造的工程工具，旨在彌合抽象需求與可執行程式碼之間的差距。在開始實作之前，此技能強制要求代理產生一份全面且可執行的藍圖。透過嚴格遵守測試驅動開發 (TDD)、YAGNI 和 DRY 原則，它確保即使是複雜的功能也能被拆解為 2-5 分鐘的微型任務。此技能適用於已有明確規格，但需要結構化、可靠的執行方式，且無需手動監督每一行程式碼的情境。

• 產生包含精確檔案路徑、所需程式碼片段及驗證指令的結構化實作計畫。

• 透過將測試優先的要求嵌入每個任務步驟，強制執行嚴格的紅-綠-重構 (Red-Green-Refactor) 循環。

• 將輸出標準化，要求每個計畫都必須包含特定標頭、目標定義與架構摘要。

• 嚴格禁止使用 TODO 或模糊的「加入錯誤處理」等佔位符，以防止常見的開發疏忽。

• 透過子代理驅動開發 (Subagent-Driven Development) 或內嵌批次處理，促進從計畫到執行的無縫銜接。

• 要求在產生任何程式碼之前進行系統化的檔案映射與架構拆解，確保模組化設計。

• 輸入：需要有效的專案功能規格或需求清單，建議由 brainstorming 技能產生。

• 輸出：儲存於 docs/superpowers/plans/ 的 Markdown 檔案，包含完整且可測試的任務清單。

• 限制：代理將目標受眾預設為缺乏專案上下文的開發者，因此所有步驟必須明確且自給自足。

• 最佳實踐：在專用的 git worktree 中使用此技能，以維持實作期間的工作區整潔。

• 審查：在提供執行交接之前，代理必須對佔位符模式、型別一致性及規格覆蓋率進行自我審查。

• 整合：與 executing-plans 及 subagent-driven-development 無縫整合，形成完整的自動化開發循環。