SuperAPI AI 工具集

hook-creator

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:帮助用户为 Claude Code 创建钩子配置,使工作流可被事件自动触发,例如保存后格式化、编辑后运行测试、会话初始化等。当用户要求“创建 hook”“编写 hook 配置”“添加 hooks.json”“配置事件钩子”或为插件添加钩子时使用。

主要能力:支持三类钩子——command(执行 shell 命令/脚本)、validation(校验文件内容或项目状态)、notification(发送提醒或状态更新)。钩子定义在 hooks/hooks.json 中,包含事件类型、可选 matcher(用于过滤触发钩子的工具)以及钩子动作。支持的事件包括 PreToolUse、PostToolUse、UserPromptSubmit、Notification、Stop、SubagentStop、SessionStart、SessionEnd、PreCompact,具体以官方文档为准。

使用方式:先明确要自动发生什么、在哪个事件触发、哪些工具调用应触发(如 PostToolUse)。创建流程为:确定事件与目的、选择钩子类型、编写 hooks.json、按需在插件 scripts/ 目录创建关联脚本并执行 chmod +x scripts/script.sh、最后对照官方参考文档核验事件名与配置结构。路径应使用 ${CLAUDE_PLUGIN_ROOT} 保证可移植性。

示例:编辑后自动格式化可用 PostToolUse 搭配 matcher "Write|Edit" 指向 ${CLAUDE_PLUGIN_ROOT}/scripts/format-code.sh;会话开始时显示欢迎信息可用 SessionStart 加 echo 命令;修改测试文件后运行测试可用 PostToolUse 加 matcher 指向 run-tests.sh。

限制:钩子规格与可用事件应以官方文档 plugins/meta/claude-docs/skills/claude-docs/reference/plugins-reference.md 为准;应选择最具体的事件、用 matcher 精确过滤以避免不必要执行,脚本需优雅处理错误。该技能的具体收费、价格与支持平台暂未提供。