SuperAPI AI 工具集

qa-checklist

通用与其它

查看项目

更新于 10-16 03:41

技能介绍

QA Checklist 是一个在每次合并或部署前执行的正式质量保证检查技能,按 6 个阶段进行验证,帮助在提交和发布前拦截问题。

触发方式:在生产代码变更后的 git commit、部署命令(如 vercel --prod、npm run deploy 等)或 /qa 命令时自动激活;触发词包括“merge”“deploy”“release”“production”。可通过项目的 CLAUDE.md 或设置配置 no_touch_zones(如 src/auth/、src/core/、config/production.*)、required_region 和 deploy_timeout。

主要阶段:1. 构建验证(阻塞):运行 npx tsc --noEmit 和 npm run build,失败即停止;2. 测试套件(阻塞):运行 npm run test,可选 npm run test:e2e;3. 禁止修改区检查(阻塞):用 git diff 检测受保护文件是否被改动;4. 区域/环境检查(部署时阻塞):部署前核对目标区域与环境(如 npx vercel inspect、aws configure get region、$NODE_ENV),部署后用 curl 检查健康检查是否返回 200;5. 安全审查(警告):检查代码中是否含密钥、新的 any 类型,并运行 npm audit --production;6. 生成 QA 报告,给出 APPROVED 或 REJECTED 结论及后续步骤。

使用流程:提交前运行阶段 1-3,生产部署前运行阶段 1-5,部署后执行阶段 4.2 验证;失败最多重试 3 次,之后升级给用户。可与 code-quality-gate、strict-typescript-mode、security-scan hook 配合使用。该技能最初为 fabrikIQ 开发,采用 MIT 许可。限制方面,部分检查为警告级而非阻断,E2E 测试为可选推荐,具体命令与配置需按项目实际情况调整。