核心用法
tdd-helper 是一款轻量级开发辅助工具，专为非确定性 AI 代理设计，强制实施测试驱动开发（TDD）工作流。其核心机制围绕 tdd.py 脚本展开，该脚本作为任务包装器运行：在执行目标代码前，必须先验证测试存在且通过；若测试缺失或失败，则立即阻断执行。用户通过命令行指定测试目录（默认为 tests/）和待运行命令，工具会自动完成前置检查。
配置方式灵活，支持环境变量或 JSON 文件进行简单定制。可选功能包括 lint 检查与警告监控，可将警告提升为错误级别以阻断执行。这种设计尤其适合 AI 代码生成场景——防止模型直接生成"能跑就行"的代码而忽略测试验证。
显著优点
- 流程刚性约束：从机制层面杜绝"先写代码后补测试"的捷径，对自律性不足的 AI 代理尤为有效
- 轻量无侵入：单文件脚本实现，不绑定特定框架，pytest 作为唯一外部依赖
- CI/CD 友好：命令行接口设计便于集成到自动化流水线
- 可配置严格度：警告即错误、lint 检查等开关允许根据团队规范调整约束强度
潜在缺点与局限
- 依赖外部测试框架：目前仅明确支持 pytest，对其他测试框架（如 unittest）的兼容性存疑
- 无测试覆盖度分析：仅检查测试存在性与通过状态，不评估测试质量或覆盖率
- 配置能力有限：JSON/环境变量配置相比完整配置文件方案略显简陋
- 非确定性代理专用：对人类开发者而言，IDE 插件或 git hooks 可能是更自然的约束点
适合人群
- 需要为 AI 编程助手（如 GPT-4、Claude 等）强制建立 TDD 纪律的技术团队
- 追求极简工具链、不愿引入复杂 DevOps 平台的个人开发者
- 教育场景中需要向学生演示红-绿-重构循环的培训机构
常规风险
- 误阻断风险：配置不当可能导致合法代码变更因警告级别设置过严而无法运行
- 测试本身缺陷：工具无法识别测试逻辑错误，存在"测试通过但功能实际异常"的盲区
- 环境依赖：要求目标系统同时安装 python3 与 pytest，容器化场景需确保镜像包含依赖