SuperAPI AI 工具集

testing

测试与质量

查看项目

更新于 10-16 09:27

技能介绍

用途:在修改行为、编写测试或评审测试质量时,为代理提供仓库感知的 TDD 流程、可观测测试设计和适用的质量检查规则。

主要能力:支持 RED→GREEN→REFACTOR 的 TDD 流程;要求测试观察可观测行为而非内部实现细节;按需选择最小充分层级(单元/本地、集成、E2E);提供失败归因与修复指引;发现并运行仓库已有的检查。

语言特定参考:仅当仓库使用某语言且该参考影响当前测试或检查时才阅读。TypeScript/Vitest 参考见 references/typescript.md。仓库命令与既有约定优先于通用示例。

TDD 流程:RED 阶段编写或选择能观察所需行为的测试,运行并确认当前实现不满足新预期;若测试已通过,需检查是否已满足、是否观察了错误边界或实现工作是否在别处。GREEN 阶段做最小改动使聚焦证明通过,保持现有契约与非目标。REFACTOR 阶段仅在当前改动提供重构必要证据时改进结构,并保持聚焦证明通过。VERIFY 阶段运行聚焦证明与仓库适用的既有检查,完成前修复范围内回归。

TDD 例外:仅文档变更、无可执行行为的纯配置、一次性验证、无变更结论不要求 TDD。紧急修复后应补充测试以保护复现的失败不复发。

测试边界:测试公开或共享契约、输出/错误/持久化效果、必需的外部调用或副作用、跨组件或进程的具名交互;除非内部实现细节本身是已接受的契约,否则不进入测试。

测试设计:使用清晰的准备、动作与可观测预期;测试数据最小化且不含密钥;偏好确定性行为与独立状态;在单元边界模拟外部 I/O,当内部协作者的交互即被测行为时使用真实协作者;新增测试通道前优先复用或扩展现有代表性覆盖。

失败处理:当测试断言无效需求、依赖实现细节或不再观察其声明行为时改测试;当测试代表当前需求或保留契约时改实现;仅在需要新需求或变更已批准边界时返回用户。

质量检查:从仓库脚本、CI 配置、语言工具与贡献者文档发现检查;运行受改动影响的检查,最终完成前运行更广泛的必需检查。若仓库缺少相关检查,报告验证缺口;仅在已批准结果或已证明的复发性失败证明成本合理时新增工具。

完成检查:聚焦证明观察到预期行为;适用的既有检查通过;报告不可用的验证与残余风险。

限制:具体命令、配置与仓库约定依赖目标项目,本技能未提供固定命令;除 TypeScript/Vitest 外,其他语言参考暂未提供。