Everything Claude Code 验证循环 / verify 命令全解:改完代码如何确认真的能跑
【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code
用 Claude Code 这类 AI 编程工具写代码,最大的困惑往往是:AI 说"完成了",可代码真的能跑吗?Everything Claude Code是一个面向 Claude Code 的生产级工具包(agents、commands、skills、rules、hooks 全家桶),其中的/verify 命令内置了一套标准化的验证循环(Verification Loop):改完代码后一条命令,就能从构建、类型、Lint 到测试逐项确认改动是否真的可用。本文带你看懂这套验证循环的全部玩法。
为什么 AI 写代码后必须"验证一下"
AI 生成代码速度快,但"写完"不等于"能跑":
- 改 A 文件可能悄悄弄坏 B 文件
- 测试可能通过,但类型检查一跑就露馅
- 代码里残留的
console.log、未提交的改动,都是上线前的隐患
commands/verify.md 把资深工程师的"提交前检查清单"固化成了 6 个阶段,让 AI 按固定顺序执行,而不是凭感觉说"应该没问题"。
验证循环的 6 个阶段:/verify 到底检查什么
/verify会严格按以下顺序执行,构建失败会直接停下,绝不带病往下跑:
| 阶段 | 检查内容 | 为什么重要 |
|---|---|---|
| 1️⃣ 构建检查 | 运行项目 build 命令 | 编译/打包都过不了,后面全白搭 |
| 2️⃣ 类型检查 | TypeScript 等类型检查器 | 逐个报告错误及其文件:行号 |
| 3️⃣ Lint 检查 | 代码风格与规则扫描 | 报告所有 warning 和 error |
| 4️⃣ 测试套件 | 运行全部测试 | 报告通过/失败数量 + 覆盖率百分比 |
| 5️⃣ console.log 审计 | 搜索源码中的调试日志 | 找出上线前该清理的残留 |
| 6️⃣ Git 状态 | 未提交的改动、上次提交后修改的文件 | 防止漏改文件被"悄悄提交" |
💡 顺序即优先级:从"能不能编译"到"细节是否干净",问题越早暴露,修复成本越低。
一条命令,输出可读的验证报告
验证完成后,/verify 不会甩给你一堆原始日志,而是生成一份结构化的精简报告:
VERIFICATION: [PASS/FAIL] Build: [OK/FAIL] Types: [OK/X errors] Lint: [OK/X issues] Tests: [X/Y passed, Z% coverage] Secrets: [OK/X found] Logs: [OK/X console.logs] Ready for PR: [YES/NO]最后一行Ready for PR就是最直接的结论。如果存在严重问题,报告还会逐条列出问题并附上修复建议,你可以直接把这份报告喂回给 AI 继续修。
4 种运行模式:按需选择检查深度
/verify 支持传参切换模式,覆盖不同场景:
| 用法 | 模式 | 适用场景 |
|---|---|---|
/verify | full(默认) | 全部 6 项检查,开 PR 前的标准动作 |
/verify quick | 只跑构建 + 类型检查 | 快速确认"没改坏",日常迭代最常用 |
/verify pre-commit | 提交相关检查 | git commit 之前的把关 |
/verify pre-pr | 全量检查 + 安全扫描 | 创建 Pull Request 前的最后防线 |
新手建议:先用quick养成"改完就验"的肌肉记忆,提 PR 前再跑一次pre-pr。
验证循环 + 检查点:改动前后的"前后对比"
光验证"当前状态是否健康"还不够,你往往还想知道:这轮改动到底是变好了还是变差了?
这时可以搭配 commands/checkpoint.md 提供的/checkpoint命令使用:
/checkpoint create 功能开始:创建检查点前会先跑一次/verify quick确认基线干净,再记录 git 状态/checkpoint verify 功能开始:把当前状态与检查点对比,输出文件变更数、测试通过率变化、覆盖率增减
典型工作流(来自 WORLDFLOWAI.md 的推荐用法):
1. /plan # 规划实现方案 2. /tdd # 先写测试 3. /verify # 验证改动可用 4. /code-review # 提交前自查 5. /checkpoint # 保存进度状态长会话中还有个小技巧:每完成一个函数、一个组件,或每 15 分钟左右跑一次/verify,在 skills/verification-loop/SKILL.md 中这被称为持续验证模式——回归问题越早发现,修复越便宜。
进阶:从"验证"到"评估"的完整质量体系
验证循环解决的是"代码健康吗",如果你想回答"这个功能真的做对了吗",工具包里还有两套进阶组件:
- commands/eval.md:
/eval命令支持define / check / report三步,把"预期行为"先定义成评估清单(.claude/evals/目录),开发中持续跑评估并跟踪回归,用 pass@k 指标衡量可靠性 - skills/eval-harness/SKILL.md:评估框架技能,区分能力评估(新功能是否达成)与回归评估(旧功能是否被破坏),并支持代码判分、模型判分、人工判分三种方式
- rules/testing.md:全局规则要求80% 测试覆盖率,/verify 的测试阶段正是对着这条线检查的
快速上手:如何安装 Everything Claude Code
整个工具包是一个 Claude Code 插件,安装后/verify、/checkpoint、/eval等命令立即可用。两种方式:
- 插件安装(推荐):在 Claude Code 的插件市场机制中添加并安装本仓库的插件
- 手动安装:克隆仓库后,把
agents/、commands/、skills/、rules/下的内容复制到你的~/.claude/对应目录即可
# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/eve/everything-claude-code.git工具包自身也带着完整的测试套件(tests/run-all.js),支持 Windows、macOS、Linux 三平台。
总结:让 AI 编程从"感觉能跑"变成"确认能跑"
- 核心心智:AI 写完代码 ≠ 完成,
/verify是你和 AI 之间的质量守门员 - 日常节奏:小改动
/verify quick,提交前pre-commit,开 PR 前pre-pr - 进阶组合:
/checkpoint记录基线做前后对比,/eval把"做对没有"也变成可度量项
改完代码先 verify,再谈提交——这一条习惯,能让你的 AI 辅助开发质量上一个台阶。
【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考