用途：排查本地开发中的测试失败、运行时错误、类型错误、构建失败和预期行为不符等问题。
主要能力：采用测试优先流程，先写能复现缺陷的失败测试并确认失败原因，再收集上下文、定位根因、实施修复，最后以测试通过作为完成标准。支持通过 git diff、git log、git stash 查看变更，检查运行时与依赖版本、环境变量、完整错误堆栈和复现步骤，并对错误分类。对性能类问题可加入计时插桩，收集耗时数据并定位瓶颈。复杂或间歇性问题可调用 /systematic-debugging，按根因调查、模式分析、假设验证、实施四阶段处理。
使用方式：可先用 Codex 做初稿调查，命令为 codex exec "DEBUG: $SYMPTOMS. Reproduce, isolate root cause, propose fix." --output-last-message /tmp/codex-debug.md 2>/dev/null，然后人工复核其结论。查看文件时先确认大小，使用 wc -l、du -h，读取窗口用 ~/.claude/scripts/safe-read.sh <file> 1 120，日志用 head -n 200 或 tail -n 200 截断。若 20 秒内无有效信号，应中止并缩小范围重跑。
适用场景：本地缺陷复现与修复、测试失败分析、类型与构建错误排查、性能变慢定位、间歇性缺陷调查。
限制：资料未提供具体支持的语言、框架、平台或收费信息；修复前需明确是在解决根因还是仅缓解症状，并做持久性检验。