用途:在当前 Claude Code 会话中帮助用户排查遇到的问题。该技能会为本次会话开启调试日志,并引导重现与读取日志。
主要能力:开启调试日志后,日志保存于 ~/.claude/debug/{{SESSION_ID}}.txt;注意本次调用 /debug 之前日志为关闭状态,之前内容未被捕获。可提示用户复现问题后重新读取日志;若无法复现,可改用 claude --debug 重启以从启动阶段捕获日志。可在整个日志文件中检索 [ERROR] 与 [WARN] 行,并结合堆栈跟踪与失败模式定位问题。设置文件位置:用户级 ~/.claude/settings.json,项目级 /private/tmp/skillcap/.claude/settings.json,本地级 /private/tmp/skillcap/.claude/settings.local.json。若涉及后台会话或 claude agents,守护进程日志可能位于 ~/.claude/daemon.log;资料显示未发现守护进程锁或状态文件,后台守护进程似乎未运行。
使用方式:调用 /debug 后按提示复现问题,再读取日志;必要时检索 [ERROR]、[WARN];可考虑启动 claude-code-guide 子代理了解相关功能;最后用通俗语言说明发现并给出具体修复或后续步骤。
限制:开启前日志不可用;若无法复现需重启捕获;用户未描述具体问题时,应先读日志并汇总错误、警告或值得注意的问题。