migrate-to-codex

Codex への移行

自律性

選択された移行が完全に完了するまで続行してください。移行ツールを実行し、レポートを確認し、移行された Codex の指示・スキル・エージェント・MCP 設定を修正して、次の手順について確認を求めずにチェックを再実行してください。ユーザーが移行先を選択している場合、その移行先にある生成済み Codex 成果物（AGENTS.md、.codex/、.agents/、または ~/.codex/）の作成・編集・置換・削除について、事前に確認を求めないでください。.codex/config.toml または ~/.codex/config.toml にある notify、projects、marketplaces、無関係な MCP サーバーなど、既存の無関係な Codex 設定項目は保持してください。検証に失敗するか、移行と直接競合する場合を除き、それらについて確認を求めないでください。Claude Code のソースファイル（.claude/、~/.claude/、.mcp.json、または .claude.json）、無関係なプロジェクトコード、シークレット、別のリポジトリは編集しないでください。

移行順序

選択された各グローバルまたはプロジェクトのソースについて、次の順序で移行してください。

1. 最初に、Codex に組み込まれている TODO／タスクリストツールを使用してください。ユーザーから明示的に依頼されない限り、MIGRATION_TODOS.md やその他の TODO ファイルは作成しないでください。TODO リストの入力には、各項目に step と status がある plan 配列が含まれます。ステータスには pending、in_progress、completed を使用してください。TODO は選択された成果物に合わせて具体的にしてください。完了前に TODO リストを更新し、完了した手順はすべて completed にし、in_progress のままの手順がない状態にしてください。たとえば、次のようにソース → Codex の移行先をそのままラベルとして使用してください。

   • .claude/commands を確認 → Codex のスキル／プロンプト
   • .claude/agents を確認 → .codex/agents
   • .mcp.json を確認 → .codex/config.toml の MCP サーバー
   • .claude/settings.json のフックを確認 → .codex/hooks.json
   • 選択された安全な成果物を移行 → Codex ファイル
   • 生成された .codex/config.toml を検証
   • 生成された .codex/agents を検証
   • 移行した成果物と手動確認が必要な項目を報告

2. references/differences.md を読みます（Docs last checked の日付が古い場合は、Codex のドキュメントも更新してください）。

3. 書き込みの前にスキャンして確認します。

   • --scan-only は、アクティブおよび非アクティブなソース領域を一覧表示します。
   • --plan は、段階的な Codex 成果物のパスとレポート行を出力します。
   • --doctor は、準備状況、手動確認が必要な作業、検証リスクをまとめます。

4. CLI が使用する順序で領域を変換します。

   • 指示：CLAUDE.md／AGENTS.md から AGENTS.md へ
   • プラグイン：Claude のプラグインツリーとマーケットプレイスを、手動移行が必要な作業としてレポートします
   • フック：対応している Claude のフックを .codex/hooks.json に書き換え、[features].codex_hooks = true を有効にします
   • スキルとコマンド：Codex のスキルを .agents/skills/ に書き込みます
   • 設定：Claude のモデル／サンドボックス設定と MCP サーバーから .codex/config.toml を作成します。設定を生成する場合は personality = "friendly" を含めてください
   • サブエージェント：Codex のカスタムエージェントを .codex/agents/ に書き込みます

5. ドライランを実行してから、選択された移行先に書き込みます。孤立した生成済みスキルまたはエージェントを削除する必要がある場合に限り、--replace を使用してください。

6. 実際に実行した後、ターミナル出力と .codex/migrate-to-codex-report.txt を確認します。

7. 生成された成果物を次の順序で確認します。AGENTS.md、.agents/skills/、.codex/config.toml、.codex/hooks.json、.codex/agents/、最後にレポートのみに記載されたプラグイン項目を確認してください。

8. 編集後、各移行先に対して --validate-target を実行します。

9. 編集後、チェックと --dry-run を再実行します。

10. 行があるスコープごとに、最終移行レポートを Markdown テーブル 1 つで返します。テーブルには、実施した非ネイティブの追加移行作業のみを記載します。たとえば、スラッシュコマンドから作成したスキル、サブエージェント、MCP サーバー、フック、未対応／ローカルプラグインに関する注記、手動確認が必要な事項などです。設定、指示、スキル、対応プラグインのプログラムによるネイティブインポート行を含めるのは、この追加作業の実行中にあなた自身が移行した場合に限ります。 行があるスコープが 1 つだけの場合は、見出しを付けずにテーブルのみをレンダリングします。複数のスコープに行がある場合は、各テーブルの前に見出しを 1 つレンダリングします。ユーザースコープの行には **User Config** を使用します。プロジェクトスコープの行には、実際のプロジェクトフォルダー名を見出しとして使用します（例: **northstar-support-portal**）。見出しに Current Project は使用しないでください。テーブル出力の前後に文章を追加しないでください。

    次の列を正確に使用してください:

    northstar-support-portal

    Status	Item	Notes
    Added	Slash command pr-review	Codex スキルに変換されました
    Added	Subagent release-lead	Codex サブエージェントとして追加されました
    Check before using	Hook PreToolUse	変換されましたが、一部の Claude フックの動作は Codex では異なります
    Not Added	Hook Notification	Codex には同等の通知フックがありません
    Not Added	Plugin team-macros	プラグインには手動セットアップが必要です

    Status は Added、Check before using、または Not Added のいずれかでなければなりません。Codex 向けの成果物が作成または変更され、特別なレビューが不要な場合は Added を使用します。Codex 向けの成果物が作成または変更されたが、移行によってセマンティクスが変更された、動作が推測された、ツールルールがガイダンスとして保持された、またはサポートされていない動作が削除された場合は Check before using を使用します。ソース成果物が検出されたが、Codex 向けの成果物が作成されなかった場合は Not Added を使用します。Item は成果物の種類と具体的な項目名を 1 つのセルにまとめたものです。成果物の種類は単数形でなければなりません: Skill、Slash command、Subagent、MCP、Hook、または Plugin。成果物の種類をインラインコードで囲み、その後に項目名をプレーンテキストで記述します。Notes は常に必須です。空のままにしないでください。メモは短く、簡潔で、そのままの表現にしてください。runtime expansion のような内部実装用語は避けてください。Converted into a Codex skill、Added as a Codex subagent、Added to Codex config、Converted into a Codex hook、Converted, but some Claude hook behavior differs in Codex、Codex does not have an equivalent notification hook、Plugin needs manual setup、Plugin marketplace needs manual setup などのフレーズを優先してください。

自己修復ループ

選択した移行が完了するまでループを続けます:

1. --plan または --doctor を実行します。
2. --dry-run を付けて移行を実行します。
3. 移行を実際に実行します。
4. 生成されたすべての ## MANUAL MIGRATION REQUIRED ブロックと、Codex 成果物内で解決できるすべての manual_fix_required または skipped レポート行を修正します。
5. --validate-target を実行します。
6. レポートとバリデーターに対処が必要な生成成果物の修正が残らなくなるまで、移行ツールとバリデーターを再実行します。

このループの間、ソースの Claude Code ファイル、無関係なプロジェクトコード、シークレット、または別のリポジトリを編集しないでください。レポート行がソースプロバイダーの変更や製品上の判断を必要とする場合は、ソースを変更するのではなく、生成された Codex 成果物に明確な手動ガイダンスを残してください。

コマンド

移行ツールのコマンドを選択します。

MIGRATE_TO_CODEX='python3 .codex/skills/migrate-to-codex/scripts/migrate-to-codex.py'

書き込む前に移行を検査します。

$MIGRATE_TO_CODEX --source ~/.claude/ --scan-only
$MIGRATE_TO_CODEX --source ~/.claude/ --target ~/.codex/ --plan
$MIGRATE_TO_CODEX --source ~/.claude/ --target ~/.codex/ --doctor

グローバルおよびプロジェクトに対して、ドライランを実行してから --dry-run なしで実行します。

$MIGRATE_TO_CODEX --source ~/.claude/ --target ~/.codex/ --dry-run
$MIGRATE_TO_CODEX --source ~/.claude/ --target ~/.codex/
$MIGRATE_TO_CODEX --source ./.claude/ --target ./.codex/ --dry-run
$MIGRATE_TO_CODEX --source ./.claude/ --target ./.codex/

編集後に、各ターゲットに対して移行後のバリデーターを実行します。

$MIGRATE_TO_CODEX --validate-target ~/.codex/
$MIGRATE_TO_CODEX --validate-target ./.codex/

フラグ（--scan-only、--plan、--doctor、--validate-target、デフォルトなど）については $MIGRATE_TO_CODEX --help を実行します。詳細なテーブルとその他のリンクは references/differences.md にあります。