writing-plans

writing-plans 技能是 Superpowers 方法論的核心組件，旨在連結抽象的專案規格與可執行的程式碼。它專為需要執行複雜程式設計目標、並要求結構完整性與遵循測試驅動開發 (TDD) 原則的軟體代理所設計。透過模擬資深架構師對缺乏程式碼庫背景的工程師進行指導的模式，此技能確保所有技術決策都是明確、模組化且可驗證的。

• 生成全面且細緻的實作計畫，將大型功能分解為 2-5 分鐘即可完成的小任務。

• 強制執行嚴格的 TDD 工作流程，要求定義失敗測試、最小化實作程式碼，以及每個元件的驗證週期。

• 強制要求精確的檔案路徑說明，確保工程師在開始工作前明確知道需要建立或修改哪些檔案。

• 為所有計畫提供標準化的 Markdown 標題，確保與子代理驅動開發或執行工作流程之間的一致性與清晰交接。

• 包含自我審查機制，在撰寫任何程式碼之前識別佔位符、型別不一致與覆蓋範圍缺失。

• 此技能應在腦力激盪階段確定專案規格後，且在任何 git 工作樹或實際程式設計任務開始前呼叫。

• 它需要輸入明確的專案規格或需求集；產出計畫的品質直接取決於這些需求的清晰程度。

• 產出內容必須儲存為 Markdown 檔案，理想情況下遵循 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md 的命名慣例以保持可審計性。

• 實際限制包括避免模糊的指令，如「新增驗證」或「處理邊緣情況」；每個任務必須包含具體的程式碼範例、精確的 CLI 測試指令以及具體的預期輸出，以防止歧義並確保自動化開發管線的成功。