codex-subagent-plugin

并行运行多个Codex子任务,提升开发效率。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:codex-subagent-plugin。
它的用途是:并行运行多个Codex子任务,提升开发效率。
完整的 Skill 内容见:https://321skill.com/skills/codex-subagent-plugin/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我需要并行处理三件事:1. 为当前项目写一个详细的 README 文件,2. 为 utils 模块添加单元测试,3. 总结我过去一小时的代码变更并给出改进建议。” 它会自动调用此插件,创建三个并行的 Codex 子代理来同时完成这些任务,并最终汇总结果。

介绍

codex-subagent-plugin 是一个专为 Codex CLI 设计的插件,旨在解决单一任务流中无法并行处理多个独立子任务的痛点。它允许用户通过一个命令,将多个任务(如编写文档、添加测试、分析代码变更)同时分发给不同的 Codex 子代理执行,从而显著缩短任务总耗时。

使用方式非常直接:在 Codex 聊天界面中,直接描述你的并行任务需求(例如“并行运行三个子任务:写 README 示例、添加单元测试、总结未暂存的代码变更”),Codex 会自动调用此插件。你也可以通过命令行手动调用 runresume 命令来启动或恢复任务批次。

该插件非常适合需要同时推进多个独立模块的开发人员、项目经理或内容创作者。例如,全栈开发者可以同时让 AI 编写前端组件和后端接口;项目经理可以并行生成项目文档和制定下周计划。

建议在使用前确保 Codex CLI 已正确安装并配置。由于子任务运行在独立的沙箱环境中,请根据任务需求(只读或允许写入工作区)谨慎设置 --task-sandbox-mode 参数,并注意使用绝对路径指定工作目录。

核心特点

与只能串行处理任务的普通 Codex 使用方式不同,此插件核心在于“并行”与“会话恢复”。它不仅能同时发起多个子任务,还能为每个任务生成独立的会话 ID,允许用户后续精准地恢复特定任务,实现了任务级的并发管理与断点续作。

注意事项

不适合用于存在强依赖关系的串行任务链,因为并行任务之间默认是独立且无通信的。

常见问题

如何恢复之前运行过的某个子任务?

使用 `resume` 命令,并提供该任务对应的 `SESSION_ID` 即可继续。

子任务可以访问主会话的文件吗?

可以,但受沙箱模式限制:`read-only` 模式仅可读;`workspace-write` 模式可在指定工作目录内读写。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/codex-subagent-plugin/raw/index.md 读取 codex-subagent-plugin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。