---
name: task-done
description: Mark a task as in_review (pending L1 review) and record in dev plan section 10
allowed-tools: Read, Edit, Glob, Bash
---

# 任務完成提交

更新任務狀態為 `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/` 根目錄。

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

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

4. 更新找到的任務檔案：
   - 將 `| 狀態 | ... |` 改為 `| 狀態 | in_review |`
   - 將 `| 完工時間 | ... |` 改為 `| 完工時間 | $NOW |`
   - **若 `完工時間` 已有非 `—` 的值，不覆蓋**（代表被退回後重新提交，保留首次完工時間）
   - **若找不到 `| 完工時間 |` 欄位**，在 `| 建立時間 |` 行之後插入 `| 完工時間 | $NOW |`
   - 在 `## 事件紀錄` 區塊底部 append：
   ```
   ### $NOW — 狀態變更 → in_review
   {備註}
   ```

5. **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)"
     ```

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

7. 在 dev-plan 第 10 節「任務完成紀錄」表格，找到對應任務行並更新：
```
| $0 | {YYYY-MM-DD} | 🔍 待審查 | {備註} |
```