SuperAPI AI 工具集

block-no-verify-hook

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:AI 编码代理(如 Claude Code、Codex)在提交代码时可能使用 --no-verify 等标志跳过 pre-commit 钩子,导致代码未格式化、lint 错误、安全扫描和测试被绕过。本技能通过 PreToolUse 钩子在工具调用执行前拦截含绕过标志的命令。

主要能力:仅匹配 Bash 工具调用,不影响 Read、Edit、Grep 等;通过 stdin 接收 JSON 并用 grep -E 检查 command 字段,无需 jq 或 node;可拦截 --no-verify、--no-gpg-sign 及其被 git 接受的缩写(如 --no-veri),以及 commit 后带 n 的短选项组(如 -n、-nm);不依赖 git 字样,可捕获 sudo git、变量替换等写法。

使用方式:在项目根目录创建或更新 .claude/settings.json,加入 matcher 为 Bash 的 PreToolUse 钩子,命令为 grep 检测逻辑,命中时输出错误并以退出码 2 阻止调用;也可写入 ~/.claude/settings.json 全局生效。退出码 0 放行,1 警告但继续,2 完全阻止。

适用场景:需要强制 pre-commit 钩子、提交签名策略生效的团队项目;可与其他 PreToolUse 钩子(如拦截危险 rm 命令)组合使用。

限制:仅做文本检查,能阻止习惯性使用绕过标志的代理,但无法阻止刻意规避(如拼接标志或使用 git -c core.hooksPath=/dev/null commit);提交信息中提及相关标志可能误触发拦截,属于安全失败。建议将配置文件纳入版本控制并在贡献指南中说明。