SuperAPI AI 工具集

verification-loop

测试与质量

查看项目

更新于 11-10 16:22

技能介绍

用途

Verification Loop 是一个用于 Claude Code 会话的综合验证系统,核心目的是在宣称某项工作完成之前,系统性地验证代码改动是否满足质量门禁。

主要能力

该技能将验证分为六个阶段:

  1. 构建验证:运行 npm run build 或 pnpm build,构建失败则停止并先修复。
  2. 类型检查:TypeScript 项目使用 npx tsc --noEmit,Python 项目使用 pyright .,报告所有类型错误,优先修复严重错误。
  3. Lint 检查:JavaScript/TypeScript 使用 npm run lint,Python 使用 ruff check .。
  4. 测试套件:带覆盖率运行测试,目标最低覆盖率为 80%,并报告总数、通过数、失败数和覆盖率。
  5. 安全扫描:用 grep 检查密钥(如 sk-、api_key)以及 console.log 残留。
  6. 差异审查:通过 git diff --stat 和 git diff HEAD~1 --name-only 查看改动文件,逐一检查非预期变更、缺失的错误处理和潜在边界情况。

使用方式

在完成功能或重大代码变更后、创建 PR 前、重构后,或希望确保质量门禁通过时调用该技能。长会话中建议每 15 分钟或在重大变更后运行一次验证,也可在完成每个函数、每个组件后以及进入下一任务前设置检查点,通过 /verify 运行。该技能可与 PostToolUse hooks 配合:hooks 即时捕捉问题,该技能提供更深入的全面审查。

目标环境验收

当请求的结果需要部署或目标环境验证时,需将目标验收与本地检查分开报告,记录已知环境和已安装版本、证据,以及下一步允许的检查或确切的访问依赖。本地检查通过、审查、合并或发布均不构成目标环境验收。对已执行的目标检查报告 VERIFIED 或 FAILED 及其证据;未经授权不得访问生产环境或进行外部更改;仅本地任务则将目标验收标记为不适用。

输出格式

运行所有阶段后生成验证报告,包含构建、类型、Lint、测试、安全、差异各项的 PASS/FAIL 状态,整体是否 READY 适合 PR,目标环境验收状态及下一步允许的操作,以及待修复问题列表。

适用场景

适用于 Claude Code 会话中完成功能开发、重大代码变更、重构后,以及提交 PR 前的质量把关,帮助开发者在宣称完成前发现构建、类型、测试、安全和变更范围方面的问题。

限制

该技能主要面向 JavaScript/TypeScript 和 Python 项目,具体命令以项目实际配置为准;官方资料未提供关于收费、平台支持范围或与其他工具集成的更多细节。