ln-013-config-syncer

パス： ファイルパス（references/）は、このスキルディレクトリを基準とします。

マーケットプレイスと設定の調整

種類： L3 ワーカー
カテゴリ： 0XX 共通

Claude Code と Codex CLI のために、このリポジトリのマーケットプレイスと選択したプラグインをインストールまたは検証します。一方のエージェントをもう一方の信頼できる情報源にはしません。デフォルトの開発プラグインは agile-workflow です。オプションのプラグインは、明示的に要求または選択された場合にのみインストールします。マーケットプレイスの状態を確認した後、MCP と Codex のポリシー設定を非破壊的に調整します。

必読

必読： references/coordinator_summary_contract.md、references/environment_worker_runtime_contract.md、references/worker_runtime_contract.md を読み込みます
必読： references/agent_skill_roots_contract.md を読み込みます

---

入力／出力

方向	内容
入力	OS 情報、エージェントごとの disabled フラグ、targets（claude ／ codex ／ both ／ all）、plugins（デフォルトの agile-workflow、明示的なリスト、または all）、dry_run フラグ、任意の auto_install_providers フラグ、任意の runId、任意の summaryArtifactPath
出力	payload.status が completed ／ skipped ／ error のいずれかで、ターゲットごとの調整結果を changes ／ detail に含む構造化されたサマリーエンベロープ

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

dry_run=true は検出のみを行います。マーケットプレイスの登録、プラグインのインストール、MCP／Codex 設定の編集、.bak ファイルの書き込み、プロバイダーの自動インストールは行いません。予定されているアクションと設定の差異の詳細をサマリーに返します。

ランタイム

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

フェーズプロファイル：

1. PHASE_0_CONFIG
2. PHASE_1_DISCOVER_STATE
3. PHASE_2_VERIFY_MARKETPLACE_INSTALLS
4. PHASE_3_ALIGN_MCP_SETTINGS
5. PHASE_4_ALIGN_CODEX_POLICY 5a. PHASE_4A_MCP_PROVIDER_CHECK
6. PHASE_5_WRITE_SUMMARY
7. PHASE_6_SELF_CHECK

ランタイムルール：

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

出力コントラクト

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

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

ペイロードのフィールド：

• targets
• plugin_alignment
• marketplace_health
• mcp_alignment
• mcp_providers
• codex_execution_defaults
• status

---

OS ごとの設定パス

エージェント	Windows	macOS ／ Linux
Claude（優先）	%USERPROFILE%\.claude.json	~/.claude.json
Claude（フォールバック）	%USERPROFILE%\.claude\settings.json	~/.claude/settings.json
Codex	%USERPROFILE%\.codex\config.toml	~/.codex/config.toml

---

ワークフロー

Discover State -> Verify Marketplace Installs -> Align MCP -> Align Codex Policy -> Verify & Report

フェーズ 1：状態の確認

1. Claude の設定を読み取ります。
   • ~/.claude.json（優先）＋ ~/.claude/settings.json（フォールバック）
   • mcpServers、有効なマーケットプレイス／プラグイン、フックの状態を抽出します
2. Codex の設定を読み取ります。
   • ~/.codex/config.toml
   • [mcp_servers.*]、[marketplaces.*]、トップレベルの approval_policy、トップレベルの sandbox_mode を抽出します
3. リポジトリのマーケットプレイス関連ファイルを確認します。
   • Claude：.claude-plugin/marketplace.json
   • Codex：.agents/plugins/marketplace.json
   • Codex プラグインのマニフェスト：plugins/*/.codex-plugin/plugin.json
4. プラグインの選択内容を解決します。
   • 常に agile-workflow を含めます
   • plugins=all の場合、マーケットプレイスに登録されているすべてのプラグインを含めます
   • 明示的なリストが指定されている場合は、agile-workflow と指定されたプラグインをインストールします
   • 対話型でオプションのプラグインが指定されていない場合は、インストールするオプションのプラグインを確認します
   • 非対話型でオプションのプラグインが指定されていない場合は、agile-workflow のみをインストールまたは検証します
5. 有効な対象、選択されたプラグイン、マーケットプレイスの健全性、重複リスクの検出結果、Codex の実行時デフォルト設定のずれを含む現在の状態テーブルを表示します。

フェーズ 2：マーケットプレイスのインストールを検証

disabled が true ではない各対象について、次の項目を確認します。

対象	想定されるインストールモデル	検証
Claude	Claude ネイティブのマーケットプレイス	マーケットプレイスが Claude のプラグイン設定を通じて登録され、選択されたプラグインが .claude-plugin/marketplace.json から解決されること
Codex	Codex ネイティブのマーケットプレイス	マーケットプレイスが Codex のプラグイン設定を通じて登録され、選択されたプラグインが .agents/plugins/marketplace.json／plugins/*/.codex-plugin/plugin.json から解決されること

インストールポリシー：

• Claude マーケットプレイス：/plugin marketplace add levnikolaevich/claude-code-skills
• Claude プラグイン：/plugin install {plugin}@levnikolaevich-skills-marketplace
• Codex マーケットプレイス：codex plugin marketplace add levnikolaevich/claude-code-skills
• Codex のプラグイン選択：選択されたプラグインが .agents/plugins/marketplace.json および plugins/{plugin}/.codex-plugin/plugin.json に存在することを検証します。インストール済みの Codex バージョンで、プラグイン単位の選択が対話型のネイティブフローでのみ可能な場合は、存在しない CLI コマンドをでっち上げず、その正確な手順を報告します。

ルール：

• dry_run=true の場合、マーケットプレイスの追加／インストールコマンドは実行せず、実行される予定の正確なコマンドを報告します。
• Claude のプラグインルートを Codex の検出ルートにシンボリックリンクまたはジャンクションで接続しないでください。
• 同じ Codex ランタイムに Claude ブリッジのサーフェスと Codex ネイティブのサーフェスを同時に公開しないでください。スキル名の重複は連携の失敗です。
• ユーザーのプラグインルートを削除しないでください。有効なルートの重複が検出された場合は、正確なパスを報告し、明示的なクリーンアップの承認を求めてください。
• オプションのプラグインを黙ってインストールしないでください。
• リポジトリのルートが利用可能な場合は、node tools/marketplace/validate.mjs を実行します。失敗はマーケットプレイスのずれとして報告します。

フェーズ 3：MCP 設定の整合

MCP 設定はサーバー名で整合させます。どのターゲットも普遍的な信頼できる情報源ではありません。

マージ戦略：

1. Claude の mcpServers と Codex の [mcp_servers.*] の和集合を作成します。
2. 名前が一致する場合、ターゲット固有のフィールドを維持し、意味的に等価なフィールドのみを更新します。
3. サーバーが存在しない場合、形式を変換したうえで、要求されたターゲットに追加します。
4. 設定ファイルを変更する前に .bak を作成します。
5. ターゲット固有のサーバーと、無関係な設定セクションを維持します。
6. dry_run=true の場合、マージ計画のみを報告します。.bak ファイルの作成や設定の編集は行いません。

フィールドの対応関係：

意味上のフィールド	Claude JSON	Codex TOML
コマンド	command	command
引数	args	args
環境変数	env	[mcp_servers.{name}.env]
HTTP URL	type: "http" + url	url
ヘッダー	headers	http_headers

Codex 固有のフィールド（維持すること）： bearer_token_env_var、enabled_tools、disabled_tools、startup_timeout_sec、tool_timeout_sec、enabled、required

Windows の実装に関する注意： 正規表現やバックスラッシュのエスケープを伴う設定形式の変換には、インラインの node -e や bash ヒアドキュメントではなく、一時的な .mjs スクリプトファイルを必ず使用してください。

フェーズ 4：フックと Codex ポリシーの整合

Claude フック：

• Claude のフック／スタイルの同期は Claude のみを対象とします。
• Claude のフックを Codex に反映しないでください（ワイヤ形式が異なります）。

Codex フック：

• Claude のフックを Codex に反映しないでください（ワイヤ形式が異なります）。
• このマーケットプレイスの、製品固有の Codex フックシムをインストールしないでください。Codex フックを必要とするランタイム製品は、それぞれ独自のフックスクリプト、信頼モデル、検証、サービスのライフサイクルを管理します。
• レガシーの [features] codex_hooks = true エイリアスを書き込まないでください。現在の Codex では安定版のフック機能を使用し、正規のブロックは純粋な [hooks.*] TOML です。
• 以前のセットアップで管理されていた古いフックブロックを削除する場合は、編集する各 config.toml の .bak を編集前に作成してください（MCP マージと同じポリシーです）。

Codex の実行時デフォルト：

手間の少ないセットアップのために管理する Codex のデフォルト：

approval_policy = "never"
sandbox_mode = "danger-full-access"

判断ロジック：

条件	アクション
Codex ターゲットの disabled: true	スキップし、disabled と報告
デフォルトがすでに設定されている	スキップし、already aligned と報告
いずれか、または両方のキーが欠落／ずれている	管理対象のトップレベルキーのみをパッチし、無関係なキー／テーブルを維持して、先に .bak を作成

ルール：

• 管理するのはトップレベルの approval_policy とトップレベルの sandbox_mode のみです。
• [windows].sandbox は書き換えないでください。これは Windows 固有の別の設定項目です。
• model、projects、notice、[marketplaces.*]、[mcp_servers.*] など、無関係な Codex 設定セクションを維持してください。

フェーズ 4a：MCP プロバイダーの確認

必ず読むこと： references/mcp_provider_requirements.md を読み込みます。

MCP の整合後、プロジェクトの呼び出しごとに 1 回実行します。目的は、整合済みの設定で参照されるすべての MCP サーバーについて、プロジェクトで実際に使用される言語に必要な言語アナライザーのプロバイダーが利用可能であることを確認することです。

1. MCP サーバーを列挙します。 Claude と Codex の設定に含まれる MCP サーバーの和集合を作成します。名前で重複を除外します。
2. プロジェクトの言語を検出します。 次の順に、コストの低いものから確認します：pyproject.toml、package.json、tsconfig.json、Cargo.toml、go.mod、*.csproj。確認には mcp__hex-line__inspect_path を使用し、シェルコマンドは実行しないでください。
3. プロバイダー要件を確認します。 references/mcp_provider_requirements.md を読みます。hex-graph については、mcp__hex-graph__install_graph_providers に委任します。
4. プロバイダーを確認します。 mcp__hex-graph__install_graph_providers({ mode: "check", path: <project_root> }) を呼び出します。auto_install_providers=true の場合を除き、自動インストールしないでください。
5. 結果を記録します。 environment_state.json の mcp_providers に書き込みます。

フェーズ 5：検証と報告

以下を検証します：

• Claude のマーケットプレイス登録で想定されたソースが解決される
• Codex のマーケットプレイス登録で想定されたソースが解決される
• Codex のネイティブプラグインマニフェストが Claude のマーケットプレイスに対して検証される
• このリポジトリを参照する有効な Codex スキルの登録先が重複していない
• Codex の approval_policy = "never"
• Codex の sandbox_mode = "danger-full-access"
• MCP の設定が、対象固有の設定を削除せずにマージされている

Marketplace and Config Alignment:
| Action         | Target | Status                                              |
|----------------|--------|-----------------------------------------------------|
| Marketplace    | Claude | registered; agile-workflow installed               |
| Marketplace    | Codex  | registered; native plugin manifests validated      |
| MCP align      | Claude | 4 servers aligned (0 deleted)                       |
| MCP align      | Codex  | 4 servers aligned (1 new)                           |
| Execution mode | Codex  | approval_policy=never; sandbox_mode=danger-full-access |
| Hooks          | Codex  | skipped (not supported)                             |

---

重要なルール

1. 独立してインストールします。 Claude と Codex は、それぞれ独自のネイティブなマーケットプレイスのフローでスキルをインストールします。
2. あるエージェントを、別のエージェントのスキルインストールの信頼できる情報源にしてはいけません。
3. デフォルトのプラグインセット。 agile-workflow には開発ワークフローが含まれているため、デフォルトでインストールするか、インストール済みであることを確認します。
4. オプションのプラグインは明示的に指定します。 デフォルト以外のプラグインは、要求または選択された場合、あるいは plugins=all の場合にのみインストールします。
5. プロジェクトのコマンドをコピーしません。 .claude/commands を Codex にコピーしてはいけません。マーケットプレイスのスキル／プラグインとして表現されていない限り、プロジェクトローカルのコマンドはホスト固有です。
6. 非破壊的にマージします。 対象固有のサーバーと設定は保持します。
7. 有効な登録先を重複させません。 1 つのランタイムが、レガシーブリッジのルートとネイティブプラグインのルートの両方から同じスキル名を認識してはいけません。
8. データを失わないようにします。 対象パスに実ディレクトリがある場合は、警告して処理をスキップし、決して確認せずに削除してはいけません。
9. 書き込み前にバックアップします。 設定ファイルを変更する前に .bak を作成します。
10. ドライランは読み取り専用です。 dry_run=true の場合、ユーザーまたはリポジトリで追跡されている状態を変更せず、予定されるコマンドと設定変更を報告します。
11. disabled フラグを尊重します。 無効化されたエージェントに対する操作はすべてスキップします。
12. 冪等性を保ちます。 複数回実行しても安全です。すでに整合している状態はスキップします。
13. 対象は Claude と Codex のみです。 無関係なエージェント用の分岐を追加してはいけません。

アンチパターン

してはいけないこと	すること
Claude を Codex の信頼できる情報源として扱う	各エージェントを個別にインストールする
.codex/skills を .claude/plugins にシンボリックリンクする	Codex のネイティブなマーケットプレイス登録を使用する
ブリッジとネイティブの Codex 登録先を同時に公開する	有効な Codex の登録先を常に 1 つだけにする
すべてのマーケットプレイスプラグインをデフォルトでインストールする	agile-workflow をデフォルトでインストールし、その他は明示的な選択を必須にする
プロジェクトローカルの .claude/commands を Codex にコピーする	再利用可能な動作をマーケットプレイスのスキル／プラグインとして表現する
対象の設定を一から上書きする	読み込み → ディープマージ → バックアップ → 編集
プラグイン／キャッシュのディレクトリを自動で削除する	正確なクリーンアップ手順を報告し、明示的な承認を求める

---

完了の定義

• Claude と Codex の対象設定を検出済み
• 対象に応じてマーケットプレイスの登録を検証またはインストール済み
• 有効な対象に対して agile-workflow を検証またはインストール済み
• オプションのプラグインは、明示的に要求または選択された場合にのみインストール済み
• dry_run=true では、マーケットプレイス、プラグイン、設定、バックアップ、プロバイダーへの変更が行われていない
• 有効なルートの重複がないことを確認済み
• Codex のネイティブプラグインマニフェストを検証済み
• 対象固有の設定を削除せずに MCP 設定を整合済み
• Codex の実行時デフォルト設定を整合済み、または不一致として明示的に報告済み
• 対応している対象のみフックを処理済み（Claude のフックは Claude のみ。製品固有の Codex フックは、そのランタイムに委ねる）
• MCP プロバイダーの確認を完了、または明示的にスキップ済み
• 構造化された概要を返却済み
• 管理対象またはスタンドアロンのランタイムパスに概要の成果物を作成済み

---

バージョン： 2.0.0 最終更新日： 2026-04-14