task-approve

name	task-approve
description	Mark a task as done after L1 review passes
allowed-tools	Read, Edit, Glob, Bash

任務審核通過

L1 Review 通過後呼叫，將狀態從 in_review 改為 done。

使用方式

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

參數

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

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

.tasks/ 狀態欄位

狀態值	說明
done	L1 審核通過

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

結果值	對應系統狀態	說明
✅ 完成	done	審核通過

執行步驟

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

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

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

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

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

   • 將 | 狀態 | ... | 改為 | 狀態 | done |
   • 將 | 完工時間 | ... | 改為 | 完工時間 | $NOW |
   • 若找不到 | 完工時間 | 欄位，在 | 建立時間 | 行之後插入 | 完工時間 | $NOW |

4. 事件紀錄（必要，不可跳過）：在 ## 事件紀錄 區塊底部 append：

   ### $NOW — 狀態變更 → done
   L1 審核通過。{備註}
   

5. Git Merge（並行任務）/ 確認（循序任務）： 讀取任務檔的 | 並行組 | 欄位：

   若 並行組 = —（循序任務）：

   • code 已在 sprint-{N}，無需 merge
   • 輸出：📌 循序任務，code 已在 sprint-{N}

   若 並行組 = A/B/C...（並行任務）：

   • 取得 sprint 編號（從任務檔 Sprint 欄位）
   • 執行 merge：

     git checkout sprint-{N}
     git merge --no-ff task/s{N}-$0-{slug} -m "feat($0): {任務標題}"
     git branch -d task/s{N}-$0-{slug}
     

   • 若 merge 有衝突 → 停止，列出衝突檔案，由人工解決後繼續
   • 輸出：🔀 task/s{N}-$0-{slug} 已 merge 進 sprint-{N}，branch 已刪除

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

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

| $0 | {YYYY-MM-DD} | ✅ 完成 | {備註} |

8. 輸出確認：

✅ $0 審核通過，狀態已更新為 done