Communityコーディング&開発github.com

Argus ランタイムオーケストレーション

5台のホストにわたる永続的なArgusミッションのためのポータブルな外部オペレーター手順。

Argus ランタイムオーケストレーション とは?

このスキルは、永続的な状態、アーティファクト、実験、バックグラウンド実行、独立したレビュー、一時停止/再開、または1つのモデルターンを超えた継続を必要とするタスク向けに設計された、Argusミッションのための構造化された外部オペレーター手順を提供します。OpenClaw、Hermes Agent、Claude Code、Codex CLI、Copilot CLIなどのシェル対応エージェントが、Argus(耐久性のある監視対象システム)と連携してミッションをステージングし、実行し、監視するための明確な2者間運用モデルを定義します。このスキルは、外部オペレーターとArgusの役割を分離し、Argusの内部モデル/プロバイダー構成を外部オペレーターのアイデンティティから独立した実装の詳細として扱うことを強調しています。これは、作業ディレクトリのセットアップ、入力のステージング、事前飛行チェック、ミッションのディスパッチ、アーティファクトの検証、保留中の質問ループ(特に`waiting on you : N unanswered question(s)`シグナル)を含む15のコア操作手順をカバーし、クローズアウトまで行います。また、既知の制限(例:ユニバーサルなプッシュ/コールバックの欠如、ドキュメント検証のみのアダプター)と、シェルやプロセスAPIなしなどの機能低下シナリオに対応するためのフォールバック手順も扱います。このスキルは、外部オペレーターがArgusを監視し、それと対話するための堅牢なプロトコルを提供し、各ミッションが明確に定義された自律性と承認の制限内で動作することを保証します。

対応✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/Argus-AiTeam/argus-counterexample-runtime/tree/HEAD/integrations/agent-skills/argus-runtime-orchestration

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Argus ランタイムオーケストレーション は何をしますか?

永続的な状態、アーティファクト、実験、バックグラウンド実行、独立したレビュー、一時停止/再開、または1つのモデルターンを超えた継続が役立つタスクに使用します。クイックアンサー、単純な読み取り専用の検査、または現在のホストが安全に完了し直接検証できる小さな操作には使用しないでください。

既知の制限

  • Argusは、ユーザーの応答が必要からすべての外部オペレーターへの普遍的にポータブルなプッシュ/コールバックを提供しません。外部オペレーターは、意味のある境界でコンパクトなArgusのステータス/出力を能動的に検査する必要があります。ホストが耐久性のあるモニタリングを維持できない場合、介入の検出はリアルタイムではない可能性があり、このスキルはその場合の無人監視を主張することを禁じています。
  • Hermes AgentおよびClaude Codeアダプターは、現在、このホストでローカルに実行テストされているのではなく、ドキュメントで検証されています。
  • 現在のドキュメントにある一部のCopilot CLIスキルコマンドが、ローカルでテストされた1.0.39ビルドには存在しないため、機能検出が必要です。

二者間運用モデルと設定

運用上の当事者は正確に2つです:

  1. 外部オペレーター:OpenClaw、Hermes Agent、Claude Code、Codex CLI、Copilot CLI、またはこのスキルに従う他のシェル対応エージェント。ミッションをステージングし、Argusを起動して監視し、委任された権限内でオペレーターの質問を処理し、アーティファクトを検証し、コンパクトに報告します。
  2. Argus:計画、実行、レビュー、状態の永続化、質問の表面化、証拠とアーティファクトの生成を行う耐久性のある監視対象システム。

Argusが内部的に使用するモデル/プロバイダーCLI(codex、copilot、claude、pi、opencode、grokなど)は、Argusの設定であり実装の詳細であり、この手順における第三の役割、ピアアクター、または別の関係者ではありません。外部オペレーターは、運用上必要であり許可されている場合、フライト前チェック中にArgusの設定された内部モデル/プロバイダーを選択または検証してもかまいません。それ以外の場合は、Argusを1つの耐久性のある監視対象システムとして扱います。名前が偶然一致した場合でも、外部オペレーターのIDからArgusの設定を推測しないでください。

実行可能ファイルを明示的に解決します。1つの普遍的なインストールパスを想定しないでください。POSIXシェル:

if [ -n "${ARGUS_BIN:-}" ]; then
  : # オペレーターが実行可能パスを指定
elif command -v argus >/dev/null 2>&1; then
  ARGUS_BIN="$(command -v argus)"
elif [ -n "${ARGUS_INSTALL:-}" ]; then
  ARGUS_BIN="$ARGUS_INSTALL/.venv/bin/argus"
else
  echo "Set ARGUS_BIN or ARGUS_INSTALL" >&2; exit 2
fi

ネイティブPowerShell:

if ($env:ARGUS_BIN) {
  $ArgusBin = $env:ARGUS_BIN
} elseif (Get-Command argus -ErrorAction SilentlyContinue) {
  $ArgusBin = (Get-Command argus).Source
} elseif ($env:ARGUS_INSTALL) {
  $ArgusBin = Join-Path $env:ARGUS_INSTALL ".venv\Scripts\argus.exe"
} else {
  throw "Set ARGUS_BIN or ARGUS_INSTALL"
}

以下のコマンド例ではPOSIXの"$ARGUS_BIN" ...構文を使用しています。PowerShellでは、解決されたパスを& $ArgusBin ...として呼び出します。

ソースチェックアウトの場合、ARGUS_INSTALL="$HOME/src/Argus"は単なる例であり、ポータブルなデフォルトではありません。解決された絶対実行可能パスを記録します。決してダウンロード、再インストール、Argusの内部モデル/プロバイダー構成の変更、または許可を静かに拡大しないでください。

コア操作手順

  1. 1つの所有する作業ディレクトリと実際のセキュリティ境界を選択します。 Argusプロジェクトごとに専用の絶対ディレクトリを使用します。別のアクティブなArgusプロジェクトのディレクトリ階層と重複させないでください。デーモンがアクティブな間は、それを移動、削除、または共有書き込みしないでください。真の並行作業には別々のプロジェクトが必要です。作業ディレクトリは所有権の境界であり、サンドボックスではありません。ARGUS_SKILL_SAFE_MODE=1はガードレールを追加しますが、それ自体がすべてのバックエンドの分離を提供するわけではありません。機密性の高い入力をステージングする前に、選択したバックエンドの検証済みサンドボックスを要求するか、適切に分離されたOS/コンテナ境界でArgusを実行します。デフォルトの無人モードでは、内部エージェントに作業ディレクトリを超えたアクセスを許可する場合があります。
  2. 境界のある入力をステージングします。 タスクに関連し、開示しても安全な入力のみをinputs/以下にコピーします。OBJECTIVE.mdに、成果、非目標、出力パス、受け入れチェック、権限の制限、およびレビュー/引用要件を記述します。会話履歴、資格情報、または関連のないプライベートデータをステージングしないでください。
  3. 正確な作業ディレクトリからフライト前チェックを実行します。 "$ARGUS_BIN" doctorを実行し、次に"$ARGUS_BIN" --statusをプローブします。バックエンド認証を検証する必要がある場合にのみdoctor --deepを使用します。通常のフライト前チェックごとにそのネットワーク/認証レイテンシを追加しないでください。Deep Doctorはライブ認証の普遍的な証明ではありません:未チェックのトークン、オフライン機能、または到達不能なルートを報告する場合は、そのバックエンドの文書化された非変更ライブ準備プローブをディスパッチ前に使用します。必要なチェックが合格し、意図したプロジェクト/作業ディレクトリが識別され、所有権の競合がなく、運用上必要な内部モデル/プロバイダーの選択がインストールされ認証されている場合にのみ続行します。外部オペレーターは、許可されている場合、ここでそのArgus構成を選択または検証してもかまいませんが、それを別の運用関係者として扱ってはなりません。現在のArgusのトップレベルヘルプは意図的に簡潔であり、サポートされている自動化フラグを省略している場合があります。--notify、デーモン、bounded、またはAPIサーフェスを別のビルドに対して使用する前に、そのビルドのドキュメント/パーサーまたは安全なプローブからそれらを検証します。references/argus-runtime-surfaces.mdを参照してください。
  4. 内部実行構成は必要な場合にのみ明示的にします。 既に構成され、インストールされ、認証されたArgusの内部モデル/プロバイダーを優先します。Argusが必要とする場合、プロバイダー名を限定します。準備チェックが失敗した後に構成を静かに変更しないでください。最初に診断し、委任された権限を超える変更については承認を得てください。
  5. 1つのスタンドアロンミッションをディスパッチします。 作業ディレクトリから、ステージングされた入力と出力を指定する自己完結型の目的をArgusに与えます。検査→実行→検証→修復→最終アーティファクト完了を要求します。Argusのネイティブリスク/垂直レビューポリシーに従います。タスク契約または重大なリスクが必要とする場合にのみ、独立したレビューを明示的に要求します。ミッションごとに1つの境界のある成果物を維持します。再利用可能な学習が要求されておらず、デプロイメントポリシーが許可する1回限りの境界のあるミッションの場合、ARGUS_SKILL_REQUIRE_POST_TASK_LEARNING=0を設定してデフォルトのタスク後学習モデル呼び出しを回避します。それ以外の場合は、構成された学習ポリシーを維持します。利用可能な場合はインタラクティブコックピットを使用します。分離実行の場合は、即席のシェルループではなく、Argusの文書化されたデーモン/boundedサーフェスを使用します。
  6. Argus内の証拠の境界を維持します。 Argusは内部的に計画、エンジニアリング、レビューを分離する場合があります。証拠を伴う決定サイズのミッションとアーティファクトの変更を要求します。Argusのポリシーが独立したレビューを必要とする場合、実際のアーティファクト、制限、引用、完了を検査する必要があります。これらは内部の責任であり、外部運用モデルにおける追加の関係者ではありません。主張ごとに1つの決定的なチェックを優先します。儀式的な重複証拠や余分なモデルターンを避けます。
  7. 利用可能な最も強力なホスト機能を使用して監視します。 references/adapters/の選択されたアダプターに従います。ホストのバックグラウンド/プロセスAPIは観測を改善しますが、真実の源ではありません:Argusの永続的なプロジェクト状態がそれです。アクティブな環境がホストプロセスを保持する場合にのみ、Argusの分離デーモンを使用します。それ以外の場合は、正確な作業ディレクトリ/プロジェクトIDを保存し、後のターンでその状態に対してArgusを再起動します。分離起動が許可されていない場合は、フォアグラウンドコックピットを維持するか、ユーザーに実行を継続するよう依頼します。無人監視を決して主張しないでください。
  8. すべての境界で保留中の質問ループを実行します。 ディスパッチ時、各意味のあるステータスチェック後、ブロック/一時停止/再計画結果の後、実行を放置する前、回答後、クローズアウト前に"$ARGUS_BIN" --statusを検査します。waiting on you : N unanswered question(s)は停止信号です。利用可能な場合は、コックピット/Web UIのユーザーの応答が必要プロンプトも検査します。検証済みのArgus 0.1.1ビルドでは、API対応オペレーターはGET /api/projects/{sid}/statusまたはGET /api/projects/{sid}/snapshot?compact=trueを検査できます。どちらもpending_questionsを公開しますが、完全なスナップショットはbacklog内の行を公開します。これらの読み取りルートは、ARGUS_SKILL_WEB_TOKENが構成されている場合でも認証されていないままになる可能性があります:ループバックのみに保つか、信頼できるVPN/認証リバースプロキシの背後に配置します。信頼できないネットワークに直接公開しないでください。他のビルドではこれらのルートを機能検出します。進行状況の散文だけでは不十分です。
  9. 各質問を分類します。 永続的な未解決のマーカーは、pending_questionが空でないバックログ行です。型付きカードにはoperator_decision.status == "pending"、およびid、question、reason、evidence、オプションのoptionsもあります。これは情報提供のチャット質問、目的テキスト、レビュー散文、または通常の/askではありません。永続的なマーカーを、failed、paused_operator、または成功のように見えるテキストの横にあってもブロッキングとして扱います。表面化された質問が明確に委任された権限の範囲内にない限り、Argusが可逆的な技術的ルーティングを保持できるようにします。資格情報/シークレット、支出、削除/フォースプッシュ/公開/外部送信、不可逆的または外向きのアクション、セキュリティ/信頼境界の変更、法的/ライセンス上の決定、重要な範囲/受け入れの変更、および曖昧な影響の大きい選択肢をエスカレーションします。
  10. 権威のあるサーフェスを通じて回答します。 ターミナル/Webコックピットの項目固有のユーザーの応答が必要カードを優先します。検証済みのArgus 0.1.1ビルドでは、APIクライアントはPOST /api/projects/{sid}/decisions/{decision_id}/resolveを{"option_id":"…","note":"…"}と共に使用するか、従来のPOST /api/projects/{sid}/backlog/{item_id}/answerを{"text":"…"}と共に使用できます。通常のコックピット応答またはPOST /api/projects/{sid}/messageは、保留中の質問が正確に1つの場合にのみマネージャールーティングされます。複数存在する場合は、特定のカード/項目に対処します。"$ARGUS_BIN" --notify '<answer>'はガイダンスをキューに入れ、保留中の質問が正確に1つの場合にのみマネージャーによってバインドできます。キュー確認は解決ではありません。他のビルドではコックピット以外のルートを機能検出します。ユーザーに代わって推測しないでください。
  11. 記録を検証し、再開します。 検証済みビルドでは、サーフェスが返す場合にresolved: trueを要求します。古いpending_questionがクリアされ、解決が記録されたことを確認します。型付きの決定カードが存在する場合、そのカードがresolvedになることも要求します。従来の型なしの質問にはカードまたはresolution_idがない場合があります。検査時にまだアクティブであることを要求するのではなく、実際の保留中、実行中、完了、または停止状態で継続を観察します。stop決定は代わりに項目を中止し、作業を保存し、連続モードを無効にし、継続を作成しません。ステータスを再実行し、実行が再開、完了、または意図したとおりに停止したことを確認します。マーカーが残っている場合は、明確化するかエスカレーションします。重複した推測を送信しないでください。
  12. トレースをインポートせずに検査します。 現在のミッション、役割、ステージ、バックログ、成果、最新の検証済み位置、およびユーザーの応答が必要については、ステータス/コックピットを使用します。バックログと最新の検証済み証拠をフロンティアとして扱います。生のトランスクリプト、デーモンログ、エージェントI/O、使用量ログ、プライベート台帳はローカルに保存します。
  13. アーティファクトを取得して検証します。 名前付き出力パスを読み取ります。存在、要求されたスコープ、および決定的なテストを確認します。すべての重要な引用をステージングされたソースに解決します。捏造された、古い最新の、または主張と一致しない引用を拒否します。進行状況メッセージから成功を推測しないでください。
  14. 永続的な状態から回復します。 一時停止した書き込み/実行作業を再開するには、インラインチャット回答ではなく、自己完結型の再開目的で永続的な状態から再開するようArgusに依頼します。内部実行スレッドが再開できない場合は、Argusのチェックポイント/カプセルを使用します。Argusの構成または目的を変更する前に、未解決の質問、所有権、内部モデル/プロバイダーの準備、予算/クールダウン、インフラストラクチャを診断します。
  15. 証拠に基づいてのみクローズアウトします。 境界のある目的が達成され、アーティファクトと決定的なチェックが合格し、必要なレビューアの評決がdoneであり、保留中の質問/カードがない場合に終了します。continue、replan_requested、blocked、調査一時停止、または未回答のユーザーの応答が必要は完了ではありません。ミッション完了とプロジェクト/ステージ完了を区別します。references/closeout-checklist.mdを使用します。

機能フォールバック

  • ネイティブスキルディスカバリーなし: 完全なバンドルを提供するか、このファイルと一致するアダプターを読み取るようホストに明示的に指示します。自動アクティベーションを主張しないでください。
  • シェルなし: ホストはローカルArgusを直接操作できません。承認されたリモートシェル/ターミナル統合を使用するか、正確なオペレーター手順を引き継ぎます。シミュレートするのではなく、実行がブロックされているとマークします。
  • シェルはあるがプロセスAPIなし: 環境がプロセスを保持する場合にのみ、Argus --daemonを優先します。常にプロジェクト/作業ディレクトリIDを永続化し、ステータス/コックピットで再エントリーします。ホストの文書化された環境がそれを唯一の承認されたパスにしない限り、脆弱な&、nohup、またはスリープ/ポールループでバックグラウンド実行しないでください。
  • プロセスAPIはあるがホストセッション全体で永続的ではない: ライブログのみに使用します。耐久性のあるArgusプロジェクト状態が回復アンカーであり、デーモンを再起動する必要がある場合があります。
  • HTTP/APIクライアントなし: ターミナル/Webコックピットと--statusを使用します。質問ループにAPIアクセスを要求しないでください。
  • インタラクティブな承認ルートなし: 承認が必要なアクションでクローズドフェイルします。安全なフライト前チェックを変更を伴う起動から分離するか、サポートされているUIを通じて人間に承認を依頼します。無人実行のために承認/サンドボックスフラグをバイパスしないでください。
  • 無人実行が許可されていない: インタラクティブセッションを開いたままにするか、正確な再開手順と未解決の状態で停止します。監視を能動的ではなく条件的として報告します。

プライバシー、権限、および復帰

最小限のデータをステージングします。ユーザーが保護されたリモートアクセスを承認しない限り、Web UIはループバックのみに保ちます。現在のユーザー指示と新しい証拠が、以前の計画やランタイムの提案を上書きします。

呼び出し元のサーフェスのみに復帰します:作業ディレクトリ/プロジェクトID、コンパクトな成果/フロンティア、レビューアの評決、アーティファクトパス、決定的な検証、引用例外、...

[翻訳のため切り詰められました]

関連スキル