用途
tdd-workflow 是一个面向 AI 编程助手的技能,用于在以下场景强制采用测试驱动开发(TDD):编写新功能、修复缺陷、重构现有代码、新增 API 端点、创建新组件。其核心原则是“测试先于代码”,先写测试再实现代码使测试通过。
主要能力
- 覆盖要求:最低 80% 覆盖率,涵盖单元、集成与 E2E 三层;要求覆盖所有边界情况、错误场景和边界条件。
- 测试类型划分:单元测试针对函数、工具、组件逻辑、纯函数与辅助工具;集成测试针对 API 端点、数据库操作、服务交互、外部 API 调用;E2E 测试(Playwright)针对关键用户流程、完整工作流、浏览器自动化与 UI 交互。
- 测试运行器检测:要求不假定
npm test,先运行包管理器探测脚本node scripts/setup-package-manager.js --detect,按 CLAUDE_PACKAGE_MANAGER、.claude/package-manager.json、package.json的 packageManager 字段、锁文件、全局配置的顺序解析 npm / pnpm / yarn / bun;并区分包管理器与测试运行器,依据scripts.test与测试文件判断应使用 Jest、Vitest 还是 Bun 原生bun test。技能给出 npm、pnpm、yarn、Bun(脚本运行 jest/vitest)与 Bun 原生测试四种情况下<test>、<test-watch>、<coverage>、<lint>的命令对照表。
使用方式
技能规定的 TDD 流程步骤:
- 步骤 0:检测测试运行器(见上)。
- 步骤 1:以“作为某角色,我想要某操作,以便获得某收益”的形式编写用户旅程。
- 步骤 2:为每个用户旅程生成完整测试用例(正常路径、空查询、降级回退、排序逻辑等)。
- 步骤 3:运行测试,此时应失败(RED)。
- 步骤 4:编写最小实现使测试通过。
- 步骤 5:再次运行测试,此时应通过(GREEN)。
- 步骤 6:在测试保持通过的前提下重构,消除重复、改进命名、优化性能、提升可读性。
- 步骤 7:运行覆盖率命令,确认达到 80% 以上。
技能还提供各类测试写法示例:Jest/Vitest 组件单元测试、bun:test 原生测试(从 bun:test 导入 describe/it/expect/mock,使用 bun test、bun test --watch、bun test --coverage,用 mock.module(...) 替代 jest.mock(...),在 bunfig.toml 的 [test] 下配置覆盖率阈值)、基于 Next.js 的 API 集成测试、Playwright E2E 测试;以及测试文件与源码同目录的组织方式(如 Button.test.tsx、route.test.ts、e2e/markets.spec.ts),Supabase、Redis、OpenAI 等外部服务的 Mock 示例,覆盖率阈值配置示例,和应避免的常见错误(测试实现细节、脆弱的 CSS 选择器、测试间缺乏隔离)。
适用场景
适用于采用 JavaScript/TypeScript 技术栈、需要 AI 助手在编码过程中严格执行 TDD 与覆盖率要求的项目开发,包括组件开发、API 端点实现、缺陷修复与重构,以及持续测试集成(开发时 watch 模式、提交前钩子运行测试与 lint、CI 中运行覆盖率并上传 Codecov)。
限制
该技能未说明对非 JavaScript/TypeScript 语言或项目的支持情况;示例以 Jest、Vitest、Bun、Playwright、Next.js、Supabase、Redis、OpenAI 为背景,其他框架的适配方式暂未提供;其依赖的 scripts/setup-package-manager.js 探测脚本随 ECC 提供,具体获取与安装方式暂未提供;收费、价格与平台信息暂未提供。