Debug 技能用于帮助用户排查在当前 Claude Code 会话中遇到的软件错误、测试失败或意外运行时行为。
用途:当用户需要诊断软件错误、测试失败或异常运行时行为时,可使用该技能。它聚焦于当前 Claude Code 会话中的问题定位。
主要能力:
- 启用并读取调试日志。该技能说明调试日志在本次 /debug 调用之前处于关闭状态,因此此前内容未被捕获;启用后日志路径为 {debug_log_path}。
- 提示用户复现问题,然后重新读取日志。若用户无法复现,可建议通过 claude --debug 重启以捕获从启动开始的日志。
- 读取当前会话的调试日志,并可在整个文件中检索 [ERROR] 和 [WARN] 行以获取额外上下文。
- 检查守护进程状态:若未找到守护进程锁或状态文件,则说明后台守护进程似乎未运行;若问题涉及后台会话或 claude agents,守护进程日志(如有)位于 {user_home}/.claude/daemon.log。
- 在用户未描述具体问题时,读取调试日志并总结其中的错误、警告或值得注意的问题。
- 查看设置文件位置:用户级 {user_home}/.claude/settings.json、项目级 {working_directory}/.claude/settings.json、本地级 {working_directory}/.claude/settings.local.json。
- 考虑启动 claude-code-guide 子代理以理解相关的 Claude Code 功能。
- 用通俗语言解释发现的问题,并给出具体修复或后续步骤建议。
使用方式: 该技能在 Claude Code 会话中通过 /debug 调用。调用后,调试日志开始记录,用户被要求复现问题,随后技能重新读取日志。若无法复现,可改用 claude --debug 重启以捕获启动日志。技能会检查日志中的错误与警告、堆栈跟踪和失败模式,并可能借助 claude-code-guide 子代理。
适用场景:
- 诊断软件错误。
- 排查测试失败。
- 处理意外运行时行为。
- 涉及后台会话或 claude agents 的问题排查。
限制:
- 在本次 /debug 调用之前,调试日志处于关闭状态,因此此前内容未被捕获。
- 当前会话的调试日志可能尚不存在。
- 若未找到守护进程锁或状态文件,后台守护进程可能未运行。
- 用户未描述具体问题时,只能基于日志总结错误、警告或值得注意的问题。
- 资料未提供该技能的收费、价格、平台或效果信息。