用途
验证循环技能(Verification Loop Skill)是 Claude Code 会话的全方位验证系统,用于在完成功能开发或重大代码变更后、创建拉取请求(PR)之前、重构之后,以及希望确保通过质量门禁时,对项目进行系统性的质量验证。
主要能力
该技能按六个阶段执行验证:
- 阶段 1:构建验证。运行 npm run build 或 pnpm build,若构建失败需停止并修复后方可继续。
- 阶段 2:类型检查。TypeScript 项目使用 npx tsc --noEmit,Python 项目使用 pyright .,报告所有类型错误,继续前修复关键错误。
- 阶段 3:Lint 检查。JavaScript/TypeScript 使用 npm run lint,Python 使用 ruff check .。
- 阶段 4:测试套件。运行带覆盖率的测试(npm run test -- --coverage),检查覆盖率阈值,目标最低 80%,并报告测试总数、通过数、失败数与覆盖率。
- 阶段 5:安全扫描。使用 grep 检查密钥/机密(如 sk-、api_key)以及 console.log。
- 阶段 6:变更审查(Diff Review)。通过 git diff --stat、git diff HEAD~1 --name-only 查看变更内容,审查每个变更文件中的非预期变更、缺失的错误处理、潜在的边缘情况。
使用方式
运行所有阶段后,技能生成统一的验证报告,格式如下:
验证报告(VERIFICATION REPORT)
==================
构建 (Build): [通过/失败]
类型 (Types): [通过/失败] (X 个错误)
Lint: [通过/失败] (X 个警告)
测试 (Tests): [通过/失败] (X/Y 通过, Z% 覆盖率)
安全 (Security): [通过/失败] (X 个问题)
变更 (Diff): [X 个文件已变更]
总体评价: [已就绪/未就绪] 提交 PR
待修复问题:
1. ...
2. ...
对于较长的会话,可启用持续模式:每 15 分钟或在重大更改后运行验证,并设定心智检查点——完成每个函数后、完成一个组件后、在进入下一个任务前,运行 /verify。
该技能是 PostToolUse 钩子(Hooks)的补充:钩子能立即捕捉问题,此技能则提供更全方位的审查。
适用场景
适用于 Claude Code 会话中的代码质量把关环节,例如功能开发完成、重大代码变更、创建 PR 前、重构后,以及需要确保通过质量门禁时。支持 JavaScript/TypeScript 与 Python 项目的相关命令。
限制
资料未提供关于平台依赖、收费、价格、效果保证或更多平台支持的信息。