debug-mode
双轨并行AI调试，提升复杂Bug排查成功率
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：debug-mode。 它的用途是：双轨并行AI调试，提升复杂Bug排查成功率 完整的 Skill 内容见：https://321skill.com/skills/debug-mode/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用debug-mode帮我分析这个间歇性出现的数据库连接超时问题。” 它会初始化一个双轨调试会话，两个AI轨道会分别搜索代码库、提出假设、添加诊断日志并尝试复现问题。你可以通过命令观察每个轨道的进度，最终主智能体会综合两个轨道的发现，给出最有可能的根因和修复建议。
介绍
Debug Mode是一个专为复杂、难以定位的软件Bug设计的AI辅助调试工具。当传统的单一线程调试方法失效时，它能通过创建两个独立的AI推理轨道并行工作，每个轨道都会审视并改进自己之前的成果，最终由一个主智能体综合两个轨道的发现，生成高置信度的修复方案。
使用前需要安装Bun运行时、tmux终端复用器以及Codex CLI等工具。使用时，通过debug-mode init命令初始化调试会话，它会为两个轨道创建独立的Git工作树和进度文档。随后，你可以分别运行debug-mode codex run来启动两个轨道的迭代调试，并通过debug-mode status来检查各自的进度信号。调试完成后，使用debug-mode cleanup进行清理，它会归档调试分支以供事后分析。
这个工具非常适合那些需要深入分析、常规方法难以解决的顽固Bug场景。它主要面向有一定经验的开发者，特别是那些在复杂代码库或分布式系统中工作的工程师。
需要注意的是，该工具依赖特定的外部工具链（如Codex CLI），并假设用户具备基本的命令行和Git操作能力。它更适合用于需要深度推理的复杂问题，对于简单的语法错误或逻辑问题，可能显得过于重型。
核心特点
核心区别在于采用了“混合双轨并行执行”架构，结合了Claude Opus 4.5和GPT 5.2两种模型，让两个独立的AI轨道（Track A和Track B）以不同的模型组合和推理路径并行工作，最后由一个“法官”智能体进行裁决，这比单一AI链式调试能探索更多可能性，提高找到正确根因的概率。
注意事项
不适合解决简单的语法错误或可通过单元测试快速定位的常规Bug，对用户命令行和Git操作能力有一定要求。
常见问题
Debug Mode和普通调试有什么区别？
它使用两个AI智能体并行探索不同的修复假设，通过竞争和裁决机制来应对复杂、非确定性的Bug，而不仅仅是单步执行或日志分析。
必须要有ChatGPT Pro才能用吗？
是的，因为其中一个轨道（Track B）需要使用GPT 5.2模型，这需要通过Codex CLI进行OAuth登录，而Codex CLI目前免费提供给ChatGPT Pro用户使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/debug-mode/raw/index.md 读取 debug-mode 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/debug-mode/raw/index.md（查看排版版本）