debug-hooks

仓库创建 2025年12月23日最近提交 6 个月前SkillHot 收录 23 天前

▸ 精选理由

提供排查步骤与检查点，适合排查自动化钩子故障。

▸ 风险提示

排查需要读取项目缓存与环境变量，可能暴露敏感信息。

这个 Skill 做什么

系统性排查 Claude Code 钩子不触发或行为异常的问题流程。

提供一套系统化的排查流程，帮你定位 Claude Code 钩子不触发或行为异常的根本原因。遇到钩子不跑、输出错乱或 SessionEnd、PostToolUse 不工作时就用它，不再盲目改代码。流程从观察输出、检查缓存到逐步复现，每步都有要查的点，能更快锁定问题来源。

▸ 展开 SKILL.md 英文原文

Systematic hook debugging workflow. Use when hooks aren't firing, producing wrong output, or behaving unexpectedly.

开发编程钩子调试工作流排查Claude HooksClaude Code

3.9k

Stars

298

Forks

仓库内 Skill

+19

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/parcadei/Continuous-Claude-v3/main/.claude/skills/debug-hooks/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/parcadei/Continuous-Claude-v3/main/.claude/skills/debug-hooks/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# Debug Hooks

Systematic workflow for debugging Claude Code hooks.

## When to Use

- "Hook isn't firing"
- "Hook produces wrong output"
- "SessionEnd not working"
- "PostToolUse hook not triggering"
- "Why didn't my hook run?"

## Workflow

### 1. Check Outputs First (Observe Before Editing)

```bash
# Check project cache
ls -la $CLAUDE_PROJECT_DIR/.claude/cache/

# Check specific outputs
ls -la $CLAUDE_PROJECT_DIR/.claude/cache/learnings/

# Check for debug logs
tail $CLAUDE_PROJECT_DIR/.claude/cache/*.log 2>/dev/null

# Also check global (common mistake: wrong path)
ls -la ~/.claude/cache/ 2>/dev/null
```

### 2. Verify Hook Registration

```bash
# Project settings
cat $CLAUDE_PROJECT_DI

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有