核心功能与定位
TDD Guide 是一套专注于测试驱动开发（Test-Driven Development）的自动化工作流工具，覆盖测试生成、覆盖率分析、红绿重构（Red-Green-Refactor）全流程。该技能针对 Jest、Pytest、JUnit、Vitest 等主流测试框架提供适配支持，适用于 JavaScript/TypeScript、Python、Java 技术栈。
核心能力拆解
1. 智能测试生成
通过 test_generator.py 将源代码或需求文档转换为结构化测试用例，自动覆盖 happy path、异常分支与边界条件。支持基于代码的反向推导，也可基于需求的前向设计。
2. 覆盖率深度分析coverage_analyzer.py 解析 LCOV、JSON、XML 格式的覆盖率报告，识别未覆盖代码路径并按 P0/P1/P2 优先级排序，帮助团队聚焦关键缺口。
3. TDD 工作流引导td_workflow.py 严格遵循 RED-GREEN-REFACTOR 三阶段：验证测试先失败（RED）、验证最小实现通过（GREEN）、确保重构后测试仍通过（REFACTOR），强制贯彻 TDD 纪律。
4. 质量评估体系metrics_calculator.py 检测测试异味（test smells），评估测试隔离性、断言质量、命名规范，辅助建立可维护的测试资产。
显著优点
- 多框架兼容：一套工具链覆盖前后端主流测试框架，降低多技术栈团队的学习成本
- 流程规范化：将 TDD 的抽象原则转化为可执行的脚本验证，减少人为遗漏
- 数据驱动决策：覆盖率缺口优先级排序，避免盲目追求数字而忽视关键路径
局限性与适用边界
- 单元测试为主场：明确限定于单元测试层级，集成测试、E2E 测试需配合 Playwright、Cypress 等专用工具
- 静态分析约束：无法执行实际测试或采集运行时性能数据，动态行为验证能力有限
- 生成代码需人工审阅：复杂业务逻辑的测试脚手架需要开发者补充语义化断言
- 报告格式受限：仅支持 LCOV/JSON/XML，其他格式需前置转换
适合人群
- 正在推行 TDD 实践的开发团队，需要工具化支撑流程纪律
- 多技术栈团队寻求统一的测试工作流标准
- 遗留项目需要系统化提升测试覆盖率
常规风险提示
该工具定位为开发辅助而非替代人工判断，生成测试的正确性高度依赖输入代码质量与需求清晰度。覆盖率数字本身不等于代码质量，需结合业务关键路径综合评估。框架适配器（framework_adapter.py）的跨框架转换可能存在语义损失，转换后必须人工验证。
---
综合评价：TDD Guide 是技术债务防控与代码质量基线建设的实用工具，适合将 TDD 从"倡导"落实为"可执行流程"的团队，但需清醒认知其自动化边界，避免过度依赖生成结果。