agent-status

agent-status は何をしますか？

このスキルは、プロジェクトエージェントがマルチステップ作業を行っており、人間が実際に何が起こっているかを把握する必要がある場合に使用します。

このスキルは意図的にダッシュボードジェネレーターではありません。マシン可読な成果物に支えられた真実の表面を生成します。

.plan-iterate/<campaign-id>/status/
  status.json
  events.jsonl
  proof_manifest.json
  STATUS.html

HTMLは現在のステータス成果物のみをレンダリングします。進捗、パーセンテージ、完了主張をでっち上げてはいけません。

核となる原理

ステータス成果物が先 → HTMLが成果物をレンダリング → 人間が証拠を検査できる

これを絶対にやってはいけません:

きれいなページが先 → 曖昧な緑色の表現 → 人間が進捗を推測する

必須の最初のビューポートでの回答

生成されたステータスページは以下に答える必要があります:

1. エージェントは何を完了しようとしているか？
2. 今どこにいるのか？
3. 何がちょうど通過したか？
4. まだ証明されていないことは何か？
5. 次のアクションは何か？
6. エージェントは実行中か、ブロック中か、アイドル中か、人間を待っているか？
7. 現在の主張を裏付ける証拠は何か？
8. エージェントが次にすべきでないことは何か？

状態モデル

許可される状態:

• not_started
• running
• needs_attention
• blocked
• failed
• passed_scoped_gate
• done
• idle

重要な区別:

passed_scoped_gate != done

最終的な目標に明示的な最終証明成果物がある場合にのみ done を使用します。

一般的なコマンド

キャンペーンを初期化する:

./run.sh init \
  --campaign refactor-harness-e2e \
  --goal "Finish scoped refactor harness E2E proof"

ゲートを実行中としてマークする:

./run.sh update \
  --campaign refactor-harness-e2e \
  --state running \
  --current-step "Run hardened concurrent LLM + OpenCode summarize gate"

スコープ付き通過ゲートを記録する:

./run.sh gate-passed \
  --campaign refactor-harness-e2e \
  --label "A01-A18 hardened concurrent LLM + OpenCode summarize" \
  --verdict PASS_SPEC \
  --proof ".plan-iterate/refactor-harness-e2e/proof/refactor-concurrent-mixed.json" \
  --next-action "Start reviewer packet + reviewer fan-in phase" \
  --not-proven "Transport Room B1 UI" \
  --not-proven "build_review_packet reviewer fan-in" \
  --not-proven "Full OpenCode message delivery"

人間に決定を求める:

./run.sh needs-human \
  --campaign refactor-harness-e2e \
  --question "エージェントは次にどのキャンペーンを実行すべきですか？" \
  --option "A=ハーネスを継続: レビューパケット + レビューファンイン" \
  --option "B=トランスポートUI: トランスポートルームB1の開始" \
  --option "C=安定化のみ: チェックポイントを取って停止"

ステータスページを再レンダリングする:

./run.sh render --campaign refactor-harness-e2e

アンチダッシュボード劇場ルール

1. パーセンテージは禁止。
2. 最終目標の証拠がない限り、緑色の「完了」は禁止。
3. すべてのPASSはその証明成果物を指定しなければならない。
4. すべてのステータスは何が証明されていないかを表示しなければならない。
5. すべてのアイドル状態は、なぜエージェントがアイドルなのかを述べなければならない。
6. すべての人間待ち状態には決定メニューを含めなければならない。
7. すべてのブロック状態は、欠落している成果物、サービス、ゲート、または決定を指定しなければならない。
8. 自動更新は、ページが status.json を読み取る場合にのみ許可される。
9. status.json が古い場合、ページは古いと表示しなければならない。
10. レビューアの評決は領収書であり、完了の証明ではない。

いつ使用するか

これを使用するのは:

• /plan-iterate
• /orchestrate
• /review-design
• /review-code
• /debugger
• /ask deep-review
• /code-runner
• /subagent-runner
• 1つのフォーカスされたコマンド以上の時間がかかるマルチステップのプロジェクトエージェント作業全般

成果物の期待値

status.json が真実のソースです。

events.jsonl は追記専用で、状態遷移を記録します。

proof_manifest.json はステータス要求によって指定された証明成果物をリストします。

STATUS.html は生成され、古さを認識し、ブラウザで安全に開くことができます。

完了基準

長時間実行されるエージェント作業に対する最終回答は、現在のステータス成果物を要約し、可能な場合は STATUS.html パスをリンクまたは引用する必要があります。

以下の場合を除き、完了を主張してはいけません:

• 状態が done である;
• last_completed.proof_path が最終証明成果物を指している;
• not_proven が空であるか、明示的に範囲外である;
• ブロッカーが空である。