create-hook

blueif16's avatarfrom blueif16

创建或添加event hooks到插件

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025⬇️1downloads
[Tool Routing and Orchestration]

When & Why to Use This Skill

The create-hook skill is a specialized developer utility designed to streamline the management of event hooks within Claude agent plugins. By automating the configuration of the hooks.json file, it allows developers to inject custom logic into the agent's execution lifecycle. This skill simplifies the process of intercepting tool usage, permission requests, and user prompts, enabling more controlled, automated, and sophisticated agentic workflows.

Use Cases

  • Automated Code Formatting: Setting up a PostToolUse hook to automatically run tools like Prettier or ESLint after the agent modifies source code files.
  • Pre-execution Validation: Implementing PreToolUse hooks to validate environment variables or file paths before the agent executes sensitive bash commands.
  • Real-time Notifications: Configuring Notification hooks to send status updates to external platforms like Slack or Discord when specific agent milestones are reached.
  • Custom Permission Logic: Adding hooks to the PermissionRequest event to implement specialized authorization workflows for high-stakes tool operations.
  • Audit Logging: Creating hooks that capture and log detailed interaction data for debugging and performance monitoring of complex sub-agent tasks.
namecreate-hook
description创建或添加event hooks到插件
allowed-toolsWrite, Read, Glob

创建Hook

目的

创建或添加event hooks到插件的hooks.json文件。

执行逻辑

1. 检查插件结构

检查当前目录是否存在 .claude/ 目录
├─ 找到 → 继续到步骤3
└─ 未找到 → 进入步骤2（同create-skill的自动初始化）

2. 自动初始化插件（如需要）

与create-skill相同的初始化流程。

3. 收集hook信息

询问用户：

  1. "Hook事件类型？"

    • PreToolUse
    • PostToolUse
    • PermissionRequest
    • UserPromptSubmit
    • Notification
    • Stop
    • SubagentStop

  2. "匹配模式？" (例如: "Bash", "Edit|Write", "*")

  3. "要执行的命令？"

4. 更新hooks.json

  1. 读取现有的 .claude/hooks/hooks.json
    • 如果不存在，创建新文件
  2. 添加新hook到相应的事件数组
  3. 写回文件
  4. 显示成功消息

Hook事件说明

  • PreToolUse: 工具使用前触发
  • PostToolUse: 工具使用后触发
  • PermissionRequest: 权限请求时触发
  • UserPromptSubmit: 用户提交prompt时触发
  • Notification: 通知时触发
  • Stop: 停止时触发
  • SubagentStop: Subagent停止时触发

匹配模式示例

  • "Bash" - 仅匹配Bash工具
  • "Edit|Write" - 匹配Edit或Write工具
  • "*" - 匹配所有工具

成功输出

✅ Hook已添加到 {event}
📁 位置: ./.claude/hooks/hooks.json
🚀 该hook立即生效

示例

用户: "添加一个auto-format hook"

执行流程:

  1. 检查 .claude/ → 找到
  2. 询问hook信息:
    • 事件: PostToolUse
    • 模式: Write|Edit
    • 命令: prettier --write $FILE
  3. 更新 .claude/hooks/hooks.json
  4. 输出成功消息