SuperAPI AI 工具集

ac-tdd-runner

测试与质量

查看项目

更新于 10-15 10:00

技能介绍

AC TDD Runner 用于自动化功能实现中的测试驱动开发(TDD)循环。其核心目的是强制执行 RED-GREEN-REFACTOR 周期,确保所有功能都采用测试优先的方法实现,以提升代码质量和可维护性。

主要能力:

  • RED 阶段:根据功能的测试用例生成测试文件,编写结构正确的测试函数,运行测试以验证它们确实失败。如果测试意外通过,则添加更具体的断言。
  • GREEN 阶段:分析失败的测试,编写最小实现代码,运行测试。如果测试失败,则迭代修改实现,直到所有测试通过。
  • REFACTOR 阶段:识别代码坏味道,应用重构模式,每次更改后运行测试。如果测试失败则回退,持续进行直到代码整洁。

使用方式: 通过 Python 导入 TDDRunner 类并调用相关方法。示例: from scripts.tdd_runner import TDDRunner runner = TDDRunner(project_dir) result = await runner.run_cycle(feature)

也可以单独调用各阶段: red_result = await runner.red_phase(feature) green_result = await runner.green_phase(feature) refactor_result = await runner.refactor_phase(feature)

周期结果以 JSON 格式返回,包含 feature_id、cycle_complete、各阶段详情(如 tests_created、all_tests_fail、iterations、all_tests_pass、changes_made、tests_still_pass)、coverage 和 duration_ms。

配置项: 支持通过配置对象设置 max_green_iterations(默认 10)、coverage_threshold(默认 80)、refactoring_patterns(如 extract_method、rename_for_clarity、remove_duplication)以及 test_framework(如 pytest)。

集成: RED 阶段使用 ac-test-generator;GREEN 验证使用 ac-criteria-validator;结果报告给 ac-task-executor。完整实现参见 scripts/tdd_runner.py。

适用场景: 适用于需要严格遵循 TDD 流程的软件开发项目,尤其是希望自动化测试生成、实现迭代和重构步骤的团队。

限制: 资料中未提供关于收费、价格、平台支持范围或具体效果保证的信息。