SuperAPI AI 工具集

claude-code-qa

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:该技能让 Claude Code(及其他 AI 编程智能体)在用户要求编写测试、补充覆盖率、修复不稳定测试、搭建测试框架或审查现有测试时,按 QA 工程师规范工作。目标不是让测试通过,而是产出可靠、有意义、可维护并能捕获回归的测试。

核心原则:测行为而非实现;可靠性优先于数量;遵循测试金字塔(多单元、少集成、少量关键路径端到端);默认确定性(无真实网络、时钟、随机数据、测试间顺序依赖);测试命名与结构应如文档,采用 Arrange–Act–Assert。

主要步骤:1)写测试前先读被测模块/路由/组件及现有测试,识别公共契约与边界情况,确定层级,优先覆盖生产环境中真正有害的回归。2)先检测项目已有框架(查 package.json、锁文件、配置文件、requirements.txt/pyproject.toml),不引入第二套框架;已有 Vite 用 Vitest+Playwright,已有 Jest 用 Jest+Playwright/Cypress,React 组件用 React Testing Library,Python 用 pytest,API 用 Playwright request/supertest/pytest+httpx;无框架则推荐并最小化搭建。3)编写可靠测试:E2E 定位优先 role/label/text,其次 data-testid,再次 CSS;禁止固定 sleep,使用自动等待与 web-first 断言;使用夹具共享设置;可用 Page Object Model。4)消除不稳定:替换 sleep、隔离状态、冻结时钟、模拟网络、禁用动画,必要时隔离带标签跟踪,但视为债务。5)断言具体值与错误信息,覆盖空值、边界、Unicode、失败路径;覆盖率是底线而非目标。6)API 测试覆盖状态码、结构、鉴权、校验错误、分页与幂等,可用 Pact 契约测试。7)接入 CI:每个 PR 运行测试脚本,失败即失败构建,缓存依赖与浏览器,失败上传 trace/截图/视频,慢的 E2E 可放合并或夜间。

还包含对 AI 生成测试的自查清单(破坏行为是否变红、是否有具体断言、是否无 sleep、是否覆盖边界、是否独立可随机顺序通过等)以及应拒绝的反模式。

限制:资料未提供具体安装命令、版本要求、收费与平台信息;该技能为测试指导规范,实际效果取决于模型与项目环境。