Agent Config Import

目的

設定を意味を壊さず移送する。単純コピーせず、移送可能 / 手動判断 / 移送不能を分ける。

原則

• 最初は dry-run。編集前に差分・リスク・未対応項目を出す。
• 分析は双方向 1 パス。両方向の Direct / Manual / Not portable / Proposed diff を最初から出し、逆方向を問い返させない。
• permission / sandbox / approval / hooks は記憶で判断しない。編集前に公式 URL を開き、確認した URL と日付を残す。
• secret / token の値は出さない。環境変数名と参照方式だけ扱う。
• 既存設定が source of truth。上書きでなく merge 案を出す。
• apply は対象ごとに .bak. を取ってから。home 配下は明示 apply なしに触らない。
• 共有 symlink ストア（例 ~/.agents/skills/ を両ツールから相対 symlink）経由なら、import は symlink 作成に過ぎず有無は curation。gap と誤報しない。判断前に symlink / inode を実測する。
• nix 等で管理された symlink は store が read-only。canonical source を編集対象にし、deployed copy の再 sync は別ステップにする。
• MCP は最優先。設定価値が集中する。

仕様確認 URL

permission / sandbox / auto mode は特に記憶で判断しない。`` を差し替えて必要分だけ開く。

• Codex https://developers.openai.com/codex/: config-reference, permissions, mcp, skills, plugins, changelog
• Claude https://code.claude.com/docs/en/: settings, permissions, hooks, plugins-reference, whats-new
• Cross: https://agents.md/ , https://agentskills.io/

入力探索

存在しないものは skip。読んだパスと欠落した重要パスを記録する。

• Claude: ~/.claude/settings.json, settings.local.json, ~/.claude.json(mcpServers), project .claude/settings*.json, .mcp.json, CLAUDE.md, .claude/{skills,commands,agents,hooks}/**
• Codex: ~/.codex/config.toml, project .codex/config.toml, AGENTS.md, ~/.codex/skills/**, project .agents/skills/**, ~/.codex/prompts/*.md

変換マッピング（双方向対称）

| 領域 | Claude Code | Codex | 注意 | |---|---|---|---| | MCP | mcpServers{} (.mcp.json 優先 / settings) | [mcp_servers.x] (config.toml) | command/args/env/url を維持。TOML は parser で編集。embedded credential URL は伏せて手動。 | | model | model | model | 直訳せず provider 互換を確認。 | | env | env{} | [shell_environment_policy.set] | secret は名前と参照のみ。 | | approval / sandbox | permissions.defaultMode | approval_policy + sandbox_mode | 1:1 でない。必ず推測明記。下記方針参照。 | | allow / deny | permissions.allow/deny | granular approval / AGENTS.md guidance | 直接等価なし。destructive は手動。 | | hooks | .claude/hooks + settings hooks | hooks.json / config | 等価移送しない。formatter/guardrail/telemetry/context/rewrite に分類し skill・prompt・plugin 化を提案。暗黙に実行可能化しない。 | | skills | .claude/skills/** | ~/.codex/skills/**, .agents/skills/** | copy/symlink。相対 symlink 優先。共有ストアなら symlink 1 本で済む。 | | commands / prompts | .claude/commands/*.md | ~/.codex/prompts/*.md | 相互変換候補。 | | agents | .claude/agents/*.md | skill または AGENTS.md セクション | | | memory | CLAUDE.md | AGENTS.md | 両方 regular file なら上書きせず diff。tool 固有記述(system prompt 参照等)は翻案か除外。片方のみなら canonical 配置を提案。 |

destructive allow / danger-full-access / bypassPermissions は apply せず、dry-run で警告と手動確認に回す。

Permission / sandbox 方針

• Codex は approval と sandbox が独立。UI 名 "Auto"/"Full Auto" で判断しない。approval_policy(untrusted / on-request / never / granular) と sandbox_mode(read-only / workspace-write / danger-full-access) を分けて評価する。
• Claude defaultMode(default / acceptEdits / plan / auto / dontAsk / bypassPermissions) は現行仕様を docs で確認（auto は user scope のみ有効など制約あり）。
• 対応は推測として出す。acceptEdits ≈「編集許可・コマンド確認」、bypassPermissions ≠ never+danger-full-access。sandbox 有無と network / writable roots を分離して評価する。

出力フォーマット

双方向 1 パス。共有前置き(Specs / Read Files / Structural Findings)を 1 回、Direction A/B を各 1 ブロック、最後に統合 Apply を出す。各方向は 0 件でも「該当なし」と明記し省略しない。

````markdown

Import Plan (Bidirectional) — Mode: dry-run

Specs Checked

| Product | URL | Checked at | Notes |

Read Files

| Path | Status | Notes |

Structural Findings

共有ストア / symlink / nix 管理 / 既存 AGENTS.md・CLAUDE.md の drift / MCP 有無。symlink と inode は実測。

Direction A — Codex → Claude Code

Direct Imports

| Item | From | To | Action |

Needs Manual Review

| Item | Reason | Suggested handling |

Not Portable

| Item | Reason |

Proposed Diff

# 

Direction B — Claude Code → Codex

（同じ 4 小節: Direct Imports / Needs Manual Review / Not Portable / Proposed Diff）

Apply Command

両方向の候補を 1 リストに列挙し、方向・項目単位で選べるよう提示。Apply only after the user asks.

````

Apply 手順

apply を明示されたときのみ。

1. git status --short を確認。dirty なら worktree で隔離。
2. 対象ごとに .bak.。
3. JSON / TOML は structured parser で更新（JSON は JSONC 可能性を確認、TOML は table order 維持）。
4. git diff --check。
5. canonical を編集した場合、deployed copy / 共有ストアを sync。
6. 変更後の import summary を出す。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: HikaruEgashira
• Source: HikaruEgashira/agent-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.