SuperAPI AI 工具集

tdd

测试与质量

查看项目

更新于 10-16 03:11

技能介绍

用途:该技能是测试驱动开发红→绿循环的参考规范,目标是让循环产出值得保留的测试,涵盖好测试的定义、测试放置位置、反模式与循环规则。探索代码库时应阅读 CONTEXT.md(若存在),使测试名与接口词汇匹配项目领域语言,并遵守相关 ADR。

主要能力:好测试通过公共接口验证行为而非实现细节,读起来像规格说明,且能在重构后存活。测试放在接缝(seam)即公共边界处,只测试事先商定的接缝;写测试前先写下待测接缝并与用户确认。反模式包括:实现耦合(mock 内部协作者、测试私有方法或通过旁路验证)、同义反复(断言以与代码相同方式重算期望值)、水平切片(先写全部测试再写实现)。

使用方式:工作流分四步。规划阶段塑造模块与接口、列出待测行为,若切片渲染 UI 则走 frontend-verification.md 的视觉循环规则与 agent-browser 对照设计源的门禁。示踪弹阶段写一个测试确认一件事:RED 写测试失败,GREEN 写最小代码通过。增量循环对每个剩余行为重复 RED/GREEN,规则为一次一个测试、只写够通过当前测试的代码、不预判未来测试、聚焦可观察行为。重构阶段在所有测试通过后提取重复、加深模块、应用 SOLID,每步后运行测试,绝不在 RED 状态重构。每循环检查清单包括测试描述行为、仅用公共接口、能存活内部重构、代码最小、无投机功能、提交遵循项目风格、非显然决策记为面包屑。非显然的实现选择按项目面包屑约定追加到 .scratch/<feature>/decisions.md,重大架构决策应写入 ADR。循环结束后下一步是 /prepare-for-review。

适用场景:需要以测试驱动方式开发功能,尤其是含前端 UI 切片并需对照 Figma 设计源做视觉验证的项目。

限制:资料未提供具体安装命令、平台支持、收费或价格信息;接口形状本身存疑时可参考 /codebase-design 技能获取模块、接口、深度、接缝、适配器等词汇。