AI 代码验证守卫

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install ai-code-verification-guard
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 ai-code-verification-guard。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AI 代码验证守卫是一款适用于 AI 编码代理的零依赖验证技能。它会运行适用的语法、类型、lint 和测试检查，记录变更前的基线，并在代码变更后比较结果以检测回归。随附的 scripts/verify.mjs 是最终裁定者：代理必须引用它给出的判定结果，不得自行覆盖。
对于 Openclaw Skills 用户，此技能可在受支持的 Node.js、Go、Rust、Python 和纯 JavaScript 项目中提供一致的验证工作流。它还会明确说明不确定性：缺少工具或无法识别的项目结构会产生 UNVERIFIED 结果，而不是误导性的通过结果。

应用场景

在实现功能，或更改会影响逻辑、接口或测试的代码之前。
修复错误后，需要确认相关检查通过时。
收到运行测试、验证更改、确认行为或执行回归检查的要求时。
在受支持的 Node.js、Go、Rust、Python 或纯 JavaScript 项目中工作时。
AI 编码工作流需要区分顺利通过、失败、回归或无法验证的环境时。

工作原理

更改代码前，从项目根目录运行 verify.mjs snapshot，执行适用的检查并记录基线。
脚本根据项目标记和命令内容识别检查，而不是只依赖脚本名称。
代理进行所需的代码更改。
报告完成前，从项目根目录运行 verify.mjs run。脚本会执行检查，并在存在快照时与其比较结果。
遵循基于退出码的判定：PASS 表示可以附上判定结果后完成；PASS_WITH_UNVERIFIED 仅允许在逐项引用所有未验证项目时完成；FAIL 和 REGRESSION 要求修复并重新运行；UNVERIFIED 要求引用阻止验证的原因，并让用户决定。

配置指南

此技能需要 Node.js，且没有外部软件包依赖。所提供的文档未指定软件包管理器安装命令；请通过 OpenClaw 技能设置使技能目录可用，然后将 替换为该目录的路径。从项目根目录运行命令。
node --version
node /scripts/verify.mjs snapshot
完成更改后，运行最终验证：
node /scripts/verify.mjs run
报告结果时，请逐字附上输出的 VERIFY VERDICT 区块。基线会写入项目的 .verification/ 目录；建议将该目录添加到 .gitignore。仅涉及文档、注释或格式的更改可以跳过验证，但必须说明原因。

数据架构

此技能将验证状态保存在项目中，而不是外部服务中：
位置或数据 用途
/scripts/verify.mjs 随附脚本，用于发现并运行检查、比较结果以及输出判定结果。
/.verification/ 脚本写入快照基线的位置。源代码未指定具体的基线文件名或详细文件架构。
项目配置和源代码 用于识别项目类型和适用的检查；此技能不会安装软件包。
VERIFY VERDICT 输出 代理必须逐字引用的结果区块。
支持的检测包括 Node.js 软件包脚本；Go 构建、vet 和测试检查；Rust check 和测试检查；Python compileall 和 pytest；以及纯 JavaScript 语法和测试检查。在 monorepo 中，声明的守卫范围仅限根级检查。

高级特性

由退出码强制执行的判定：
PASS 和 PASS_WITH_UNVERIFIED 以代码 0 退出；FAIL 和 REGRESSION 以代码 1 退出；UNVERIFIED 以代码 2 退出。代理无权更改结果。
基线回归检测：
将每次运行与快照比较，并标记从通过变为失败的检查。
以内容为先的 Node.js 检查发现：
根据命令内容对脚本分类，包括 lint、格式检查、类型检查、组合检查门控和测试；会生成文件的构建类脚本不会被视为类型检查。
执行保护措施：
不会原样运行包含 --watch 、 --fix --write 的脚本，并会确定性地将单独的 Vitest 测试命令转换为本地
vitest.mjs run
调用。
monorepo 感知：
检测 workspace、pnpm-workspace 和 Lerna 配置，并声明检查范围仅限根级。
如实呈现不确定性：
将缺少工具和无法识别的项目结构报告为 UNVERIFIED，而不是声称成功。
不伪造基线：
没有快照时仍会运行检查，但无法比较回归；此技能禁止事后伪造基线。

name: ai-code-verification-guard description: Deterministic code-verification guard for AI coding agents. Runs syntax, type, lint and test checks before and after code changes, and decides PASS / FAIL / REGRESSION / UNVERIFIED purely by script exit codes. The agent may only quote the verdict, never overrule it. Use when the user asks to modify code, implement features, fix bugs, or verify change reliability (trigger phrases - verify this, run the tests, regression check, confirm it works, 验证一下, 跑测试, 回归检查, 确认没问题). Not for general code review or security audits. version: 1.0.1
license: MIT