debug-hooks

debug-hooks 技能为使用 Continuous Claude 钩子架构的开发人员提供了一个全面、逐步的诊断框架。当自动化触发、自定义文件追踪或技能自动激活行为失败时，此工具将引导用户检查 Claude Code 环境的关键验证层。它专为维护复杂代理工作流程的工程师和开发人员而设计，用于识别 .claude/hooks 目录内的静默失败、配置不匹配或捆绑包同步问题。

• 系统化诊断钩子执行失败，包括 UserPromptSubmit、SessionEnd 和 PostToolUse 事件。

• 验证项目和全局 settings.json 文件中的钩子注册情况。

• 检查内部文件结构，包含 shell 包装器和 esbuild 创建的捆绑 .mjs 文件。

• 使用预定义的 JSON 负载对单个钩子进行手动测试，以模拟工具触发。

• 针对可能导致隐藏运行时错误的分离进程和常见的 stdio: 'ignore' 陷阱进行高级疑难排解。

• 确保 TypeScript 源文件正确捆绑到活动执行环境的自动化协调流程。

• 在修改配置之前，请务必先检查 .claude/cache/ 目录，确认日志和学习内容是否正确生成。

• 确保所有 shell 脚本均可执行，且 settings.json 正确将触发器映射到正确的脚本路径。

• 请记住，编辑 TypeScript 源文件需要使用 esbuild 手动重新构建；在 .mjs 捆绑包更新前，更改不会反映在环境中。

• 如果钩子看起来已执行但没有输出，请检查是否有分离的 spawn 配置可能抑制了标准错误输出 (stderr)。

• 使用提供的清单确保开发环境与本地执行环境的一致性，特别是在 node 和 npx 依赖方面。

• 此工具专供管理 Continuous Claude 生态系统的技术用户使用，当标准代理行为偏离预期工作流程时，应使用此工具。