界面已本地化;技能介绍与说明文档按所选语言由 AI 自动翻译,代码、命令、路径和专业术语保留原文,以原作者文档为准。
探索技能
开发与工程 · SKILL.md

windows-hook-debugging

windows-hook-debugging

【开发与工程】Windows环境下Claude Code插件Hook执行错误的诊断与修复。当遇到hook error、cannot execute binary file、.sh regex误匹配、WSL/Git Bash冲突时使用。

独立 GitHub 快照 · 自动分类 · 以原作者文档为准

技能说明

GitHub

name: windows-hook-debugging description: "Windows环境下Claude Code插件Hook执行错误的诊断与修复。当遇到hook error、cannot execute binary file、.sh regex误匹配、WSL/Git Bash冲突时使用。"

Windows Hook Debugging Skill

诊断和修复 Windows 环境下 Claude Code 插件 Hook 执行失败的问题。

When to Use This Skill

触发条件(满足任一即可):

  • Claude Code 启动时出现 SessionStart hook error 或 Stop hook error
  • 错误信息包含 cannot execute binary file
  • 错误信息包含 /d/ 或 /c/ 风格的路径(MSYS2/Git Bash 路径格式)
  • 错误信息包含 bash: node: No such file or directory
  • 错误信息包含 WSL 相关乱码或 wsl: 前缀
  • Hook 命令中包含 .sh 参数导致 Windows 下被错误处理

Not For / Boundaries

  • 不适用于 macOS/Linux 上的 hook 问题(那些平台没有 WSL/Git Bash 冲突)
  • 不适用于 hook 逻辑错误(如 JSON 解析失败、权限拒绝等业务逻辑问题)
  • 不适用于 MCP Server 连接问题
  • 需要的输入:完整的错误信息、当前 settings.json 内容、相关 hooks.json 内容
我的收藏