進度報告
報告是一種確定性的投影。永遠不要為了維護報告而生成、保留、發送訊息或輪詢代理。 只記錄缺失的指派、決策或障礙事實。
從儲存庫根目錄執行 CLI：以下 progress 代表 python <skill 目錄>/scripts/progress.py
（.claude/skills/progress-report、.agents/skills/progress-report 或 $CLAUDE_PLUGIN_ROOT/skills/progress-report）。
每次輸入完整指令。動詞會輸出一行（refresh 不輸出任何內容）；請轉發該行。
何時使用
- 計劃檔案（帶有
- [ ]/- [x]項目的 Markdown）驅動工作：計劃模式，不需要 Spec Kit。 - Spec Kit 功能包含
specs/<feature>/tasks.md：功能模式；當 Workflow 檔案存在時，也會一併收集。
計劃模式快速入門
- 執行
progress hooks install --host claude（或codex；若要進行插件安裝，請加上--scope user）一次，以便為模型、工作量、上下文和子代理設定鉤子。跳過此步驟，任務仍會被追蹤。 progress init --plan docs/plan.md會建立.progress/plan/（請參閱--name、--dir）並印出bind=<nonce>；下一個鉤子會進行綁定（如果報告已存在，hooks install會印出一個綁定值）。- 在計劃檔案中勾選項目；報告會隨之更新。Progress 絕不會修改計劃檔案。
progress status會給出單行狀態；檢視頁面位於.progress/plan/.view/index.html。
項目若已有書寫的 ID（T001）則保留；其他項目會獲得穩定的 P001... 等 ID。如果只有一個計劃或功能處於活動狀態，則無需指定目標旗標；否則請傳入 --plan NAME 或 --feature DIR。
動詞
| 需求 | 指令 |
|---|---|
| 建立報告 | progress init --plan PATH [--name N] [--dir D] 或 progress init（Spec Kit） |
| 單行狀態 | progress status |
| 指派工作線 | progress lane L1 --tasks P001-P004 --owner ID --harness H --model M --effort E |
| 關閉工作線 | progress lane L1 --close |
| 障礙 | progress block P007 --by L2（或 P003、ext:"text"）；progress unblock B4 |
| 決策 | progress decide ask "問題" --options a,b；progress decide made D2 b --by user |
| 備註 | progress note "文字" --target P005 |
| 匯出 | progress export --format md |
| 鉤子 | `progress hooks install |
規則
- 當指派工作時記錄一個工作線（
L#；主機子項目C#會自動出現）。開始、完成和重試無需任何指令。 - 絕不要在備註中放入機密、絕對路徑或對話文字（最多 200 個字元）。
- 未知值保持未知。不要估計模型、工作量、上下文或時間。
- 錯誤訊息格式為
progress: error 代碼；請修正問題，不要重複嘗試。
詳細說明：references/verbs.md；合約 docs/contracts.md；旗標 docs/commands.md。