name: verification-loop description: 此技能应在用户要求“验证代码”、“运行验证”、“检查质量”、“验证更改”或创建PR之前使用。提供全面的验证,包括构建、类型检查、代码质量检查、测试、安全扫描和差异审查。 version: 1.0.0
验证循环技能
Claude Code 会话的全面验证系统。
何时使用
调用此技能:
- 在完成一个功能或重大代码更改后
- 在创建PR之前
- 当您想确保质量门通过时
- 重构后
验证阶段
阶段 1: 构建验证
# Python项目 (uv)
uv build 2>&1 | tail -20
# 或
python -m build 2>&1 | tail -20
# Node.js项目
npm run build 2>&1 | tail -20
# 或
pnpm build 2>&1 | tail -20
如果构建失败,停止并在继续之前修复。
阶段 2: 类型检查
# TypeScript项目
npx tsc --noEmit 2>&1 | head -30
# Python项目
pyright . 2>&1 | head -30
报告所有类型错误。在继续之前修复关键错误。
阶段 3: 代码质量检查
# JavaScript/TypeScript
npm run lint 2>&1 | head -30
# Python
ruff check . 2>&1 | head -30
阶段 4: 测试套件
# Python项目
pytest --cov=src --cov-report=term-missing 2>&1 | tail -50
# Node.js项目
npm run test -- --coverage 2>&1 | tail -50
报告:
- 总测试数: X
- 通过: X
- 失败: X
- 覆盖率: X%
阶段 5: 安全扫描
# Python: 检查秘密
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: 检查秘密
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
# 检查调试语句
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: 差异审查
# 显示更改内容
git diff --stat
git diff HEAD~1 --name-only
审查每个更改的文件:
- 无意更改
- 缺少错误处理
- 潜在边界情况
输出格式
运行所有阶段后,生成验证报告:
验证报告
==================
构建: [通过/失败]
类型: [通过/失败] (X 个错误)
代码质量: [通过/失败] (X 个警告)
测试: [通过/失败] (X/Y 通过, Z% 覆盖率)
安全: [通过/失败] (X 个问题)
差异: [X 个文件更改]
总体: [准备/未准备] 好用于PR
需要修复的问题:
1. ...
2. ...
持续模式
对于长会话,每15分钟或重大更改后运行验证:
设置心理检查点:
- 完成每个函数后
- 完成一个组件后
- 移动到下一个任务前
运行: /verify
与钩子集成
此技能补充PostToolUse钩子但提供更深层次的验证。 钩子立即捕获问题;此技能提供全面审查。