SuperAPI AI 工具集

hook-development

编程与开发

查看项目

更新于 10-15 18:31

技能介绍

用途:为 Claude Code 插件开发事件驱动钩子(hooks),在特定事件触发时自动执行验证、策略约束、上下文加载与外部工具集成。

主要能力:支持多种事件——PreToolUse 在工具执行前批准、拒绝或修改调用;PostToolUse 在工具完成后反馈或记录;Stop/SubagentStop 检查完成度;UserPromptSubmit 处理用户输入;SessionStart 加载上下文;SessionEnd 清理;PreCompact 保留关键信息;Notification 响应通知。钩子分两类:基于提示词(prompt,推荐,用 LLM 推理做上下文感知判断,默认超时 30 秒)与基于命令(command,执行 bash,默认超时 60 秒)。

使用方式:插件在 hooks/hooks.json 中以 wrapper 格式配置(含可选 description 与必填 hooks 字段);用户设置在 .claude/settings.json 中用直接格式。用 matcher 匹配工具名(如 "Write|Edit"、""、"mcp__.",区分大小写)。命令钩子中始终用 ${CLAUDE_PLUGIN_ROOT} 保证可移植性。退出码 0 表示成功,2 表示阻塞错误并将 stderr 回传给 Claude。

限制:钩子仅在会话启动时加载,修改配置后必须重启 Claude Code,无法热替换;所有匹配钩子并行执行,彼此看不到输出且顺序不确定;需自行校验输入、引号包裹变量、防范路径穿越与敏感文件。缺失信息:具体收费、价格与更多平台支持暂未提供。