verification-loop

verification-loop 技能概览

verification-loop 是做什么的

verification-loop 技能是一套面向 Claude Code 会话的验证工作流。它帮助你在实现之后检查改动，按有意设计的顺序执行构建、类型检查、lint、测试、安全检查和 diff 复审，而不是依赖一句笼统的“看起来不错”提示。如果你需要一个用于 Verification 的 verification-loop skill，它的目标是帮你在 PR 之前尽早发现回归，而不是负责功能规划本身。

谁适合安装它

如果你经常完成代码改动，并且希望为 JavaScript、TypeScript 或 Python 项目建立一个可重复的质量门禁，那么就适合使用 verification-loop。它尤其适合希望在变更后进行结构化检查、并且需要明确停止条件的 agent 和开发者，特别是当构建失败或类型错误应该阻止后续步骤时。

它的不同之处

verification-loop 的核心价值在于分阶段推进：先构建，再检查类型，然后 lint、测试、安全检查，最后做 diff 复审。这个顺序很重要，因为它能减少无谓劳动，也更容易把失败点隔离出来。这个技能在报告方式上也比较有主见，会明确要求输出测试数量、覆盖率等信息，因此比含糊的验证提示更适合做决策。

如何使用 verification-loop 技能

verification-loop 的安装与设置

先把 verification-loop skill 安装到你的 Claude Code 环境中，然后打开 SKILL.md，把它作为起点。这个仓库很精简，没有额外的辅助脚本或支持目录可以依赖；skill 本身就是唯一可信来源。对于 verification-loop install 来说，实际目标不只是把技能加进去，还要确保你当前项目里有这套工作流所期望的构建和测试命令。

给技能一个具体的变更上下文

verification-loop usage 的效果最好，是在你明确说明这次改动、技术栈以及适用的验证命令时。差的输入是：“帮我验证代码。” 更好的输入是：“验证这个 TypeScript 应用里的登录重构。运行 build、tsc --noEmit、lint 和 tests，然后按文件名汇总失败项，并判断这次改动是否可以安全合并。” 这种具体程度能帮助技能知道该检查什么，以及什么属于阻塞项。

按阶段顺序执行，并遵守停止规则

按顺序使用各个阶段，不要在前一关失败时就跳到后面。如果 build 失败，先修它，再做类型检查；如果类型检查失败，先解决关键错误，再继续看 lint 或测试。这正是 verification-loop 指南背后的核心操作逻辑：它是一种逐层收敛的工作流，而不是并行清单。

先读这些文件

先从 skills/verification-loop/SKILL.md 开始。如果你要把这个技能适配到真实代码库中，请把其中的命令和你项目里的 package scripts 以及现有工具链进行对照。由于这个仓库没有额外参考资料，下一步应该去读项目自己的 build、lint 和 test 定义，这样你才能把技能映射到真实命令，而不是想当然地以为 npm、pnpm、ruff 或 pyright 一定可用。

verification-loop 技能 FAQ

verification-loop 只适用于 Claude Code 吗？

它是为 Claude Code 会话编写的，但其底层验证逻辑作为变更后的检查清单，本身也很通用。如果你不在那个生态里，仍然可以手动按同样顺序使用。安装 verification-loop 的主要原因，是为了在 Claude 工作流中获得便利性和一致性。

我一定要是 JavaScript 或 Python 项目吗？

不一定，但这些是技能中明确点名的技术栈。verification-loop 技能在你的项目有清晰的 build、type check、lint 和 tests 命令时效果最好。如果你的技术栈使用的是别的工具，仍然可以使用这套工作流，只是需要你自己把命令翻译过去。

什么情况下不适合用 verification-loop？

如果你只需要针对一个很小的改动临时写个提示，或者仓库里根本没有有意义的 build/test 门禁，那就没必要用它。如果你的代码库非常特殊，不适合标准验证命令，而且你也不想改造这套流程，它同样不合适。在这些情况下，自定义提示可能比安装完整的 verification-loop skill 更快。

它和普通提示有什么区别？

普通提示可以要求“运行测试”，但 verification-loop 提供的是一个有顺序的验证循环，带明确的停止逻辑和报告目标。这减少了歧义，也更容易判断改动是否已准备好。代价是，你仍然需要提供正确的项目级命令和约束。

如何改进 verification-loop 技能

输入你项目专用的命令

提升效果最大的地方，是把通用命令替换成仓库里真实在用的命令。如果你的项目使用 pnpm build、npm test、pytest 或自定义脚本，要提前告诉 agent。更好的输入会减少猜测，让 verification-loop 比默认命令序列更可靠。

要求失败摘要，而不只是通过/失败

当你要求输出一个简洁报告，列出失败步骤、文件名，以及是否阻塞合并时，这个技能会更有用。例如：“跑完循环后，先列出 build 错误，再列出 type 问题，接着列出 test 失败，并标明哪些是关键阻塞项。” 这样输出就能直接用于行动，而不是只给你一个二元结果。

留意常见失败模式

最常见的问题是缺少项目命令、类型检查覆盖不完整，以及安全扫描对仓库来说过于浅显。另一个失败模式，是在代码还没有稳定到足以判断时就要求技能去验证。verification-loop 最适合在实现完成之后使用，此时 diff 已经可以被认真评估。

第一次运行后继续迭代

如果第一次验证跑出很多噪音，下一轮就收紧范围：指向变更文件、指定包或应用目录，并说明哪些警告是可以接受的。如果第一次运行通过了，但你仍然不放心这次改动，那就要求一次聚焦于高风险文件、边界情况或覆盖缺口的 diff 复审。这样，verification-loop 才会从一次性的检查清单，变成可重复执行的验证流程。