Codex 迁移助手
将 Claude Code 的指令、技能、代理与 MCP 配置迁移到 Codex。
证据显示其限定迁移范围、禁止修改源文件和无关代码，并要求保留无关配置；但明确要求在用户选择目标后无需再次确认即可创建、替换或删除生成物，且 --replace 可删除孤立生成工件，缺少更强的确认、回滚和敏感数据流说明，因此扣分。
迁移顺序、检查循环、报告和目标验证均有明确说明，但本次静态材料中的 cli.py 在 parser.add_arg 处截断，无法确认脚本完整可运行；也没有提交测试套件或关键路径执行证据，因此仅给低分。
目标用户、迁移场景、支持的源表面和若干不支持项描述较清楚，且提供多种命令；但触发条件、非适用边界、中文支持和中国大陆网络环境适配未明确，部分功能依赖 Codex、GitHub 或官方文档可达性，因此扣分。
目录分层、参考文档、命令示例、手动复核块和已知映射限制较完整，且有 OpenAI 来源信息；但许可证元数据未知，仓库 README 标明已弃用，版本、变更记录和具体维护责任不清，因此扣分。
技能覆盖扫描、计划、迁移、修复、验证和报告，理论上可完成核心迁移并生成直接可读的表格；但未执行验证，脚本完整性和实际输出正确性无法确认，且部分 Claude 语义只能留下手动指导，因此不超过静态上限并扣分。
源文件、映射规则和验证函数提供了一定可审计性；但没有本技能专属测试、CI 覆盖或第三方执行结果，结论主要依赖静态阅读，因此证据强度有限。
- 不要将“无需确认”理解为适合所有目标；在使用 --replace 或覆盖已有 Codex 工件前应人工确认并准备备份。
- 先确认 cli.py 文件完整且可运行，再依次执行 dry-run、实际迁移和 validate-target。
- 迁移后的权限、钩子、工具白名单、OAuth/MCP 和 Claude 特有语义可能只被保留为提示文字，必须人工复核。
- 仓库已标记为弃用，许可证和后续维护路径应在采用前另行确认。
它能做什么 & 适用场景
该技能用于把选定的 Claude Code 项目级或全局配置迁移为 Codex 文件。它会扫描、规划并执行迁移，处理指令、技能、命令、钩子、配置和子代理。迁移后会检查报告、修复可在 Codex 侧解决的问题，并运行目标验证。它适合正在从 Claude Code 转向 Codex、且希望保留现有工作流的开发者。
运行 Python 迁移脚本，对 Claude Code 源目录执行扫描、计划、诊断、试运行和实际迁移；将指令写入 AGENTS.md，将技能写入 .agents/skills/，将配置和 MCP 服务器写入 .codex/config.toml，将钩子写入 .codex/hooks.json，并将子代理写入 .codex/agents/。它还会读取迁移报告，执行 --validate-target，并在修改后重新运行检查。
- 正在迁移个人 ~/.claude/ 配置到 ~/.codex/ 的开发者。
- 希望把项目 .claude/ 中的技能、命令和代理转换为 Codex 文件的团队。
- 需要把 Claude Code MCP 服务器配置整理到 Codex 配置中的用户。
- 迁移后需要检查生成文件和人工复核项目的维护者。
优缺点一览
- 覆盖指令、技能、命令、钩子、配置、MCP 服务器和子代理等迁移面。
- 包含扫描、计划、诊断、试运行、验证和自我修复流程。
- 明确保护无关 Codex 配置，并避免修改源 Claude Code 文件。
- README 标明该仓库已弃用，当前示例应参考 OpenAI Plugins 仓库。
- 仅提供 SKILL.md，未提供测试套件或迁移成功率证据。
- 插件和市场等部分内容仍可能需要人工迁移。
如何安装
这是 openai/skills 的 curated 技能。安装命令为：$skill-installer migrate-to-codex。安装后重启 Codex 以加载技能。
如何使用
先选择全局或项目源目录及目标目录，然后让 Codex 执行迁移。技能使用的迁移命令示例：python3 .codex/skills/migrate-to-codex/scripts/migrate-to-codex.py --source ./.claude/ --target ./.codex/ --dry-run；确认计划后移除 --dry-run 执行写入，最后运行 --validate-target 验证目标。