SuperAPI AI 工具集

help

编程与开发

查看项目

更新于 11-10 16:22

技能介绍

用途:hookify 插件用于创建自定义 hook,阻止或警告用户不希望出现的行为。它无需直接编辑 hooks.json,而是通过简单的 markdown 配置文件定义需要监视的模式。

主要能力:

  1. hook 系统:hookify 安装的通用 hook 会在 PreToolUse(工具执行前,如 run_command、replace_file_content、write_to_file 等)、PostToolUse(工具执行后)、Stop(Antigravity 准备停止工作时)、UserPromptSubmit(用户提交提示时)等事件触发,并读取 .claude/hookify.*.local.md 配置文件,检查是否有规则匹配当前操作。
  2. 配置文件:用户可在 .claude/hookify.{rule-name}.local.md 中编写规则。关键字段包括 name(规则唯一标识)、enabled(true/false 启用或停用)、event(bash、file、stop、prompt 或 all)、pattern(正则表达式)。消息正文会在规则触发时显示给 Antigravity。示例规则包含 name: warn-dangerous-rm、enabled: true、event: bash、pattern: rm\s+-rf,正文为危险 rm 命令警告。
  3. 创建方式:方式 A 使用 /hookify 命令,如 /hookify Don't use console.log in production files,系统会分析请求并创建相应规则文件;方式 B 手动创建上述格式的文件;方式 C 不带参数运行 /hookify,通过分析最近对话找出需要阻止的行为。

可用命令:/hookify(根据对话分析或明确指令创建 hook)、/hookify:help(显示帮助)、/hookify:list(列出所有已配置的 hook)、/hookify:configure(交互式启用或停用已有 hook)。

示例用例:阻止危险命令(如 chmod 777,提示其为安全风险,应使用具体权限);警告调试代码(如检测到 console.log( 时提醒提交前移除);要求在停止前运行测试(event: stop,pattern: .*,提示确认已执行 npm test 或等效命令)。

模式语法:使用 Python 正则语法,如 \s(空白)、\.(字面点)、|(或)、+(一个或多个)、*(零个或多个)、\d(数字)、[abc](字符类)。示例:rm\s+-rf 匹配“rm -rf”,console\.log\( 匹配“console.log(”,(eval|exec)\( 匹配“eval(”或“exec(”,\.env$ 匹配以 .env 结尾的文件。

注意事项:规则无需重启,.local.md 文件在下一次工具使用时即时生效;规则可设为阻止(action: block)或警告(action: warn,显示消息但允许);规则文件应放在 .claude/hookify.*.local.md,并建议加入 .gitignore;可通过 enabled: false 或删除文件停用规则。

故障排查:hook 未触发时,检查规则文件是否在 .claude/ 目录、frontmatter 中是否 enabled: true、pattern 是否为有效正则,可用 python3 -c "import re; print(re.search('your_pattern', 'test_text'))" 测试;导入错误时检查 python3 --version 及插件是否正确安装;模式不匹配时单独测试正则、注意转义问题(YAML 中模式不加引号),可先用简单模式再细化。

入门步骤:运行 /hookify Warn me when I try to use rm -rf 创建第一条规则;让 Antigravity 执行 rm -rf /tmp/test 触发警告;编辑 .claude/hookify.warn-rm.local.md 完善规则;遇到不希望的行为时继续创建规则。更多示例见 ${ANTIGRAVITY_PLUGIN_ROOT}/examples/ 目录。