進捗レポート
レポートは決定論的な投影です。それを維持するためだけにエージェントを生成、保持、メッセージ送信、ポーリングしないでください。不足している割り当て、決定、ブロッカーの事実のみを記録してください。
CLIはリポジトリルートから実行します：以下のprogressはpython <スキルディレクトリ>/scripts/progress.pyを意味します
(.claude/skills/progress-report、.agents/skills/progress-report、または$CLAUDE_PLUGIN_ROOT/skills/progress-report)。
毎回完全なコマンドを入力してください。動詞は1行を出力します（refreshは何も出力しません）。そのまま中継してください。
使用すべきタイミング
- 計画ファイル（
- [ ]/- [x]項目を含むMarkdown）が作業を駆動している場合：計画モード、Spec Kitは不要です。 - Spec Kit機能に
specs/<機能>/tasks.mdがある場合：機能モード。Workflowファイルは存在する場合に収集されます。
計画モードのクイックスタート
progress hooks install --host claude（またはcodex。プラグインインストールの場合は--scope userを追加）を1回実行します。モデル、労力、コンテキスト、子エージェント用です。スキップしてもタスクは追跡されます。progress init --plan docs/plan.mdで.progress/plan/を作成し（--name、--dirを参照）、bind=<nonce>を出力します。次のフックがバインドします（レポートが存在する場合、hooks installは1つを出力します）。- 計画ファイル内の項目をチェックオフします。レポートが追従します。Progressは計画を書き換えません。
progress statusで1行の状態を表示します。ビューは.progress/plan/.view/index.htmlです。
項目は書き込まれたID（T001）を保持します。それ以外は安定した P001... ID を取得します。1つの計画または機能のみがアクティブな場合、ターゲットフラグは不要です。それ以外の場合は --plan NAME または --feature DIR を渡します。
動詞
| 必要な操作 | コマンド |
|---|---|
| レポートを作成 | progress init --plan PATH [--name N] [--dir D] または progress init (Spec Kit) |
| 1行の状態 | 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 CODEと読み取ります。原因を修正し、ループで再試行しないでください。
詳細：references/verbs.md。契約 docs/contracts.md。フラグ docs/commands.md。