将代理迁移到

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

目的

从以下位置迁移 Claude 代理定义.claude/agents/*.md(YAML frontmatter markdown body)到 Codex 兼容的输出.codex/agents/。首选输出:独立 TOML 自定义代理文件。仅向后兼容输出:纯降价行为规范。迁移剥离了 frontmatter,将字段映射到本地 Codex 合约,

对话-首先进入

裸请求应该以面向用户的操作菜单开始,而不是一堵 CLI 标志墙。遵循共享合同../migrate-to-codex/references/conversational-migration-contract.md。未指定请求的默认菜单:评估一名代理

高级命令行界面

首选包装纸:python3 .codex/skills/migrate-agents-to-codex/scripts/migrate_claude_agents_to_codex.py --agent example-agent-a --dry-run --json python3 .codex/skills/migrate-agents-to-codex/scripts/run_agent_migration_workflow.py --preview --agent example-agent-a --json python3 .codex/skills/migrate-agents-to-codex/scripts/run_agent_migration_workflow.py --agent example-agent-a --json高级用户引擎:

先决条件

Python 3.11+ 可用的兄弟技能存在:.codex/skills/migrate-to-codex/(提供共享功能).codex/agents/如果缺少目录将由脚本创建.codex/config.toml与 MCP 服务器定义一起存在 黄金标准参考(如果存在):之前迁移的代理工件

格式:Markdown 与 TOML

官方 Codex 自定义代理格式为 TOML,位于.codex/agents/*.toml。用途:--format toml对于新的迁移--format md仅适用于向后兼容的 Markdown 输出 规则:

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python >=3.11
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:评估复杂性并解决依赖性

上下文:用户提供代理名称、列表、`--all`,或者仍然需要菜单/前门路由的裸请求。运行后端之前:裸请求 -> 从共享会话合约显式操作 + 显式目标显示家庭菜单 -> 直接路由

02
第 2 步:映射字段

应用 agent-field-mapping.md 中的字段映射。关键转变:克劳德·菲尔德·法典部分`name`·`# Agent: {Title}`

03
步骤 2.6:转换嵌入式授权站点

如果源代理或其伴随引用包含嵌入式委托站点,请应用 subagent-migration-guide.md 中的决策过程。决策规则:可重用命名角色→创建`.codex/agents/<name>.toml`

04
步骤 2.5:验证域内容(仅限第 2-3 层)

为什么存在这一步:Claude 代理主体从代码库中漂移。路由常量被重命名,辅助函数被删除,测试基础设施被替换。如果您将过时的域示例复制到配套参考中,Codex 审核将捕获它们 - 但代价是额外的审核周期(约 500K-150 万个令牌)。先验证,再写一次。

05
第 5 步:本机 Codex 合规性审核(内联本机子代理)

时间:第 4 步验证通过后 - 向用户报告之前。仅限审核条目:如果代理已存在于`.codex/agents/`跟踪器说它是`pending_native_review`,此步骤可以作为只读单代理审核流程直接调用。在该进入路径中,首先进行审核,呈现调查结果以及下一步行动,然后自动记录`native`默认情况下

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。