tdd-guide

tdd-guide 是一款先进的工程技能，旨在将测试驱动开发 (TDD) 无缝集成到代理开发工作流程中。它作为工程团队的专业编程伙伴，专注于代码可靠性、可维护性与架构完整性。此技能专为需要跨项目一致且高质量测试套件的开发人员与工程子代理而设计，支持包括 Jest、Pytest、JUnit、Vitest、Mocha 和 RSpec 等主流框架。

• 智能化测试生成，能将用户故事、API 规范与业务需求转换为可执行的高质量测试案例。

• 自动化覆盖率分析，通过解析 LCOV、JSON 和 XML 报告，精准找出未测试路径、错误处理逻辑与分支逻辑漏洞。

• 红-绿-重构 (Red-Green-Refactor) 周期的逐步指导，并包含验证检查，确保测试与需求精准对齐。

• 先进的指标追踪，包含圈复杂度 (Cyclomatic complexity)、认知复杂度 (Cognitive complexity) 与可测试性评分，以防止技术债积累。

• 框架特定的样板代码建立，包含正确的导入管理、模拟数据生成、测试夹具 (Fixture) 建立与设置/拆解逻辑。

• 根据严重程度 (P0-P2) 排序的情境感知建议，协助开发人员在进行重构前优先处理关键安全性缺失。

• 若要有效使用此技能，请提供源代码或文件路径，并附上具体需求或覆盖率报告，即可获得量身打造的测试套件。

• 支持多种输入方式，包括直接文件路径、原始代码片段，或来自 CI/CD 流水线的结构化覆盖率数据。

• 用户可通过 @tdd-guide 调用此技能，并输入如分析覆盖率或针对特定模块生成测试案例等指令。

• 输出内容针对使用者的环境进行了优化，包括为 Claude Desktop 提供丰富的 Markdown 格式，或是为 CI/CD 自动化提供简洁的终端友好 JSON 输出。

• 本技能包含一套工具集，用于识别测试坏味道 (Test Smells)、分析测试不稳定性 (Flakiness)、侦测缓慢测试以及执行边界值分析。

• 最适合应用于需要高可靠性的环境，例如安全性敏感模块、复杂的 API 逻辑或大规模旧系统代码重构。