钩子管理系统Skill hook

---

name: hook description: 钩子控制 - 启用、禁用和管理Claude Code钩子。当您需要为当前会话管理、调试或监控Claude Code钩子时使用。

钩子管理系统

管理当前会话的Claude Code钩子。

何时使用

• 当您需要检查Claude Code钩子的状态时
• 当您想暂时禁用嘈杂或有问题的钩子时
• 当调试钩子行为或性能问题时
• 当监控钩子执行指标时

用法

/hook status                  # 显示所有钩子及其状态
/hook list                    # 列出可用钩子及其描述
/hook disable [钩子名称]     # 暂时禁用一个钩子
/hook enable [钩子名称]      # 重新启用一个已禁用的钩子
/hook profile                 # 显示钩子性能指标
/hook logs [钩子名称]        # 查看钩子的最近日志

说明

当调用此命令时：

/hook status

1. 读取 ~/.claude/settings.json
2. 解析钩子配置
3. 检查 ~/.claude/hooks/.disabled 中的禁用钩子
4. 以格式化表格显示：
   • 钩子类型（SessionStart、PreToolUse、PostToolUse等）
   • 匹配模式
   • 命令/提示
   • 状态（启用/禁用）

/hook list

1. 扫描 ~/.claude/hooks/ 目录
2. 列出每个钩子文件：
   • 文件名
   • 描述（来自文档字符串）
   • 触发类型
   • 最后修改时间

/hook disable [钩子名称]

1. 创建/更新 ~/.claude/hooks/.disabled 文件
2. 将钩子名称添加到禁用列表
3. 钩子在运行前检查此文件
4. 注意：更改在重新启用前持续有效

/hook enable [钩子名称]

1. 读取 ~/.claude/hooks/.disabled 文件
2. 从禁用列表中移除钩子名称
3. 确认钩子已重新启用

/hook profile

1. 读取 ~/.claude/logs/hook_metrics.jsonl
2. 计算每个钩子的平均执行时间
3. 显示：
   • 钩子名称
   • 平均执行时间（毫秒）
   • 总调用次数
   • 成功率
   • 令牌影响估计

/hook logs [钩子名称]

1. 在 ~/.claude/logs/ 中找到日志文件
2. 按钩子名称筛选
3. 显示最近20条条目
4. 包括时间戳、结果和任何错误

示例

# 检查当前钩子状态
/hook status

# 暂时禁用嘈杂的通知
/hook disable notification

# 当准备好时重新启用
/hook enable notification

# 检查性能影响
/hook profile

# 调试特定钩子
/hook logs post_tool_use

备注

• 禁用状态使用 ~/.claude/hooks/.disabled 文件
• 性能数据来自 ~/.claude/logs/hook_metrics.jsonl
• 钩子在执行前检查禁用状态
• 基于会话的禁用（在重启时重置）