SuperAPI AI 工具集

write-testing

测试与质量

查看项目

更新于 10-15 22:41

技能介绍

用途:write-testing 用于把“编写测试”本身当作交付任务,在基础 implement-task 规则之上补充测试纪律。它适用于独立交付的测试;随功能或修复一起写的测试属于对应指南,已存在的不稳定测试属于 fix-flaky-test。

主要能力与规则:写测试前先以行为命名覆盖缺口,说明哪个模块、哪种行为、调用方依赖什么条件,而不是看行覆盖率。测试只针对公开接口断言,不碰私有方法或模块私有状态,避免行为保持的重构导致假失败。每个测试只保留一个失败原因,捆绑多个断言会让人不知道哪条行为坏了。每个测试写完后要翻转断言或注释掉被测生产路径,确认它会失败,恢复后通过,并粘贴一次代表性的失败到通过过程。若测试用于验证某个具名验收标准,需证明它在该要求被违反时失败,而非相邻条件;无法构造这样的测试应作为阻塞问题退回规格作者。高风险要求或不变量应使用基于属性、蜕变或变异测试等更强检查,并记录其覆盖内容。测试必须确定性,不得依赖顺序、时序、共享可变状态、未沙箱网络或未播种随机。不得为方便写测试而改生产代码,除非任务范围允许;难测代码和测试暴露的缺陷应记录为发现项,不在原地修复。覆盖率只当地图不当分数,按项目既有约定放置测试,运行整套测试并粘贴真实输出,命令从 AGENTS.md 解析,未定义时询问,且不得对自己的工作出具评审结果。

使用方式:按 references/task-template.md 的工作笔记脚手架记录覆盖缺口、按行为组织的测试用例表、放置表、翻转证据和自检。完成前自检:每个新测试都翻转验证过、最终编辑后跑过整套测试、每个测试只针对公开接口且只有一个失败原因、验收标准绑定测试在违反时失败、无生产代码越界改动、无可能造成 CI 不稳定的依赖、未对自己的工作出具评审结果。

限制:这些是评审包检查的约定,编辑时没有强制机制;资料未提供具体安装命令、平台支持或收费信息。