mcpField
A
agy-native

agy-native

github.com/boshu2エージェントワークフロー45058 回インストール今日更新
リポジトリ

agy-native について

agy-nativeは、AGY（Antigravity）を明示的に選んだ呼び出し元向けのスキルです。指定されたワークスペースとタスクパケット内で実行し、ランタイムの証拠を記録して終了します。別のランタイムへ暗黙に切り替えることはありません。

主な機能

  1. 01AGYランタイムの明示的な選択
  2. 02ワークスペースとパケットの範囲指定
  3. 03ヘッドレス実行の期限設定
  4. 04権限モードの明示
  5. 05ランタイム証拠の報告

活用シーン

  1. 01AGYで指定パケットを実行
  2. 02期限付きヘッドレス実行の証拠記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/boshu2/agentops --skill agy-native

インストール後、Claude Code で/agy-nativeを入力して読み込まれたか確認します。

詳細

AGY ネイティブ

呼び出し元がこのランタイムを明示的に選択した場合に限り、指定されたパケットを AGY（Antigravity）で実行します。実行範囲を指定されたワークスペースとパケットに限定し、ランタイムの証拠を返して停止します。

起動前

  1. 現在のインターフェースを確認します。 フラグとデフォルト値は agy --help を、現在のモデルセットは agy models を実行して確認します。CLI はスキルの説明文よりも速く変化します。ラッパーの乖離とは、記憶に頼った構文で実行した結果、気付かないうちに変更されている状態です。実行範囲が限定されているように見えて、実際には限定されていません。
  2. 存在しない場合は停止します。 agy が見つからない場合、またはヘルプを読み取れない場合は、利用できないことを報告して停止します。Codex、Claude、その他のランタイムへ黙ってフォールバックしてはいけません。代替ランタイムを使うには、呼び出し元による新たな選択が必要です。どの処理も、単独で AGY に処理を振り分けることはありません。リポジトリのレビュアーライブラリでは、AGY は定常層の劣化フォールバックレビュアーと評価されています。この評価が適用されるのは呼び出し元が明示的に選択した場合に限られ、自動的に振り分けられることはありません。
  3. 明示的な制限時間を設定します。 プリントモード（agy -p / --print）はヘッドレス実行の方法で、組み込みの制限時間はありません。--print-timeout のデフォルトは 0 で、ターンが完了するまで待機します（AGY 1.2.14）。呼び出し元に残された期限を --print-timeout に渡し、プロセスの外側でも同じ制限時間を設けます。制限時間に達して停止した実行は、結果ではなくタイムアウトです。
  4. 実行方針（以下）を明示し、パケットに記載された影響範囲と呼び出し元の承認が、その方針をカバーしていることを確認します。
  5. 作成者と検証者を分けます。 検証者は新しい会話での新規実行とします。-c / --continue や --conversation <author-id> は使いません。自身の成果物をレビューするセッションでは、検証者の証拠を有効にする、新鮮な判断が損なわれます。検証者は読み取り専用とし、判断を Validate に引き渡します。中心となる判定を記述してはいけません。

権限設定（明示すること。決して推測しないこと）

フラグで権限設定を選択します。使用する設定を明示してください。

  • 権限設定のフラグがない場合：AGY はツールの権限を呼び出しごとに確認します。ヘッドレス実行では応答する人がいないため、確認プロンプトによって制限時間まで停止することがあります。
  • --dangerously-skip-permissions：すべてのツール呼び出しを自動承認します。記載された影響範囲と呼び出し元の承認が、その影響範囲をカバーしている場合に限り使用してください。
  • --sandbox：セッションのターミナルアクセスを制限します。
  • --mode（plan、accept-edits）：実行モードを変更します。現在の意味を agy --help で確認してください。

コマンド

以下の agy フラグはすべて、AGY 1.3.1 の agy --help に記載されています。使用前に再確認してください。 DEADLINE_EPOCH は呼び出し元が一度設定し、そのスコープ内のすべての実行で再利用する絶対 Unix 時刻です。2 回目の実行には新しい制限時間ではなく、残り時間が適用されます。POSTURE は上記から選んだ権限設定フラグを含む Bash 配列です。例：POSTURE=(--sandbox)。空の配列の場合、AGY はツールの実行ごとに確認します。 PROMPT_FILE は絶対パスです。パケットはインラインではなくパスで渡します。scripts/lib/codex-exec.sh と同様、短い -p のポインターと --add-dir を使います。長いプロンプトをインラインで渡すと、実行範囲が限定されているように見えるまま、プロンプトが失われる可能性があります。

TO=$(command -v timeout || command -v gtimeout) || { echo "no timeout: not launching" >&2; exit 2; }
remaining=$(( DEADLINE_EPOCH - $(date +%s) ))
[ "$remaining" -gt 0 ] || { echo "deadline passed; not launched" >&2; exit 124; }
cd "$WORKSPACE" || exit 2
"$TO" -k 10 "$remaining" \
  agy --print-timeout "${remaining}s" --model "$MODEL" --output-format json \
  "${POSTURE[@]}" --add-dir "$(dirname "$PROMPT_FILE")" \
  -p "Read the task packet at $PROMPT_FILE and do what it describes." >"$OUT" 2>"$ERR"
rc=$?  # 124, or 137 after the 10 s grace: the outer bound stopped the run

--print-timeout には 300s のように単位付きの時間を指定します。フラグは -p の前に置き、プロンプトテキストの後ろに追加されないようにします。AGY のヘルプには、独自のプリントタイムアウトが発生した際にどの終了ステータスを返すかが記載されていません。そのため、出力にターンの完了が示されていない限り、制限時間に達して終了した実行はタイムアウトです。

戻り値

command:      exact argv (prompt by reference)
posture:      permission, sandbox and mode flags used
model:        requested model; observed model if AGY reported one, else unknown
conversation: id AGY reported, else unknown
bound:        --print-timeout value and the outer deadline
outcome:      exit status | timed out | not run (reason)
artifacts:    captured output and changed-file paths

AGY のプラグイン、メモリ、権限、再試行、セッションの状態はランタイム上の事実です。これらが AgentOps のフェーズ、キュー、完了の状態になることはありません。インストール、プラグインの変更、定期スケジュールには、それぞれ別途、明示的な承認が必要です。

コメント

Markdown 対応