关于 debug
debug 是用于诊断当前 OMC 或 Claude-Code 会话问题的技能。它优先检查本地证据,并尽可能缩小复现范围,以区分症状和根因,确定精简的下一步行动。
主要功能
- 01检查 trace、状态与相关测试
- 02尽可能缩小范围复现问题
- 03区分症状与根因
- 04建议有针对性的修复或验证
- 05隐藏密钥并标记临时调试输出
适用场景
- 01排查会话工作流中断
- 02诊断 hook 或 Agent 编排问题
- 03判断故障是否源于运行时
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ yeachan-heo/ oh-my-claudecode --skill debug安装后在 Claude Code 中输入/debug确认已加载。
详细介绍
调试
当用户希望排查当前 OMC/Claude-Code 会话问题、工作流故障或令人困惑的运行时行为时,使用此技能。
目标
快速找到真正的故障信号,并说明下一步的纠正措施。
工作流
- 仔细阅读用户的问题描述。
- 优先检查最相关的本地证据:
- 跟踪工具
- 状态工具
- 相关时的记事本/项目记忆
- 失败的测试或命令
- 尽可能以最小范围复现问题。
- 区分症状与根本原因。
- 建议最小的下一步修复或验证措施。
规则
- 优先依据实际证据,而非猜测。
- 如果问题涉及编排、钩子或 Agent 流程,使用跟踪/状态界面。
- 如果问题实际是产品/运行时 bug,而非应用代码问题,请明确说明。
- 在隔离故障之前,不要建议大范围重写。
- 为临时调试输出添加标记
[DEBUG-<4hex>];之后只需执行一次 grep 即可清理。 - 在日志和跟踪离开会话之前,删除其中的机密信息。
- 如果故障源于缺失或错误的衔接点,请将其作为发现说明,并指向
refit或architecture-survey——关于环境的经验教训比修复本身更持久。
输出
- 观察到的故障
- 根本原因假设
- 支持该假设的证据
- 最小的下一步操作
评论
支持 Markdown