SuperAPI AI 工具集

create-hooks

智能体与模型

查看项目

更新于 10-15 21:53

技能介绍

该技能提供创建、配置和使用 Claude Code hooks 的专家指导,用于在不修改核心代码的前提下对 Claude 行为进行程序化控制,实现项目级自动化、安全校验与工作流定制。

用途:在需要处理 hooks、设置事件监听、校验命令或定制工作流时使用。

主要能力:支持多种 hook 事件,包括 PreToolUse、PostToolUse、UserPromptSubmit、Stop、SubagentStop、SessionStart、SessionEnd、PreCompact、Notification;其中部分事件可阻断操作,通过返回 decision 为 block 阻止动作。hook 类型分为 command(执行 shell 命令,输入 JSON 经 stdin,输出 JSON 经 stdout)和 prompt(由 LLM 评估提示词,使用 $ARGUMENTS 占位符)。matcher 支持精确匹配、正则多工具匹配(如 Write|Edit)、MCP 工具匹配(如 mcp__.*),不设 matcher 则对所有工具生效。

使用方式:项目配置写入 .claude/hooks.json,用户配置写入 ~/.claude/hooks.json。选择事件、类型与 matcher 后,用 claude --debug 测试,并用 jq . .claude/hooks.json 校验 JSON。可用环境变量包括 $CLAUDE_PROJECT_DIR、${CLAUDE_PLUGIN_ROOT}、$ARGUMENTS。

适用场景:桌面通知、阻断破坏性 git 命令、编辑后自动格式化、日志与审计、会话上下文注入等。

限制与安全要求:需防止 Stop hook 无限循环(检查 stop_hook_active 标志)、设置合理超时(默认 60 秒)、确保脚本可执行权限、使用绝对路径、谨慎使用阻断型 hook。具体收费、价格与平台信息暂未提供。