task-done

任務完成提交

更新任務狀態為 in_review（待 L1 審查），並在開發計畫書第 10 節記錄。

使用方式

/task-done <task-id> [備註]

參數

• $0: 任務 ID（如 T1）
• $ARGUMENTS: 完整參數（含備註）

格式規範（系統解析依賴，務必遵守）

.tasks/ 狀態欄位（第 2 欄 | 狀態 | xxx |）

必須使用以下英文值：

狀態值	說明
in_review	待 L1 審查

dev-plan 第 10 節「結果」欄位（第 3 欄）

結果值	對應系統狀態	說明
🔍 待審查	in_review	已提交，待 L1 Review
🔧 需修正	in_review	需返工

系統解析器 normalizeStatus() 依賴 完成/✅/修正/🔧 等關鍵字判斷。

日期欄位（第 2 欄）

格式：YYYY-MM-DD

執行步驟

1. 找到對應的任務檔案（支援 Sprint 子目錄）： 使用 Glob tool 搜尋 .tasks/**/$0-*.md，若無結果再搜尋 .tasks/**/$0.md。 取得檔案路徑後用 Read tool 讀取內容。

任務檔案可能在 .tasks/sprint-{N}/T1-xxx.md，不再只在 .tasks/ 根目錄。

1. 驗收標準確認（必要）：

   • 讀取任務檔案，找到 ## 驗收標準 區塊
   • 逐項檢查每個 - [ ] 項目是否已完成
   • 將所有已完成的項目打勾：- [ ] → - [x]
   • 如果有項目無法確認完成，必須在備註中說明，不可跳過

2. 取得真實時間（必要，不可跳過）： !node -e "console.log(new Date().toISOString())"

   ⚠️ 禁止自行編造時間。Agent 不知道真實時間，必須透過上述指令取得。將輸出存為變數 $NOW 供後續步驟使用。

3. 更新找到的任務檔案：

   • 將 | 狀態 | ... | 改為 | 狀態 | in_review |
   • 將 | 完工時間 | ... | 改為 | 完工時間 | $NOW |
   • 若 完工時間 已有非 — 的值，不覆蓋（代表被退回後重新提交，保留首次完工時間）
   • 若找不到 | 完工時間 | 欄位，在 | 建立時間 | 行之後插入 | 完工時間 | $NOW |
   • 在 ## 事件紀錄 區塊底部 append：

   ### $NOW — 狀態變更 → in_review
   {備註}
   

4. Git Commit：

   • 讀取任務檔的 | 並行組 | 欄位
   • 若循序任務（並行組 = —）：確認當前在 sprint-{N} branch
   • 若並行任務：確認當前在 task/s{N}-$0-* branch
   • 判斷 commit type（feat / fix / refactor / docs / test / chore）
   • 執行：

     git add -A
     git commit -m "{type}: {任務標題} ($0)"
     

5. 找到當前 dev-plan： 使用 Glob tool 搜尋 proposal/sprint*-dev-plan.md，取最新一份用 Read tool 讀取。

6. 在 dev-plan 第 10 節「任務完成紀錄」表格，找到對應任務行並更新：

| $0 | {YYYY-MM-DD} | 🔍 待審查 | {備註} |