Claude Code Verification Loop Skill 是一套为 AI 辅助编程场景设计的综合验证循环系统，聚合了构建检查、类型检查、Lint、测试覆盖率、安全扫描和变更审查六大环节。它解决了 AI 生成代码易遗漏质量门槛、人工 review 盲区和协作不一致等问题，适用于 PR 前、重构后、功能开发完成等关键节点，帮助开发者用结构化流程系统性把控代码质量，是 Claude Code 等 AI 编程助手生产环境中的核心质量保障工具。

Everything Claude Code Verification Loop Skill：Claude Code 会话的综合端到端验证循环系统

在 AI 编程助手（如 Claude Code、Codex、Cursor 等）辅助下进行开发时，代码的生成、修改与合并速度大幅提升，但也带来了质量门槛把控难、人工 review 盲区多、协作流程不一致等新挑战。Verification Loop Skill 正是为此而生——它将构建、类型检查、Lint、测试、覆盖率、安全扫描和变更审查等环节系统性整合，形成一套端到端的自动化验证循环，帮助你在每次重要变更后全面把关代码质量。

Verification Loop Skill 解决了什么问题？

在没有 Verification Loop Skill 的情况下，AI 生成或修改代码后，开发者往往需要手动、零散地执行构建、Lint、测试、安全检查等流程，容易出现以下痛点：

• 流程不一致：不同人、不同场景下，验证步骤随意跳过或遗漏，导致质量门槛参差不齐。
• 人工 review 盲区：AI 生成的代码可能隐藏类型错误、低覆盖率、敏感信息泄漏等问题，人工难以全量发现。
• 协作割裂：PR 前缺乏统一的“Ready for Review”标准，团队协作效率低下。
• 难以自动化：无法一键输出结构化的验证报告，难以集成到自动化流程或与其他 Agent 协同。

而 Verification Loop Skill 正是把这些零散、易遗漏的环节标准化、自动化，并输出清晰的结构化报告，让每次变更都可追溯、可量化、可持续改进。

触发时机与典型场景

你应该在以下场景主动触发 Verification Loop Skill：

• 完成新功能开发或重要代码变更后
• 准备创建 PR 前
• 重构、批量修改代码后
• 希望确保所有质量门槛已通过时
• 长时间会话中，每 15 分钟或每个阶段性节点后

它既可手动触发（如 /verify），也可与自动化 Hook 配合，在关键节点自动执行。

Verification Loop Skill 使用流程（Step by Step）

下面以典型的 TypeScript/JavaScript 项目为例，详细介绍 Verification Loop Skill 的六大环节：

1. 构建验证（Build Verification）

首先，确保项目能够成功构建，捕获最近的构建日志：

npm run build 2>&1 | tail -20
# 或
pnpm build 2>&1 | tail -20

• 目的：发现语法、依赖、配置等基础错误。
• 注意：构建失败时，流程立即中止，优先修复。

2. 类型检查（Type Check）

对静态类型项目（如 TypeScript、Python）进行类型检查：

# TypeScript
npx tsc --noEmit 2>&1 | head -30

# Python
pyright . 2>&1 | head -30

• 目的：捕获类型不匹配、未声明变量等静态错误。
• 建议：关键类型错误必须修复，警告可后续跟进。

3. Lint 检查（Lint Check）

执行 Lint，发现代码风格、潜在 Bug 和一致性问题：

# JavaScript/TypeScript
npm run lint 2>&1 | head -30

# Python
ruff check . 2>&1 | head -30

• 输出：统计警告和错误数量，严重问题需优先修复。

4. 测试与覆盖率（Test Suite）

运行测试用例，并检查覆盖率是否达标（推荐 80% 以上）：

npm run test -- --coverage 2>&1 | tail -50

• 输出：总测试数、通过/失败数、覆盖率百分比。
• 门槛：覆盖率低于目标需补充测试。

5. 安全扫描（Security Scan）

自动检查敏感信息、调试语句等安全隐患：

# 检查密钥
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

# 检查 console.log
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

• 输出：发现的敏感信息、调试代码等问题列表。

6. 变更审查（Diff Review）

对本次提交的变更进行人工或 AI 审查：

git diff --stat
git diff HEAD~1 --name-only

• 关注点：是否有无意变更、遗漏错误处理、边界条件未覆盖等。

7. 输出结构化验证报告

所有环节完成后，自动生成如下结构化报告，便于团队 review 和后续自动化集成：

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. ...

示例输出：

VERIFICATION REPORT
==================

Build:     PASS
Types:     FAIL (2 errors)
Lint:      PASS (1 warning)
Tests:     PASS (35/35 passed, 85% coverage)
Security:  PASS (0 issues)
Diff:      5 files changed

Overall:   NOT READY for PR

Issues to Fix:
1. Type error in src/api/user.ts: 'User' is not assignable to 'AdminUser'
2. Lint warning in src/components/Header.tsx: 'no-unused-vars'

持续验证模式（Continuous Mode）

对于长时间的 AI 编程会话，建议每 15 分钟或每完成一个关键功能/组件后，主动触发 Verification Loop Skill，设置“心智检查点”，确保问题及时暴露，避免后期集中爆发。可通过 /verify 命令一键执行。

与 Agent、Skill、Hook 的协作关系

• 常见配套 Agent：如 Code Reviewer Agent、Build Error Resolver、Security Reviewer Agent 等，可联动自动修复发现的问题。
• 与 Hooks 协作：PostToolUse Hook 能在每次 AI 自动化操作后即时捕获异常，但 Verification Loop Skill 提供的是全链路、结构化的综合验证，两者互补，适合串联形成完整的质量保障体系。详细集成方式可参考 Everything Claude Code Hooks 实战。
• 与其他 Skill 配合：如 AI Regression Testing 可用于回归盲点检测，Skill Comply Skill 用于验证团队规则实际遵守率。

实践建议与注意事项

• 不要跳过任何环节，特别是类型检查和安全扫描，即使 AI 生成的代码看似“无误”。
• 输出报告应结构化，便于团队协作、自动化集成和历史追溯。
• 持续集成推荐集成 Verification Loop Skill，可作为 PR 阶段的必经门槛。
• 覆盖多语言项目时，需根据实际技术栈调整各环节命令（如 Python、Go、Java 等）。

更多高级用法与自动化集成方式，可参考 Claude Code 高级技巧：Token 优化、记忆持久化、并行化与验证循环。

---

FAQ

Q: Verification Loop Skill 和普通 Lint/Test 有什么区别？
A: 它将构建、类型、Lint、测试、安全、Diff 六大环节串联成一体，输出结构化报告，适合 AI 编程助手场景下的全链路质量门控，而不仅仅是单一 Lint 或 Test。

Q: 这个 Skill 适用于哪些技术栈？
A: 默认覆盖 TypeScript/JavaScript/Python，其他语言可根据实际项目自定义命令，保持验证流程一致性。

Q: 如何与团队协作或自动化集成？
A: 可将 Verification Loop Skill 输出的报告集成到 CI/CD、PR 阶段或与其他 Agent/Hook 联动，实现自动化质量门槛和协同 review。

---