TDD 守卫

为 Claude Code 提供的自动化测试驱动开发强制执行工具。

概述

TDD 守卫确保 Claude Code 遵循测试驱动开发原则。当你的代理试图跳过测试或过度实现时，TDD 守卫会阻止该操作，并解释应该采取什么措施。

点击观看 TDD 守卫的实际运行

功能特性

• 测试优先强制执行 - 在没有失败测试的情况下阻止代码实现
• 最小化实现 - 防止超出当前测试需求的代码编写
• 与 Lint 集成 - 使用你的 Lint 规则强制执行重构
• 可自定义规则 - 根据你的 TDD 风格调整验证规则
• 灵活的验证方式 - 根据需求选择更快或更强大的模型
• 会话控制 - 可在会话中随时开启或关闭

快速开始

需求

• Node.js 22+
• 支持的测试框架（Vitest、Jest、Storybook、pytest、PHPUnit、Go、Rust、RSpec）

安装

在你的项目中打开 Claude Code 并执行以下步骤：

1. /plugin marketplace add nizos/tdd-guard
2. /plugin install tdd-guard@tdd-guard
3. /tdd-guard:setup

这将添加插件市场、安装插件，并为你的项目配置测试报告器。你可能需要重启终端会话或 IDE 扩展，以使设置技能显示出来。如需手动安装和配置，请参阅 安装指南。

配置

• 自定义指令 - 自定义 TDD 验证规则
• Lint 集成 - 自动化重构支持
• 强化执行 - 防止代理绕过验证
• 忽略模式 - 控制哪些文件会被验证
• 验证模型 - 选择更快或更强大的模型
• 所有设置 - 完整的设置文档

安全性

TDD 守卫的钩子以你的用户权限运行。我们维护自动化的安全扫描、依赖项审计，并欢迎源代码审查。有关钩子安全性的更多信息，请参阅 Claude Code 的安全注意事项。

开发

贡献

欢迎贡献！请参阅 贡献指南 开始参与。

贡献者：

• Python/pytest 支持：@Durafen
• PHP/PHPUnit 支持：@wazum
• Rust/cargo 支持：@104hp6u
• Go 支持：@sQVe、@wizzomafizzo
• Storybook 支持：@akornmeier
• Ruby/RSpec 支持：@Hiro-Chiba

路线图

• 扩展对更多语言和测试框架的支持
• 验证通过 MCP 和 Shell 命令进行的文件修改
• 鼓励在测试通过时进行有意义的重构
• 添加对每个项目多个并发会话的支持

支持

• 讨论区 - 提问和分享想法
• 问题 - 报告 Bug 和请求功能

许可证

MIT

TDD Guard 快速上手指南

TDD Guard 是一款专为 Claude Code 设计的自动化插件，旨在强制遵循测试驱动开发（TDD）原则。当 AI 代理试图跳过测试编写或直接过度实现功能时，该工具会拦截操作并引导其回归正确的开发流程。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本 22 或更高。
• 编辑器/终端: 已安装并配置好 Claude Code。
• 测试框架: 项目中需包含支持的测试框架之一：
  • JavaScript/TypeScript: Vitest, Jest, Storybook
  • Python: pytest
  • PHP: PHPUnit
  • Go: testing
  • Rust: cargo test
  • Ruby: RSpec

安装步骤

请在您的项目根目录下打开终端（确保已启动 Claude Code 会话），依次执行以下命令：

1. 添加插件市场源

   /plugin marketplace add nizos/tdd-guard
   

2. 安装插件

   /plugin install tdd-guard@tdd-guard
   

3. 初始化配置

   /tdd-guard:setup
   

   注意：执行完 setup 后，您可能需要重启终端会话或 IDE 扩展，以便让配置生效并加载相关技能。

基本使用

安装完成后，TDD Guard 会自动介入您的开发会话，无需额外命令即可生效。

工作流程示例

当您向 Claude Code 提出新功能需求时，TDD Guard 将按以下逻辑工作：

1. 用户指令：

   "为用户登录功能添加邮箱验证字段。"

2. AI 尝试直接写代码（被拦截）： 如果 AI 试图直接修改业务逻辑代码而未先编写测试，TDD Guard 会阻止该操作并提示：

   "❌ 操作被拦截：检测到未通过的红测试（Red Test）。请先编写一个失败的测试用例来验证邮箱验证逻辑。"

3. AI 编写测试（通过）： AI 编写测试并运行，测试失败（符合 TDD 红条阶段）。

4. AI 实现最小功能（通过）： AI 编写刚好能让测试通过的代码。TDD Guard 会检查是否有多余的实现，确保代码仅满足当前测试需求。

5. 重构与Lint（可选）： 如果配置了 Lint 集成，工具会在测试通过后自动提示或执行代码重构。

临时控制

如果您需要在会话中暂时关闭强制检查，可以使用会话控制功能随时开启或关闭插件（具体开关命令取决于当前会话上下文，通常在插件激活状态下可用）。

---

更多高级配置（如自定义规则、忽略文件模式、选择验证模型等），请参考项目文档中的 Configuration 部分。