Everything Claude Code TDD Guide Agent 是一款专为 Claude Code、Codex、Cursor 等 AI 编程助手打造的测试驱动开发（TDD）专职代理。它强制执行“先写测试再写实现”的开发流程，自动引导 Red-Green-Refactor 全周期，确保单元、集成与 E2E 测试覆盖率不低于 80%。适用于新功能开发、Bug 修复和重构等关键场景，能有效避免遗漏边界用例、提升代码质量，并与其他专业 Agent 协同实现生产级 DevOps 流程。

Everything Claude Code TDD Guide Agent：强制测试先行、确保 80%+ 覆盖率的测试驱动开发代理

1. TDD Guide Agent 是什么？解决什么问题？

TDD Guide Agent 是 Everything Claude Code 插件体系中的测试驱动开发专职代理，核心职责是强制推行测试先行、覆盖率达标的开发流程。在 AI 辅助编程场景下，直接用 Claude 或 Codex 虽然可以生成代码和测试，但很难做到流程规范、覆盖率达标和边界用例不遗漏。TDD Guide Agent 通过自动化流程和严格规则，解决了以下痛点：

• 开发过程“测试先行”难以坚持：AI 助手常常默认“先写实现再补测试”，容易遗漏边界和异常分支。
• 测试覆盖率不达标：人工或普通 AI 生成测试时，往往只覆盖主流程，遗漏大量分支和异常路径。
• 缺乏系统性边界与异常用例捕捉：如 null/undefined、空数组、错误类型、极值、性能等边界场景常被忽略。
• 团队协作中测试标准不统一：TDD Guide Agent 统一流程和标准，确保团队成员输出一致的高质量代码。

TDD Guide Agent 适用于新功能开发、Bug 修复、重构等所有需要保证质量的场景，自动引导 Red-Green-Refactor 流程，强制要求 80%+ 覆盖率，并输出详细的测试清单和质量检查项。

2. 具体能力：能做什么，不能做什么？

能做什么

• 全流程 TDD 引导：自动分步执行 Red（写失败测试）→ Green（最小实现）→ Refactor（重构优化）→ 覆盖率验证。
• 强制 80%+ 覆盖率：每次开发完成后自动检测并报告覆盖率，未达标则阻止提交。
• 自动生成单元、集成、E2E 测试：根据功能特征，自动区分并生成三类测试，覆盖主流程与关键路径。
• 捕捉并测试边界/异常用例：如 null、空、类型错误、极值、错误分支、并发、特殊字符等。
• 输出详细质量检查清单：每次开发后自动检查所有公开函数、API、关键流程的测试情况。
• 与其他 Agent 协同：如与 Code Reviewer、Build Error Resolver、E2E Runner 等协作，形成完整的 DevOps 流程闭环。

不能做什么

• 不直接替代人工架构决策：如需系统性架构调整，需配合 Architect Agent。
• 不负责安全漏洞检测：需配合 Security Reviewer Agent。
• 不处理构建/类型错误：构建失败需交由 Build Error Resolver Agent。
• 不生成业务需求与计划：需求拆解与任务规划需用 Planner Agent。

3. 触发方式：自动激活 vs 手动调用

• 自动激活：在以下场景自动触发 TDD Guide Agent：
  • 新建功能、修复 Bug、重构代码时
  • 检测到代码变更后未检测到对应测试文件
  • 提交前发现覆盖率未达标
• 手动调用：可通过命令面板、快捷指令或显式选择“用 TDD Guide Agent 开发本功能”手动激活，适用于：
  • 需要严格 TDD 流程的高风险功能
  • 希望 AI 全程引导测试与实现的场景

4. 与其他 Agent 的协作模式

TDD Guide Agent 并非孤立运行，而是与 ECC 体系下多种专业 Agent 形成协作闭环，常见组合包括：

• TDD Guide + Code Reviewer：TDD Guide 保证测试先行与覆盖率，Code Reviewer 负责代码风格、可维护性和安全性审查。
• TDD Guide + Build Error Resolver：测试驱动开发中遇到构建或类型错误时，自动交由 Build Error Resolver 修复。
• TDD Guide + E2E Runner：关键用户流程由 TDD Guide 生成 E2E 测试用例，E2E Runner 负责实际运行和回归管理。
• TDD Guide + Security Reviewer：在涉及敏感逻辑或外部输入时，TDD Guide 负责测试覆盖，Security Reviewer 负责安全漏洞检测。
• TDD Guide + Hooks/Rules：可通过 Hooks 自动化体系 实现如“每次提交前自动检测覆盖率”，通过 Rules 体系 强制团队遵守 TDD 流程。

5. 实际使用示例

假设你在 Claude Code/Cursor 环境下开发一个“用户注册”API，完整 TDD Guide Agent 流程如下：

Step 1：自动检测到新建 API 文件，TDD Guide Agent 介入

TDD Guide Agent: “检测到新功能开发，已启动测试驱动开发流程。请先描述预期行为，我将为你生成初始测试。”

Step 2：生成并运行失败测试（RED）

// userRegister.test.ts
it('should register user with valid email and password', async () => {
  const res = await registerUser('test@example.com', 'password123');
  expect(res.success).toBe(true);
  expect(res.user.id).toBeDefined();
});

TDD Guide Agent: “测试已生成并运行，当前测试失败（预期 RED 阶段）。”

Step 3：生成最小实现（GREEN）

// userRegister.ts
export async function registerUser(email: string, password: string) {
  // Minimal implementation for test passing
  return { success: true, user: { id: 'mock-id' } };
}

TDD Guide Agent: “最小实现已生成，测试通过（GREEN 阶段）。”

Step 4：自动补充边界与异常用例

• 空邮箱/密码
• 非法邮箱格式
• 密码过短
• 邮箱已注册
• 数据库异常

it('should fail if email is empty', ...);
it('should fail if password is too short', ...);
it('should handle DB errors gracefully', ...);

Step 5：自动检测并报告覆盖率

npm run test:coverage
# 输出：branches 85%，functions 90%，lines 88%，statements 87%

TDD Guide Agent: “覆盖率达标，所有公开函数与关键路径已覆盖。请继续 Refactor 优化。”

Step 6：输出质量检查清单

• [x] 所有公开函数有单元测试
• [x] API 有集成测试
• [x] 关键流程有 E2E 测试
• [x] 边界/异常用例已覆盖
• [x] 覆盖率 80%+

Step 7：自动建议 Code Reviewer Agent 介入代码审查

TDD Guide Agent: “建议调用 Code Reviewer Agent 进行风格与安全性审查。”

6. 为什么要用专门的 TDD Guide Agent，而不是直接问 Claude？

• 流程强制与标准化：普通 AI 对话无法保证你每次都“先写测试”，而 TDD Guide Agent 会自动阻断不合规流程，强制你走 Red-Green-Refactor。
• 覆盖率硬性达标：TDD Guide Agent 内置覆盖率检测与报告，未达 80%+ 自动提醒并阻止提交，普通 AI 不会主动检查。
• 边界用例系统性捕捉：TDD Guide Agent 内置边界/异常用例清单，自动补全常见疏漏（如 null、空、极值、并发等）。
• 与团队协作无缝对齐：Agent 可通过 Rules 体系 统一团队 TDD 标准，普通 AI 难以保证多人协作一致性。
• 可与其他 Agent 形成闭环：如自动串联 Code Reviewer、Build Resolver、E2E Runner 等，普通对话 AI 无法实现自动化链路。

更多 ECC 体系 Agent 协作与 Skill 体系介绍，见 Everything Claude Code 完全指南。

---

FAQ

Q: TDD Guide Agent 会自动生成所有测试用例吗？ A: 会自动生成主流程、边界和异常用例的单元、集成、E2E 测试，但你可补充业务特有场景，Agent 会提醒遗漏。

Q: 覆盖率未达 80% 会怎样？ A: Agent 会阻止提交、提示补充测试，直到所有类型覆盖率都达标为止。

Q: 支持哪些语言和测试框架？ A: 支持 TypeScript、Python、Java、Kotlin、C++、C#、Dart 等主流语言及其常用测试框架，具体可通过 Rules/Skills 配置。

Q: 如何自定义 TDD 流程或覆盖率标准？ A: 可通过 ECC 的 Rules 文件和 Skill 配置自定义流程细节和覆盖率阈值，满足不同项目需求。

---