codex-subagents-mcp
为Codex CLI提供基于文件的子代理管理工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：codex-subagents-mcp。 它的用途是：为Codex CLI提供基于文件的子代理管理工具 完整的 Skill 内容见：https://321skill.com/skills/codex-subagents-mcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用review代理来总结并评审我上一个提交的代码变更。” 随后，codex-subagents-mcp会启动一个配置了GPT-5模型、只读沙箱的独立Codex会话，专门处理这项审查任务，并将结果返回。
介绍
codex-subagents-mcp是一个专为Codex CLI设计的MCP服务器，旨在通过文件系统来管理和运行独立的子代理（Sub-Agent）。它解决了在复杂开发任务中需要不同专长AI代理协同工作的问题，通过将每个代理定义为独立的Markdown文件，实现了代理逻辑的版本化、可审计和CI/CD友好。
使用方式非常直接：用户安装并构建该MCP服务器后，在Codex CLI的配置文件中指向其绝对路径和代理目录。随后，用户便可以在Codex会话中调用delegate工具，将特定任务（如代码审查、调试）委派给预定义的代理（如“review”、“debugger”）。每个代理调用都在一个临时的、隔离的工作目录中执行，确保了状态的安全和纯净。
这个工具非常适合那些已经深度使用Codex CLI进行开发工作，并希望将复杂工作流拆解、分配给具有不同“专长”和配置（模型、审批策略、沙箱模式）的AI代理的开发者或团队。它尤其适合需要标准化、可重复的AI辅助审查或调试流程的工程环境。
与同类工具相比，它的核心区别在于其“基于文件”的极简哲学。它不依赖复杂的配置数据库或中心化服务，而是将代理定义、提示词和配置直接存储在项目仓库的Markdown文件中，这使得代理的创建、修改、审查和版本控制变得像管理代码一样简单透明，并与现有的Git工作流无缝集成。
核心特点
核心区别在于其“文件即代理”的极简设计理念。代理本身是项目仓库中的Markdown文件，可通过PR进行审计和修改，天然支持版本控制和团队协作，这与许多需要复杂配置或中心化管理的代理框架形成鲜明对比。
注意事项
该项目已归档不再维护，且仅适用于Codex CLI用户，不适用于其他AI IDE或通用MCP客户端。
常见问题
codex-subagents-mcp和Codex CLI自带的profile有什么区别？
Profile是Codex CLI的模型配置，而此工具是在此基础上，通过文件定义完整的代理“角色”（包含提示词、任务目标），并能以工具调用的方式动态创建隔离的执行环境来运行特定profile，实现任务委派。
这个工具需要联网或额外服务吗？
不需要。它是一个本地的MCP服务器，完全在用户本地运行，通过文件系统管理代理，并通过Codex CLI与AI模型交互。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/codex-subagents-mcp/raw/index.md 读取 codex-subagents-mcp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/codex-subagents-mcp/raw/index.md（查看排版版本）