Task Start

任務開始

Agent 開始執行任務時呼叫，將狀態從 assigned 改為 in_progress。

使用方式

/task-start 

參數

• $0: 任務 ID（如 T5）

執行步驟

1. 找到對應的任務檔案（支援 Sprint 子目錄）：

使用 Glob tool 搜尋 .tasks/**/$0-*.md，若無結果再搜尋 .tasks/**/$0.md。 取得檔案路徑後用 Read tool 讀取內容。

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

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

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

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

• 將 | 狀態 | ... | 改為 | 狀態 | in_progress |
• 將 | 開始時間 | ... | 改為 | 開始時間 | $NOW |
• 若 開始時間 已有非 — 的值，不覆蓋（代表曾被 blocked 後恢復，保留首次開始時間）
• 若找不到 | 開始時間 | 欄位，在 | 建立時間 | 行之後插入 | 開始時間 | $NOW |

1. 依賴檢查（必要）：

• 讀取任務檔的 | 依賴 | 欄位
• 若不為 —，使用 Glob tool 逐一找到依賴任務檔，確認其 | 狀態 | = done
• 任一依賴狀態非 done → 輸出 block 訊息並停止：

`` ⛔ $0 無法開始：依賴 {T?} 狀態為 {狀態}，尚未完成 ``

• 全部 done → 繼續

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

`` ### $NOW — 狀態變更 → in_progress 開始執行任務 ``

1. Git Branch 處理：

讀取任務檔的 | 並行組 | 欄位：

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

• 確認當前 branch 為 sprint-{N}（從任務檔 Sprint 欄位取 N）
• 若不在正確 branch，切換：git checkout sprint-{N}
• 輸出：📌 循序任務，在 sprint-{N} 直接開發

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

• 從任務標題產生 slug（小寫 kebab-case，最長 30 字元）
• 從 sprint-{N} 建立 task branch：

``bash git checkout sprint-{N} git checkout -b task/s{N}-$0-{slug} ``

• 輸出：🌿 並行任務，已建立 branch: task/s{N}-$0-{slug}

1. 輸出確認：

▶️ $0 狀態已更新為 in_progress

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.