mcpField
L
ln-011-agent-installer

ln-011-agent-installer

github.com/levnikolaevichエージェントワークフロー584161 回インストール2 日前に更新
リポジトリ

ln-011-agent-installer について

Codex CLI と Claude Code をインストールまたは更新し、その直後にそれぞれを検証する環境スキルです。各エージェントを個別に処理し、Codex 設定の差分は別途対応できるよう報告します。

主な機能

  1. 01Codex CLI と Claude Code の導入または更新
  2. 02各エージェントの直後の検証
  3. 03無効化されたエージェント設定の尊重
  4. 04Codex のマーケットプレイスとポリシー差分の報告
  5. 05構造化されたインストール概要の出力

活用シーン

  1. 01対応する 2 つのコマンドラインエージェントの導入や更新
  2. 02エージェント更新後のインストール済みバージョン確認
  3. 03後続対応が必要な Codex 設定差分の特定

インストール

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

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-011-agent-installer

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
audit_scoring.md
audit_summary_contract.md
audit_worker_core_contract.md
coordinator_summary_contract.md
environment_worker_runtime_contract.md
worker_runtime_contract.md
references/templates/
audit_worker_report_template.md

詳細

パス： ファイルパス（references/）は、このスキルディレクトリからの相対パスです。

エージェントインストーラー

タイプ： L3 ワーカー カテゴリ： 0XX 共有

サポート対象の 2 つの CLI エージェント、Codex CLI と Claude Code をインストールまたは更新します。エージェントごとに 1 回のパスで、インストール後すぐに検証します。

必読： references/coordinator_summary_contract.md、references/environment_worker_runtime_contract.md、references/worker_runtime_contract.md を読み込んでください。

入力／出力

方向内容
入力OS 情報、エージェントごとの disabled フラグ、dry_run フラグ、任意の runId、任意の summaryArtifactPath
出力payload.status が completed／skipped／error のいずれかで、エージェントごとのインストール結果を changes／detail に含む、構造化されたサマリーエンベロープ

summaryArtifactPath が指定されている場合は、同じサマリー JSON をそこに書き込みます。指定されていない場合は、サマリーをインラインで返し、完全に単独で動作します。runId が指定されていない場合は、サマリーエンベロープを出力する前に、単独で使用する run_id を生成します。

ランタイム

ランタイムファミリー：environment-worker-runtime

フェーズプロファイル：

  1. PHASE_0_CONFIG
  2. PHASE_1_INSTALL_VERIFY
  3. PHASE_2_POST_CODEX_SANITY_CHECK
  4. PHASE_3_WRITE_SUMMARY
  5. PHASE_4_SELF_CHECK

ランタイムルール：

  • summary_kind=env-agent-install を出力します
  • 単独実行では独自の run_id を生成し、ワーカーファミリーのデフォルトのアーティファクトパスに書き込みます
  • 管理された実行では runId と summaryArtifactPath の両方が必須で、指定された正確なパスにサマリーを書き込む必要があります
  • 終了結果を出す前に、必ず検証済みのサマリーアーティファクトを書き込みます

出力コントラクト

以下に従って、構造化された env-agent-install サマリーエンベロープを必ず作成します：

  • references/coordinator_summary_contract.md
  • references/environment_worker_runtime_contract.md

ペイロードフィールド：

  • targets
  • agents_processed
  • agents_skipped
  • versions
  • codex_drift_detected
  • status

エージェントレジストリ

エージェントインストールコマンドヘルスチェック対話形式
Codexnpm i -g @openai/codexcodex --versioncodex または codex "prompt"
Claudenpm i -g @anthropic-ai/claude-code または claude updateclaude --versionclaude または claude "prompt"

自動化では以下を使用します：

  • Codex：codex exec ...
  • Claude：claude -p ...

注：codex／codex "prompt" は、対話型 TTY のエントリーポイントです。非対話型の検証とレビューの自動化では、codex exec ... を使用する必要があります。Codex は、標準入力がターミナルではない場合、対話型モードの直接起動を拒否するためです。

ワークフロー

For each enabled agent: Install or Update -> Verify -> Record
フェーズ 1：インストールと検証

レジストリ内の各エージェントについて、最初に一致するルールを適用します：

条件アクション報告内容
disabled: trueスキップdisabled by user
dry_run: true実行予定のコマンドを表示dry run
Codexnpm install -g @openai/codex を実行し、その後 codex --version を実行バージョンまたはエラー
Claude がインストール済みclaude update を実行し、その後 claude --version を実行バージョンまたはエラー
Claude が未インストールnpm install -g @anthropic-ai/claude-code を実行し、その後 claude --version を実行バージョンまたはエラー

1 回のパス： エージェントごとに、インストールと検証を一括して実行します。個別のスキャンフェーズはありません。インストール結果が状態となります。

エラー処理：

エラー検出方法対応
npm が PATH にないnpm --version が失敗適切に失敗し、npm not found in PATH と報告
権限が拒否されたstderr に EACCES が含まれる失敗し、npm install -g --prefix ~/.local {pkg} を提案
ネットワークエラーstderr に ETIMEDOUT または ENETUNREACH が含まれる失敗し、network error と報告
不明なエラーその他のゼロ以外の終了コード失敗し、stderr を含める

出力テーブル：

Agent Installation:
| Agent  | Action    | Version  | Status |
|--------|-----------|----------|--------|
| Codex  | installed | 0.124.0  | ok     |
| Claude | updated   | 2.1.119  | ok     |
フェーズ 2：インストール後の Codex の健全性チェック

Codex のインストール／更新が正常に完了した後：

  1. ~/.codex/config.toml のトップレベルにある approval_policy と sandbox_mode を確認します。
  2. 設定済みの Codex マーケットプレイスで、このリポジトリを指す有効なパスが重複していないか確認します。
  3. 設定のずれが見つかった場合は WARN を報告し、修正は ln-013-config-syncer に委ねます。

このインストーラーは、マーケットプレイスのプラグインをインストールしたり、Codex のマーケットプレイス構成を書き換えたり、Codex の実行時のデフォルト設定を管理したりしません。インストールが成功したことで、2 エージェント環境が正常だと誤認されないよう、設定のずれを報告するだけです。

重要なルール

  1. disabled フラグは絶対に変更しないでください。 そのまま尊重し、変更しないでください。
  2. 適切にエラーを処理してください。 一方のエージェントでエラーが発生しても、もう一方を妨げないでください。
  3. グローバルインストールのみです。 CLI ツールは PATH に含まれている必要があります。
  4. すべての変更を報告してください。 設定の確認結果を最終サマリー表に含めてください。
  5. 冪等にしてください。 複数回実行しても安全である必要があります。
  6. Claude と Codex のみです。 関連のないエージェントの分岐を追加しないでください。
  7. Codex のマーケットプレイス／プラグインおよび実行時デフォルトの修正は ln-013 の担当です。 このスキルでは設定のずれを検出できますが、マーケットプレイス／キャッシュの構成や Codex のトップレベル権限デフォルトを自ら書き換えてはいけません。

アンチパターン

しないことすること
チェック／インストール／検証の各フェーズを分ける一度の処理でインストールしてから検証する
失敗したインストールを自動的に再試行する一度だけ試行し、失敗を報告する
sudo npm install を使う権限の問題には --prefix を提案する
disabled とマークされたエージェントをインストールするスキップし、その旨を明確に報告する
ここで MCP 設定やマーケットプレイスのプラグインを設定する環境の調整を ln-013-config-syncer に委ねる

完了の定義

  • Codex と Claude を一度の処理で対応（インストール＋検証）
  • 無効化されたエージェントをスキップし、その旨を報告
  • 各インストール直後にバージョンを検証
  • Codex のマーケットプレイス／プラグインと実行時デフォルトの健全性を確認するか、ln-013 での後続対応が必要であることを明示的に報告
  • ステータス表を表示
  • 構造化されたサマリーを返す
  • 管理対象またはスタンドアロンのランタイムパスにサマリー成果物を書き込む

バージョン： 1.1.0 最終更新日： 2026-03-23

コメント

Markdown 対応