tdd-guide

🧪 自动化测试驱动开发向导

多框架测试驱动开发助手,提供自动化测试生成、覆盖率分析与红绿重构指导,显著提升代码质量与测试效率。

收藏
4k
安装
1.6k
版本
v1.0.0
CLS 安全性认证2026-05-08
点击查看完整报告 >

使用说明

该技能是一款专注于测试驱动开发(TDD)全流程的智能助手,旨在帮助开发者高效生成测试代码、分析测试覆盖率并规范红绿重构工作流。通过支持 Jest、Pytest、JUnit、Vitest 等主流测试框架,它为 JavaScript、TypeScript、Python 和 Java 开发者提供统一的测试解决方案。

核心用法涵盖三大场景:首先,测试生成功能允许用户输入源代码后,自动生成包含快乐路径、错误案例和边界条件的测试用例骨架;其次,覆盖率分析能够解析 LCOV、JSON 或 XML 格式的覆盖率报告,识别 P0/P1/P2 级别的覆盖缺口并生成补充测试建议;最后,TDD 工作流指导通过 tdd_workflow.py 脚本严格监督红绿重构周期,确保开发者在编写实现代码前先编写失败测试(RED),用最简洁代码通过测试(GREEN),并在保持测试通过的前提下优化代码结构(REFACTOR)。

显著优点包括其多框架适配能力,可在不同技术栈间无缝切换;自动化 fixture 生成器能创建逼真的测试数据和 mock 对象;内置的质量评分系统可检测测试异味(test smells),评估测试隔离性和断言质量。此外,纯 Python 标准库实现确保了跨平台兼容性和零依赖安装。

潜在局限性主要体现在其作为静态分析工具的本质:它无法实际执行测试代码或测量运行时行为,因此无法检测 flaky tests 或性能问题。语言支持主要集中在 TypeScript、JavaScript、Python 和 Java,对其他语言支持有限。生成的测试代码仅提供脚手架,复杂业务逻辑仍需人工审查和完善。此外,集成测试和端到端测试(E2E)需要 Playwright、Cypress 等专业工具,超出了本技能的范围。

适合的目标群体包括正在推行 TDD 实践的开发团队、需要快速提高遗留代码测试覆盖率的维护工程师、以及希望统一多项目测试规范的技术负责人。对于教授软件测试课程的教育工作者,该技能也能提供标准化的测试模板和工作流指导。

使用风险主要包括:虽然工具本身仅进行本地静态分析,但用户需警惕将生成的测试代码直接提交到生产环境,必须经过人工审查以防止逻辑错误。作为 T3 来源(社区个人开发者)的项目,建议关注代码更新来源的完整性。处理敏感代码时,建议先进行脱敏处理,尽管该技能本身不传输数据,但良好的安全习惯是必要的。此外,过度依赖自动化生成的测试可能导致测试与业务需求脱节,建议结合领域知识进行验证。

安全解读

核心用法

TDD Guide 是一套完整的测试驱动开发工作流工具集,涵盖三大核心场景:

1. 测试生成(Test Generation):将源代码或需求文档转换为结构化测试用例,支持 Jest、Pytest、JUnit、Vitest 四大主流框架,自动覆盖 happy path、错误处理与边界条件。

2. 覆盖率分析(Coverage Analysis):解析 LCOV/JSON/XML 格式的覆盖率报告,智能识别未覆盖代码路径,按 P0/P1/P2 优先级排序修复建议。

3. TDD 工作流指导(Red-Green-Refactor):分阶段验证 TDD 循环——RED(编写失败测试)、GREEN(最小实现通过)、REFACTOR(重构保绿),确保流程合规。

工具链包含 8 个 Python 脚本,从语言检测、测试生成、框架转换、Mock 数据构造到质量评分形成闭环。

显著优点

  • 零依赖安全架构:仅使用 Python 标准库(typing/json/re/os 等),彻底规避供应链攻击风险
  • 多语言多框架支持:TypeScript/JavaScript/Python/Java 无缝切换,框架适配器支持测试代码互转
  • 本地纯离线运行:无网络请求、无外部 API 调用,所有计算在本地完成
  • 代码透明可审计:MIT 许可证开源,2,680 行代码无混淆,托管于 GitHub 公开仓库

潜在缺点与局限性

| 局限项 | 说明 |
|--------|------|
| 单元测试聚焦 | 集成测试与 E2E 测试需配合 Playwright/Cypress 等专用工具 |
| 静态分析边界 | 无法执行测试或采集运行时性能数据 |
| 生成代码需人工审阅 | 复杂业务逻辑的测试断言仍需开发者补充调整 |
| 覆盖率报告格式受限 | 仅支持 LCOV/JSON/XML,其他格式需前置转换 |

适合人群

  • 希望建立 TDD 纪律的敏捷开发团队
  • 需要快速补全测试覆盖率的遗留项目维护者
  • 跨技术栈(Node.js/Python/Java)的多语言开发者
  • 对供应链安全敏感、偏好零依赖工具的企业环境

常规风险

  • 文件系统访问:需读取用户指定的代码文件路径,应避免传入含敏感凭证的配置文件
  • 代码解析处理:处理用户提交的源码时,需确保不含硬编码密钥的生产代码
  • 来源可信度 T3:社区项目维护,关键环境建议额外代码审查

tdd-guide 内容

assets文件夹
references文件夹
scripts文件夹
手动下载zip · 46.4 kB
expected_output.jsonapplication/json
请选择文件