SuperAPI AI 工具集

tdd-workflow

测试与质量

查看项目

更新于 10-15 21:13

技能介绍

用途:在使用 AI 编码助手开发功能、修复缺陷或重构时,强制按 TDD 流程推进,防止跳过测试直接写实现。\n\n主要能力:分为三个阶段。Red 阶段创建或定位测试文件,路径为 tests/ 目录,命名惯例为 test_<feature>.py,用例命名为 test_<feature><situation><expected_result>,运行 uv run pytest tests/test_<feature>.py -v 确认失败,并需用户审批后才能继续。Green 阶段只写让测试通过的最小实现,避免过度设计,再次运行测试,并执行 uv run ruff check --fix . && uv run ruff format . && uv run mypy .。Refactor 阶段消除重复、提升可读性,最后运行 uv run pytest 全量回归。\n\n使用方式与约束:执行规则要求测试文件不存在时先创建测试再实现;测试未失败时需说明“不会失败的测试没有意义”;测试通过后建议进入重构。质量门禁要求所有测试通过、覆盖率达标、静态分析无错误。流程中会逐阶段标记 Red、Green、Refactor 并报告测试结果。\n\n适用场景:新功能实现、Bug 修复、代码重构等需要测试驱动开发的工程任务。\n\n限制:资料未提供具体覆盖率阈值、支持的编程语言范围说明,也未提供除示例映射外的其他文件映射规则;示例命令基于 uv、pytest、ruff、mypy 工具链。