用途
Verification Loop 是一个用于 Claude Code 会话的综合验证系统。它适用于以下场景：
- 在完成一个功能或重要代码改动之后；
- 在创建 PR 之前；
- 当你希望确保质量门禁通过时；
- 在重构之后。
主要能力
该技能按六个阶段执行验证，并强调应根据当前项目自适应选择命令，而不是盲目运行示例中的所有命令。当仓库与默认示例不匹配时，应使用 references/STACK-DETECTION.md 中适合当前技术栈的命令。
阶段 1：构建验证
# Python projects (uv)
uv build 2>&1 | tail -20
# OR
python -m build 2>&1 | tail -20
# Node.js projects
npm run build 2>&1 | tail -20
# OR
pnpm build 2>&1 | tail -20
如果构建失败，应停止并修复后再继续。
阶段 2：类型检查
# TypeScript projects
npx tsc --noEmit 2>&1 | head -30
# Python projects
pyright . 2>&1 | head -30
报告所有类型错误。继续之前修复关键问题。
阶段 3：Lint 检查
# JavaScript/TypeScript
npm run lint 2>&1 | head -30
# Python
ruff check . 2>&1 | head -30
阶段 4：测试套件
# Python projects
pytest --cov=src --cov-report=term-missing 2>&1 | tail -50
# Node.js projects
npm run test -- --coverage 2>&1 | tail -50
需要报告：总测试数、通过数、失败数、覆盖率。
阶段 5：安全扫描
# Python: Check for secrets
grep -rn "sk-" --include="*.py" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.py" . 2>/dev/null | head -10
pip-audit
# Node.js: Check for secrets
grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
# Check for debug statements
grep -rn "print(" --include="*.py" src/ 2>/dev/null | head -10
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10
阶段 6：Diff 审查
# Show what changed
git diff --stat
git diff HEAD~1 --name-only
对每个变更文件进行审查，关注：意外改动、缺失的错误处理、潜在边界情况。
使用方式
运行全部阶段后，产出验证报告，格式如下：
VERIFICATION REPORT
==================
Build: [PASS/FAIL]
Types: [PASS/FAIL] (X errors)
Lint: [PASS/FAIL] (X warnings)
Tests: [PASS/FAIL] (X/Y passed, Z% coverage)
Security: [PASS/FAIL] (X issues)
Diff: [X files changed]
Overall: [READY/NOT READY] for PR
Issues to Fix:
1. ...
2. ...
连续模式
对于长时间会话，每 15 分钟或在重大改动后运行一次验证：
设置心理检查点：
- 每完成一个函数后；
- 每完成一个组件后；
- 进入下一个任务之前。
运行：/verify
与钩子集成
该技能与 PostToolUse 钩子互补，但提供更深入的验证。钩子会立即捕获问题；该技能提供全面审查。
参考文件
按需加载，仅加载所需内容：
references/STACK-DETECTION.md— 如何为当前仓库选择合适的验证命令集；references/REPORT-TEMPLATE.md— 最终验证输出的报告结构；examples/example-verification-report.md— 示例最终报告。
适用场景
适用于 Claude Code 会话中需要在功能完成、代码改动、重构、提交 PR 前进行质量检查的开发流程，尤其适合需要对构建、类型、Lint、测试、安全与差异进行系统性审查的项目。
限制
具体支持的项目类型与命令以资料中列出的 Python 与 Node.js/TypeScript 示例为准。其他技术栈需参考 references/STACK-DETECTION.md。收费、价格、平台等信息暂未提供。