Task Done

任務完成提交

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

使用方式

/task-done  [備註]

參數

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

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

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

必須使用以下英文值：

| 狀態值 | 說明 | |--------|------| | in_review | 待 L1 審查 |

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

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

> 系統解析器 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]
• 如果有項目無法確認完成，必須在備註中說明，不可跳過

1. 取得真實時間（必要，不可跳過）：

!node -e "console.log(new Date().toISOString())" > ⚠️ 禁止自行編造時間。Agent 不知道真實時間，必須透過上述指令取得。將輸出存為變數 $NOW 供後續步驟使用。

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

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

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

1. Git Commit：

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

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

1. 找到當前 dev-plan：

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

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

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Stanshy
• Source: Stanshy/AgentHub
• License: MIT
• Homepage: https://agenthub.stanshy.com/

Install and usage instructions live in the source repository linked above.