Appearance
Agents 体系
Spec-First 包含 47 个专业代理，分布在 6 个核心目录中，提供从安全审查到性能优化的全方位专业能力。
Agent 目录概览
| 目录 | 角色 | 数量 | 使用场景 |
|---|---|---|---|
| review | 代码审查 | 26 | /spec:review 时自动调度 |
| document-review | 文档审查 | 7 | 规划文档审查时 |
| research | 代码研究 | 6 | 技术调研时 |
| design | 前端设计 | 3 | UI/UX 实现时 |
| workflow | 工作流支持 | 4 | 工作流执行时 |
| docs | 文档生成 | 1 | 文档维护时 |
详细分类
review 目录（26 个）
代码审查相关代理，分为始终运行和条件触发两类。
Always-on（始终运行，6 个）
每个 PR 都会经过这些代理审查：
| Agent | 职责 |
|---|---|
| correctness-reviewer | 逻辑正确性、边界条件、状态管理 |
| testing-reviewer | 测试覆盖、断言质量、边界测试 |
| maintainability-reviewer | 可维护性、抽象层级、命名 |
| project-standards-reviewer | 项目规范、CLAUDE.md/AGENTS.md 合规 |
| code-simplicity-reviewer | 代码简洁性、YAGNI 违规检测 |
| pattern-recognition-specialist | 设计模式、反模式、代码重复检测 |
条件触发（20 个）
根据代码变更内容自动匹配调度：
| Agent | 触发条件 |
|---|---|
| security-reviewer | 涉及认证、权限、用户输入 |
| security-sentinel | OWASP 合规、安全漏洞审计 |
| performance-reviewer | 涉及数据库查询、循环、缓存 |
| performance-oracle | 性能瓶颈、算法复杂度分析 |
| data-integrity-guardian | 涉及数据库迁移、数据模型 |
| data-migrations-reviewer | 涉及迁移文件、Schema 变更 |
| data-migration-expert | 数据迁移验证、回填脚本安全 |
| schema-drift-detector | 检测无关的 schema.rb 变更 |
| reliability-reviewer | 涉及错误处理、重试、超时、后台任务 |
| architecture-strategist | 涉及架构变更、模式引入 |
| api-contract-reviewer | 涉及 API 路由、类型签名 |
| agent-native-reviewer | 涉及 UI 功能、Agent 工具、系统提示 |
| cli-agent-readiness-reviewer | CLI 源码、Agent 可用性审查 |
| deployment-verification-agent | 生产部署检查清单、回滚方案 |
| adversarial-reviewer | 大型变更（≥50 行）或高风险域 |
| dhh-rails-reviewer | 涉及 Rails 应用代码 |
| kieran-rails-reviewer | 涉及 Rails 代码（严格标准） |
| kieran-typescript-reviewer | 涉及 TypeScript 代码 |
| kieran-python-reviewer | 涉及 Python 代码 |
| julik-frontend-races-reviewer | 涉及异步 UI、Stimulus/Turbo 生命周期 |
document-review 目录（7 个）
规划文档审查代理，在 /spec:plan 生成文档时调度：
| Agent | 职责 |
|---|---|
| coherence-reviewer | 内部一致性、术语冲突、结构完整性 |
| feasibility-reviewer | 技术可行性、依赖缺口、迁移风险 |
| scope-guardian-reviewer | 范围对齐、复杂度合理性 |
| product-lens-reviewer | 产品视角、问题框架、价值对齐 |
| design-lens-reviewer | 设计决策完整性、交互状态、用户流 |
| security-lens-reviewer | 安全假设、数据暴露、威胁模型 |
| adversarial-document-reviewer | 挑战假设、压力测试决策 |
research 目录（6 个）
代码研究代理，在技术调研和信息收集时使用：
| Agent | 职责 |
|---|---|
| best-practices-researcher | 外部最佳实践和社区规范研究 |
| framework-docs-researcher | 框架和依赖的官方文档研究 |
| git-history-analyzer | Git 历史考古、代码演进追踪 |
| issue-intelligence-analyst | GitHub Issue 分析、痛点趋势识别 |
| learnings-researcher | 历史解决方案和经验检索 |
| repo-research-analyst | 仓库结构、约定、模式分析 |
design 目录（3 个）
前端设计相关代理：
| Agent | 职责 |
|---|---|
| figma-design-sync | Figma 设计同步、视觉差异检测 |
| design-iterator | 设计迭代优化、截图对比改进 |
| design-implementation-reviewer | UI 实现与 Figma 设计对比审查 |
workflow 目录（4 个）
工作流执行支持代理：
| Agent | 职责 |
|---|---|
| spec-flow-analyzer | 规范和功能的用户流完整性分析 |
| bug-reproduction-validator | Bug 报告的系统性复现和验证 |
| pr-comment-resolver | PR 审查意见评估和修复 |
| lint | 代码 Lint 检查和自动修复 |
docs 目录（1 个）
文档生成相关代理：
| Agent | 职责 |
|---|---|
| ankane-readme-writer | 按照 Ankane 风格模板生成 README |
Agents 与 Skills 的关系
- Skills 负责流程编排，决定"何时"调用
- Agents 负责专业任务，决定"如何"执行
典型调度场景
场景 1：代码审查
bash
/spec:reviewSkills 根据代码变更自动选择调用：
- 所有变更 →
correctness-reviewer+testing-reviewer+maintainability-reviewer+ ... - 涉及 API →
api-contract-reviewer - 涉及数据库 →
data-integrity-guardian - 涉及认证 →
security-reviewer - 大型变更 →
adversarial-reviewer
场景 2：文档审查
bash
/spec:plan当生成计划文档时，document-review 目录的代理会审查：
- 内部一致性 →
coherence-reviewer - 可行性 →
feasibility-reviewer - 范围边界 →
scope-guardian-reviewer - 安全视角 →
security-lens-reviewer
查找 Agent
使用 VitePress 内置搜索（按 / 键）快速查找特定代理。
下一步
- Skills 生态 — 了解如何调度这些代理
- Review 详细指南 — 深入了解审查代理的调度逻辑
- 工作流概览 — 查看完整工作流