用途
Verification Loop 是一个用于 Claude Code 会话的综合验证系统,核心目的是在宣称某项工作完成之前,系统性地验证代码改动是否满足质量门禁。
主要能力
该技能将验证分为六个阶段:
- 构建验证:运行
npm run build或pnpm build,构建失败则停止并先修复。 - 类型检查:TypeScript 项目使用
npx tsc --noEmit,Python 项目使用pyright .,报告所有类型错误,优先修复严重错误。 - Lint 检查:JavaScript/TypeScript 使用
npm run lint,Python 使用ruff check .。 - 测试套件:带覆盖率运行测试,目标最低覆盖率为 80%,并报告总数、通过数、失败数和覆盖率。
- 安全扫描:用 grep 检查密钥(如
sk-、api_key)以及console.log残留。 - 差异审查:通过
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 项目,具体命令以项目实际配置为准;官方资料未提供关于收费、平台支持范围或与其他工具集成的更多细节。