175+ 个 Codex 子代理，一个仓库克隆即用

Codex 可以调用专门的子代理，但子代理的好坏取决于它的定义文件——而手写十几个定义文件，谁也挤不出那个周末。VoltAgent/awesome-codex-subagents，一个来自 VoltAgent 团队的 6k star awesome 榜单，收录了 175+ 个写好的子代理定义，横跨 13 个类别，每个定义就是一个复制到指定位置即可用的 .toml 文件。

为什么这个 Skill 重要

README 将这个合集定位为「专为 Codex 编写、与官方文档对齐」——这些是 Codex 原生的 .toml 代理文件，不是通用提示词。每个定义都带有名称、调用时机描述、模型指派、推理力度和沙箱模式，所以「用哪个模型、给多少文件系统权限」这类配置层面的决策已经按角色定好了。

类别覆盖核心开发（13 个代理）、语言专家（31 个）、基础设施（16 个）、质量与安全（20 个）、数据与 AI（14 个）、开发者体验（14 个）、垂直领域（14 个）、商业与产品（17 个）、元与编排（12 个）、研究与分析（12 个）、AI 治理与安全（4 个）、平台工程与 IDP（4 个）、LLMOps、评测与可观测性（4 个）。后端支援、安全审计、市场调研，同一个仓库都能覆盖。

安装

没有安装器。README 的流程是克隆、复制、刷新：

mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/

~/.codex/agents/ 存放全局代理，在所有项目可用；.codex/agents/ 存放项目级代理，优先级更高。同一个名字两处都存在时，项目级的生效。复制后重启或刷新 Codex 会话；代理配置按官方文档放在 .codex/config.toml 的 [agents] 下。

有一个行为要记牢：Codex 不会自动拉起自定义子代理。你要在提示词里显式委派——点名代理、描述工作、说明结果形态。

实战：并行 PR 审查

README 自带的示例工作流用一个提示词委派给两个子代理：

Review this branch with parallel subagents. Have reviewer look for correctness, security, and missing tests. Have docs_researcher verify the framework APIs this patch depends on. Wait for both and summarize the findings with file references.

reviewer 代理以只读沙箱跑 PR 式审查，docs-researcher 对照文档核实补丁依赖的框架 API。由于以读取为主的代理先于任何写入返回，主线程保持干净，结论带着可以核对的文件引用到达。

实战：先定位再修复 Bug

README 的第二个工作流把探索串成修复：

Investigate the broken settings flow. Have code_mapper trace the owning code paths, browser_debugger reproduce the bug in the browser, and frontend_developer propose the smallest fix after the failure is understood. Wait for the read-heavy agents first, then continue.

这个提示词就是整个合集的设计哲学：以读取为主的代理（code-mapper、browser-debugger）先确立事实，之后工作区可写的开发代理（frontend-developer）才动手改文件。

技巧

• 信任每个文件内置的模型路由：gpt-6.1-sol 承担复杂编码、架构和安全工作（security-auditor、docker-expert），gpt-6-luna 承担有边界的搜索、抽取和起草（search-specialist、docs-researcher）。
• 委派前先看 sandbox_mode 字段：审查者和审计者跑 read-only，开发者和工程师跑 workspace-write。
• agent-installer 子代理可以通过 GitHub 浏览并安装本仓库的代理，所以在会话内就能补角色。
• 如果榜单没有你想要的角色，README 接受 PR 投稿——.toml 格式足够短，可以自己写。
• 维护者明确说明子代理来自社区投稿、未经审计；加载任何定义前先过目。

何时不用这个 Skill

这些是 Codex .toml 格式的 Codex 子代理——README 只文档化了 Codex 的代理目录，没有为其他运行时打包任何内容。如果你的工作没有自然的分解（单文件小改、随手一问），显式委派只增加仪式感、没有收益。而且因为委派永远是显式的，这个合集不会让 Codex 自己变「聪明」；它的价值出现在你真的把任务路由给专家的那一刻。

查看 排行榜 了解更多 skill。