tdd-workflow

用途：在编写新功能、修复缺陷、重构代码、新增 API 端点或创建新组件时，强制按测试驱动开发（TDD）原则推进，以测试先行保障质量。\n\n主要能力：要求测试先于代码；覆盖率最低 80%，涵盖单元测试（函数、工具、组件逻辑、纯函数）、集成测试（API 端点、数据库操作、服务交互、外部 API 调用）与 E2E 测试（Playwright 驱动关键用户流程、浏览器自动化与 UI 交互）；要求覆盖边界条件、错误场景与降级行为。\n\n使用方式：按 7 步执行——1) 写用户旅程（As a [role], I want to [action], so that [benefit]）；2) 为每条旅程生成测试用例；3) 运行测试并确认失败，如 npm test；4) 写最小实现使测试通过；5) 再次运行测试；6) 在测试保持通过的前提下重构；7) 运行 npm run test:coverage 核对覆盖率。开发中可用 npm test -- --watch，提交前运行 npm test && npm run lint，CI 中可执行 npm test -- --coverage 并上传覆盖率报告。可用 jest.mock 模拟 Supabase、Redis、OpenAI 等外部依赖。\n\n适用场景：需要高可靠性的功能开发与重构、涉及 API 与数据库交互的模块、以及需要 E2E 验证的关键用户流程。\n\n限制：资料未提供具体安装命令、价格与平台支持范围，暂未提供；示例基于 Jest/Vitest、Testing Library、Next.js 与 Playwright，实际配置需自行确认。