SuperAPI AI 工具集

verify-changes

测试与质量

查看项目

更新于 10-16 02:01

技能介绍

verify-changes 是一个面向开发流程的技能,目标是用执行结果而不是代码审查来证明改动有效。它把“验证”作为写代码或改代码之后的必要环节,避免仅凭看到函数存在、类型检查通过或主观假设就认定功能正确。

核心原则

该技能用三组对比说明立场:按检查验证(“我能看到函数存在,它应该能工作”)、按假设验证(“类型检查没问题,所以是对的”)都是不可靠的;只有按执行验证(“我运行了它,这是输出,它工作是因为有证据”)才被接受。

验证协议

协议分四步。第一步识别改动:哪些文件被修改、现在预期行为有何不同、最初的缺陷或需求是什么。第二步确定验证方法,技能给出变更类型与验证方式的对应关系:缺陷修复要复现原始缺陷场景并确认不再出现;新功能要运行功能并确认预期输出;重构要运行既有测试确认没有破坏;API 变更要调用端点确认响应结构;UI 变更要渲染组件确认视觉输出;配置变更要加载配置确认取值生效;构建/基础设施要运行构建命令确认成功。第三步执行验证,技能提供命令示例,包括 Node.js 项目的 npm run build、npm run test、npm run dev,针对特定文件的 node -e 加载模块,针对 API 端点的 curl 调用,以及脚本的 python script.py --test。第四步报告证据,输出验证报告,涵盖改动内容、验证方式、证据(构建、测试、运行时、边界情况)和尚未验证的部分。

按项目类型的检查清单

针对 Web 应用,检查 npm run build 无错误、npm run lint 无错误、npm run test 全部通过、开发服务器成功启动、改动页面正确渲染、浏览器无控制台错误。针对 API/后端,检查服务器无错误启动、改动端点正确响应、错误情况返回合适状态码、数据库查询成功执行。针对 CLI/脚本,检查脚本无错误运行、预期输出与实际输出一致、错误处理有效(坏输入测试)、帮助/用法文本正确。

反模式

技能列出需要避免的做法及其修复:说“应该能工作”缺乏证据,应运行并展示输出;只检查顺利路径,缺陷会藏在边界情况,应同时测试错误路径;只验证编译,编译通过不等于正确,应测试运行时行为;跳过“琐碎”改动的验证,琐碎改动会造成真实缺陷,应验证一切。

与其他技能的配合

技能给出使用某技能后应如何验证的对应关系:frontend-design 产生 UI 改动后,在浏览器渲染并检查控制台;backend-specialist 产生 API 改动后,用 curl 调用端点并检查响应;database-design 产生模式变更后,运行迁移并查询数据;testing-patterns 新增测试后,运行测试套件并检查覆盖率。

适用场景

该技能适用于任何写完或修改代码之后需要确认改动真的生效的场合,尤其适合需要向他人或流水线提交可验证证据的开发流程。具体支持的命令示例、项目类型清单和配合方式均来自技能资料本身;除资料明确内容外,该技能的收费、价格、平台覆盖范围或实际效果暂未提供。