SuperAPI AI 工具集

hooks-configuration

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:该技能用于配置和开发 Claude Code hooks,即用户在 Claude Code 生命周期特定节点自动执行的 shell 命令,提供确定性的执行保障,而非依赖模型自行决定。

主要能力:支持多种生命周期事件,包括 SessionStart、SessionEnd、UserPromptSubmit、PreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest、Stop、SubagentStart、SubagentStop、WorktreeCreate、WorktreeRemove、TeammateIdle、TaskCompleted、PreCompact、Notification、ConfigChange。典型用途有自动格式化文件、拦截危险命令、在会话开始时注入上下文、记录命令审计日志、任务完成通知、以及权限自动批准或拒绝。

配置方式:hooks 可写在 ~/.claude/settings.json(用户级)、.claude/settings.json(项目级)或 .claude/settings.local.json(本地不提交),也可写进技能与命令的 frontmatter 的 hooks 字段。匹配器支持精确名、正则(如 Edit|Write)、通配符与 MCP 工具名。hook 还分 command、http、prompt、agent 四类;prompt/agent 仅适用于部分事件。

必要用法:脚本从 stdin 读取 JSON,用 jq 解析;退出码 0 表示放行,2 表示阻断并把 stderr 展示给 Claude。可设置 timeout 字段,或用后台子 shell 模式处理耗时操作。可用 /hooks 验证注册,claude --debug 查看日志。注意:用户授权无法绕过 hook,被拦截的命令重试仍会失败。