VoltAgent/awesome-codex-subagents

这个项目是什么？

awesome-codex-subagents 是一个包含超过 175 个预构建配置文件（称为子代理）的集合，你可以将它们放入 OpenAI 的 Codex 工具中。每个子代理都是一个专门的 AI 助手，专注于特定的开发任务——例如，编写后端代码、审查安全性或构建 Docker 设置。无需从头开始，只需将这些文件复制到你的 Codex 设置中，并在需要时调用它们。

它是如何工作的？

每个子代理都是一个用 TOML（一种简单的配置格式）编写的文本文件，包含：

• 名称 – 如何称呼该代理。
• 描述 – 何时使用它。
• 模型 – 应该处理该任务的 AI 模型（见下文）。
• 沙盒模式 – 它只能读取文件，还是也可以写入文件。
• 指令 – 告诉 AI 如何表现的详细提示（如检查清单、模式和指南）。

子代理被组织成 13 个类别 —— README 显示了以下 6 个：核心开发、语言专家、基础设施、质量与安全、数据与 AI，以及开发者体验。其余未在此摘录中列出，但所有类别总计 175+ 个。

关键设计选择

• 智能模型路由 – 每个子代理根据任务的复杂性分配三种 AI 模型之一：
  • gpt-5.6-sol – 用于深度推理（如安全审计或架构审查）。
  • gpt-5.6-terra – 用于实现和多步骤专业任务（如测试或数据分析）。
  • gpt-5.6-luna – 用于轻量级任务（如搜索、提取或起草）。
• 沙盒模式 – 审查者和审计者使用 read-only（不更改文件），而开发者使用 workspace-write（可以创建/编辑文件）。

如何安装和使用

1. 克隆仓库。
2. 将你想要的 .toml 文件复制到以下任一处：
   • ~/.codex/agents/ – 使子代理可用于所有项目（全局）。
   • 特定项目内的 .codex/agents/ – 仅使该子代理可用于该项目（如果出现名称冲突，则优先）。
3. 重启或刷新你的 Codex 会话。
4. 当你想使用子代理时，在提示中明确提及它 – Codex 不会自动启动它们。

复制命令示例：

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

为什么这很重要

无需从头编写你自己的详细 AI 提示，你可以获得一个经过测试的、任务特定的提示，并且已经与 Codex 的官方文档保持一致。它节省了时间，并为常见的编码工作提供了精细调整的行为。