Agents 体系

当前产品源码内置 57 个 agent profiles，分布在 6 个目录中。官网旧文档把数量写成 47，并沿用旧目录统计，这已经和当前源码不一致。

当前目录与数量

按当前 agents/ 目录统计：

目录	数量	主要职责
review/	28	代码评审与风险发现
document-review/	7	文档与计划审查
research/	14	仓库、文档、外部上下文研究
design/	3	视觉与实现对照
workflow/	4	工作流执行辅助
docs/	1	文档写作

---

这 57 个 agent 不是“57 个都会一起跑”

需要区分三件事：

1. 源码内置 agent 总数：57
2. 某个 workflow 会调度的子集
3. Review 阶段对外承诺的 reviewer persona 体系

也就是说：

• 57 代表整个能力层规模
• 不代表每次 Review 会把全部 agent 同时拉起

---

分类说明

1. review/

这是当前最大的 agent 目录，负责代码变更评审。

当前包含的 agent 包括：

• correctness-reviewer
• testing-reviewer
• maintainability-reviewer
• project-standards-reviewer
• code-simplicity-reviewer
• pattern-recognition-specialist
• security-reviewer
• security-sentinel
• performance-reviewer
• performance-oracle
• data-integrity-guardian
• data-migrations-reviewer
• data-migration-expert
• schema-drift-detector
• reliability-reviewer
• architecture-strategist
• api-contract-reviewer
• agent-native-reviewer
• cli-agent-readiness-reviewer
• cli-readiness-reviewer
• deployment-verification-agent
• adversarial-reviewer
• previous-comments-reviewer
• dhh-rails-reviewer
• kieran-rails-reviewer
• kieran-typescript-reviewer
• kieran-python-reviewer
• julik-frontend-races-reviewer

---

2. document-review/

这一组 agent 主要用于计划与文档质量审查：

• coherence-reviewer
• feasibility-reviewer
• scope-guardian-reviewer
• product-lens-reviewer
• design-lens-reviewer
• security-lens-reviewer
• adversarial-document-reviewer

---

3. research/

研究类 agent 在当前版本里已经明显多于旧官网文档中的数量。当前包括：

• best-practices-researcher
• docs-context-reader
• feishu-chat-researcher
• feishu-doc-reader
• framework-docs-researcher
• git-history-analyzer
• github-context-reader
• issue-intelligence-analyst
• learnings-researcher
• local-doc-reader
• repo-research-analyst
• session-historian
• slack-researcher
• web-context-reader

---

4. design/

• figma-design-sync
• design-iterator
• design-implementation-reviewer

---

5. workflow/

• bug-reproduction-validator
• lint
• pr-comment-resolver
• spec-flow-analyzer

---

6. docs/

• ankane-readme-writer

---

Review 阶段应如何表述

当前官网最容易写错的地方是把 Review 说成“26 个评审代理并行”。这个数字来自旧版本目录结构，已经不适合作为现在的官方对外口径。

更稳妥、与当前 README 一致的说法是：

• Review 依赖一套结构化 reviewer persona 体系
• 当前 README 对外强调的是 17 个 reviewer personas + 2 个 CE agents
• 具体调度会根据变更范围和风险选择 agent 子集

---

Claude 与 Codex 上的 agent 关系

双宿主都能使用同一套 agent 源码，但落地路径不同：

宿主	运行时路径
Claude Code	.claude/agents/
Codex	.codex/agents/

这也是为什么“方法论统一”不代表“运行时路径完全一致”。

---

官网不该再写的旧口径

• “总共 47 个代理”
• “research 只有 6 个代理”
• “review 只有 26 个代理，并且这就是当前 Review 的完整外显能力”

---

下一步

• Skills 生态
• Review 详细指南
• 工作流与阶段