manage-run

Archon の実行を管理する

archon CLI を使ってワークフローの実行を管理するための専用スキルです。Archon はすでにインストール済みで、プロジェクトのリポジトリ内で作業していることを前提としています。現在のディレクトリにより、すべてのコマンドの対象プロジェクトが自動的に決まります。ワークフローの作成、セットアップ、設定には、より幅広い archon スキルを使用してください。

最近の実行（ライブ）

!archon workflow runs --limit 10 2>&1 || echo "Archon CLI not installed. (This skill needs the archon CLI on PATH.)"

出力の仕組み

• 任意のコマンドに --json を追加すると、標準出力に単一のクリーンな JSON オブジェクトが出力されます（--json モードではログは自動的に抑制されます）。結果を解析する場合は --json を優先してください。
• --json を指定しない場合、人が読みやすいテキストが出力されます。診断情報や警告は常に標準エラー出力に送られます。
• 現在のディレクトリ（cwd）によって、表示されるプロジェクトの実行が決まります。リポジトリから実行してください。

コマンド

目的	コマンド
最近の実行を一覧表示（すべてのステータス、このプロジェクト）	archon workflow runs --json
すべてのプロジェクトを対象に一覧表示	archon workflow runs --all --json
ステータスで絞り込み／行数の上限を指定	archon workflow runs --status running --limit 50 --json
1 件の実行を表示（ステータス、エラー）	archon workflow get <run-id> --json
1 件の実行をノードごとの詳細付きで表示	archon workflow get <run-id> --verbose --json
アクティブな実行のみ（実行中／一時停止中）	archon workflow status --json
実行を開始（ブロックしない）	archon workflow run <workflow> "<message>" --detach
一時停止中のゲートを承認	archon workflow approve <run-id> "looks good" --json
完了条件を満たしたループゲートを承認して完了	archon workflow approve <run-id> --json（コメントなし）
一時停止中のゲートを却下	archon workflow reject <run-id> "fix X first" --json
実行中の CLI --detach の実行を積極的に停止	archon workflow cancel <run-id> --json
一時停止中または孤立が確認された実行を、ホスト側の処理を停止せずにキャンセル済みとしてマーク	archon workflow abandon <run-id> --json

パターン

実行の完了まで監視する

archon workflow runs --json                 # find the run id
archon workflow get <run-id> --json         # poll status: running | completed | failed | paused

status が completed、failed、または cancelled になった時点で、実行は終了です。

ブロックせずに作業を開始する

archon workflow run archon-assist "Investigate the flaky test" --detach
# returns immediately; the run then appears in `archon workflow runs`

--detach は、子プロセスでワークフローをバックグラウンド実行します。新しい実行 ID は子プロセスで作成されるため、親プロセスからは表示できません。archon workflow runs で確認してください。実行が表示されない場合は、コマンドが出力した子プロセスのログパス（または --detach --json の logPath フィールド）を確認してください。

コンソール UI に関する注意： デタッチされた実行は、別プロセスで実行されている場合でも、Web コンソールの Workflow ドックに表示され（ドックにはプロジェクトごとの実行が一覧表示されます）、リアルタイムで更新されます。サーバー側のポーラーがワークフローイベントテーブルを監視し、新しい行をコンソールのライブフィードに再送します（PostgreSQL では NOTIFY トリガーにより同じ秒内にプッシュされ、SQLite ではポーラーが短い間隔で取得します）。更新は不要です。

一時停止中の実行を承認または却下する（2 ステップ）

--json の approve／reject／resume は判断を記録し（実行は再開可能な状態になります）が、ワークフローは実行しません。実行すると、JSON を破損させる出力がストリーミングされるためです。そのため、次のようにします。

archon workflow approve <run-id> "ship it" --json   # records the approval (resumable: true)
archon workflow resume <run-id>                      # execute it — run this as a BACKGROUND task
archon workflow get <run-id> --json                  # poll until completed/failed

ゲートの判断を記録するだけでよく、その後のキャンセルまたは手戻りの処理を進める必要がない場合は、--json のステップだけで十分です。ブロックする呼び出し 1 回で承認して続行するには、--json を省略します。archon workflow approve <run-id> "ship it" は自動的に再開します（バックグラウンドタスクとして実行してください）。

インタラクティブループのゲート：コメントなしなら承認して完了

一時停止中のインタラクティブループゲートが宣言された完了条件を満たした場合 （archon workflow get <run-id> --json → .metadata.approval.completionSignaled が true）、コメントなしで承認すると完了を受け入れます。再開時に、すでに計算済みの出力からノードが確定され、再実行はされません。コメントありで承認すると、そのコメントをフィードバックとして次のイテレーションを実行します。まずゲートの状態を確認してから、慎重に選択してください：

archon workflow get <run-id> --json | jq .metadata.approval.completionSignaled
archon workflow approve <run-id> --json          # accept & complete (finalize, no re-run)
archon workflow approve <run-id> "redo X" --json # run another iteration with feedback

（プロジェクトスコープのチャットでは、manage_run ツールの承認アクションも同じ動作をします。message を指定しない場合（または accept: true を指定した場合）は確定し、message を指定するとイテレーションが実行されます。）

リファレンス

各動詞のフラグ一覧と JSON 形式の詳細については、references/commands.md を参照してください。