codex-cli-setup
让Codex CLI能够创建并管理子代理,实现多智能体协作。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:codex-cli-setup。 它的用途是:让Codex CLI能够创建并管理子代理,实现多智能体协作。 完整的 Skill 内容见:https://321skill.com/skills/codex-cli-setup/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我重构这个项目的所有API调用,将HTTP升级为HTTPS。” 主Codex代理在分析任务后,会调用`subagents`技能,启动一个子代理在后台非交互地执行`codex exec --full-auto "Update all API calls to HTTPS" 2>/dev/null`命令,完成代码修改后向您汇报结果。或者,当您需要同时进行代码审查和运行测试时,可以指示主代理分别创建两个子代理来并行处理这些任务。
介绍
这个Skill解决了Codex CLI在处理复杂任务时无法分而治之的问题。它通过一个名为subagents的核心技能,教会主Codex代理如何启动另一个Codex进程作为“子代理”来执行特定任务。
使用方式非常简单:将Skill文件复制到Codex CLI的指定技能目录(~/.codex/skills/),Codex便会自动发现并掌握调用子代理的能力。当主代理遇到需要并行处理、隔离执行或长时间运行的任务时,就可以调用此技能来创建子代理。
它非常适合需要将大任务拆解、或希望实现主代理与子代理分工协作的智能体开发者、全栈工程师和项目经理。例如,主代理负责总体协调和决策,而子代理则专注于执行具体的代码重构、测试或文档生成等耗时命令。
需要注意的是,此功能目前处于Alpha阶段,安装前需启用实验性功能。在macOS上运行时,主代理可能需要使用--yolo标志来绕过权限限制。
核心特点
核心在于将Codex CLI自身作为可调用的工具,实现了代理的“自我复制”与嵌套执行,而非简单地调用外部脚本或API。它通过`codex exec`命令在非交互模式下重用当前项目上下文,并默认隐藏子代理的冗长日志流,只呈现最终结果,优化了多代理协作的体验。
注意事项
目前处于Alpha阶段,在macOS上存在权限限制,且不适合需要实时、紧密交互或频繁状态同步的多代理场景。
常见问题
子代理和主代理有什么区别?
子代理是主代理通过`codex exec`命令启动的另一个Codex进程,默认以非交互、只读沙箱模式运行,专注于执行单一任务并返回结果,不参与主对话流。
如何查看子代理的执行日志进行调试?
在调用子代理的技能指令中,可以关闭`2>/dev/null`重定向,或修改Skill配置来启用日志流输出,从而查看详细的执行过程。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/codex-cli-setup/raw/index.md 读取 codex-cli-setup 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/codex-cli-setup/raw/index.md(查看排版版本)