你正在將一個粗略的想法轉化成 TODO.md 中一個結構完善的任務。這個粗略的想法是:
$ARGUMENTS
這是一個提煉工作流程,不是實作。不要撰寫程式碼。 在任務清晰且使用者核准之前,不要寫入 TODO.md。請遵循以下步驟進行:
1. 閱讀憲法檔案
找到專案的憲法檔案並閱讀 — 遵守其中的慣例,特別是風險等級以及任何自主代理/待辦事項生命週期規則。
- 如果存在
sprint.conf,請按順序讀取SPRINT_CONSTITUTION_FILES中列出的檔案。 - 否則,讀取現有的
AGENTS.md或CLAUDE.md(以及它們引用的任何專案特定指南,例如前端的CLAUDE.md)。 - 如果
.githooks/README.md存在,請略讀,以便正確描述下游影響。
如果這些檔案都不存在,請告訴使用者此存放庫尚未啟動,並提供 /sprint:bootstrap。
2. 將想法植基於真實的程式碼中(不要猜測)
找出想法所觸及的實際符號/檔案及其影響範圍:
- 程式碼圖形(優先,如果可用):
mcp__codegraph__*工具(codegraph_search、…_callers、…_callees、…_impact、…_context),或 CLI(codegraph context "<the idea>"、codegraph callers <symbol>、codegraph impact <symbol>);如果索引看起來過時,請先執行codegraph sync .。 - 備援方案(無程式碼圖形):使用 Grep/Glob 找到相關符號及其呼叫者。
閱讀實際相關的幾個檔案。指出具體的函式/檔案以及變更的著陸點。
3. 詰問它(此技能的核心)
根據程式碼已經做的事情挑戰這個想法。指出:
- 這是一個問題還是一個任務?如果它實際上是一個問題(「……還是我遺漏了什麼?」),請先從程式碼中回答 — 現有邏輯可能已經涵蓋了部分內容。
- 真正的範圍以及能帶來價值的最小變更。
- 風險等級(根據憲法檔案 /
AGENTS.md)。如果是高風險,請說明 — 它將不會被自動實作;鏈會將其延遲給人類處理。 - 那些需要由使用者做出的決策,而不是你(產品/使用者體驗/政策選擇)。使用 AskUserQuestion 向使用者詢問那些少數決策。不要為真正的產品決策編造答案;使用程式碼庫中的證據糾正錯誤的假設。
4. 草擬一個結構化的項目(四個要素)
撰寫一個草稿,包含:
- 一個清晰的命令式任務(不是問題),
- 風險等級,
- 一個具體的完成標準(哪個目標測試必須通過 / 哪個行為是可驗證的),
- 來自步驟 2 的檔案/函式提示。
讓它保持最小的有價值變更。展示草稿並進行調整,直到使用者滿意為止。
5. 寫入 TODO.md,然後交接
- 將核准的項目作為
- [ ]條目新增到TODO.md的頂部附近。 - 詢問是否要將它設為唯一的活躍項目 — 如果是,請將其他目前活躍的項目移動到
<!-- … -->區塊(或根據跳過慣例放在## 🚧 Deferred下方),以便鏈只選取這個項目。 - 不要自動提交。 告訴使用者:提交
TODO.md會啟動規劃→實作→審查鏈(實作會落地到實作分支,沒有自動合併)。提供選項讓他們在想要現在開始流程時提交。
保持對話簡潔:先紮根實際情況,只詢問真正重要的決策,然後再撰寫。