Agent Skills
› Stanshy/AgentHub
› task-done
task-done
GitHub將任務標記為待審查(in_review)，更新狀態、完工時間及事件紀錄，驗證驗收標準並提交Git。同時在開發計畫書第10節記錄任務完成情況，支援Sprint子目錄及並行分支管理。
Trigger Scenarios
用戶輸入 /task-done 命令
需要將開發任務狀態更變為待審查階段
Install
npx skills add Stanshy/AgentHub --skill task-done -g -y
SKILL.md
Frontmatter
{
"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
執行步驟
- 找到對應的任務檔案（支援 Sprint 子目錄）：
使用 Glob tool 搜尋
.tasks/**/$0-*.md，若無結果再搜尋.tasks/**/$0.md。 取得檔案路徑後用 Read tool 讀取內容。
任務檔案可能在
.tasks/sprint-{N}/T1-xxx.md，不再只在.tasks/根目錄。
-
驗收標準確認（必要）：
- 讀取任務檔案，找到
## 驗收標準區塊 - 逐項檢查每個
- [ ]項目是否已完成 - 將所有已完成的項目打勾：
- [ ]→- [x] - 如果有項目無法確認完成，必須在備註中說明，不可跳過
- 讀取任務檔案，找到
-
取得真實時間（必要，不可跳過）： !
node -e "console.log(new Date().toISOString())"⚠️ 禁止自行編造時間。Agent 不知道真實時間，必須透過上述指令取得。將輸出存為變數
$NOW供後續步驟使用。 -
更新找到的任務檔案：
- 將
| 狀態 | ... |改為| 狀態 | in_review | - 將
| 完工時間 | ... |改為| 完工時間 | $NOW | - 若
完工時間已有非—的值，不覆蓋（代表被退回後重新提交，保留首次完工時間） - 若找不到
| 完工時間 |欄位，在| 建立時間 |行之後插入| 完工時間 | $NOW | - 在
## 事件紀錄區塊底部 append：
### $NOW — 狀態變更 → in_review {備註} - 將
-
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)"
- 讀取任務檔的
-
找到當前 dev-plan： 使用 Glob tool 搜尋
proposal/sprint*-dev-plan.md，取最新一份用 Read tool 讀取。 -
在 dev-plan 第 10 節「任務完成紀錄」表格，找到對應任務行並更新：
| $0 | {YYYY-MM-DD} | 🔍 待審查 | {備註} |
Version History
- 5300820 Current 2026-07-24 12:11
