從計劃到任務
將計劃轉換為可執行的任務清單，讓 implement 代理可以遵循並逐項勾除。
- 每個工作項目都存放在
docs/specs/<YYYYMMDD>-<類型>-<名稱>/目錄中。 tasks.md沒有狀態欄位：其進度由[x]核取方塊表示。
開始之前
-
找出工作項目，並閱讀
plan.md和spec.md。 -
關卡： 如果計劃沒有
status: approved，則停下來並詢問：計劃的狀態是
<status>。我是否應該繼續進行、先使用review-spec審閱它、或者您現在會批准它？只有在得到明確回答後才繼續。對於沒有計劃的小規模變更，此關卡適用於規格文件。
-
閱讀
AGENTS.md中Commands區段的驗證指令（在西班牙語專案中為Comandos）。如果沒有，請詢問它是什麼，或者給結尾任務留下一個警告。
如何拆分
- 小任務：每個任務都是一個可審查的變更，且能讓專案保持綠色（測試通過）。
- 按依賴關係排序。標記
[P]表示那些可以與前一個任務平行執行的任務。 - 每個任務列出它影響的檔案（如果已知）以及如何驗證：哪個測試或哪個指令。
- 如果專案採用 TDD（
CONTRIBUTING.md或AGENTS.md中會說明），則測試必須在程式碼之前或與程式碼在同一個任務中，絕不能放在最後。 - 規格文件中的每個驗收標準以及安全性中的每個負面測試都必須至少由一個任務涵蓋。如果某個沒有被涵蓋，請說明。
- 收尾階段是強制的：驗收標準需通過測試，且驗證指令需顯示綠色。
- 不要添加計劃中未包含的工作。如果計劃中缺少某些內容，請提出問題。
結果
- 從
assets/tasks-template.md草擬tasks.md。 - 展示草稿，內容包含：
- 任務；
- 平行分組；
- 驗證點；
- 任何遺留的問題。
- 僅在使用者批准後才寫入檔案。
- 建議下一步：使用
implement代理來執行它。