用途：系统化调试并修复缺陷，采用根因分析、多模型推理与自动化测试，输出带测试验证和影响分析的修复代码。
主要能力：深度根因分析（5 Whys、逆向推理）；多模型推理生成修复方案；Codex 在隔离沙箱中自动修复；带迭代的全面测试；回归验证；性能影响分析。所用模型：Claude 负责根因分析与验证，Codex 负责快速修复实现，Gemini 在需要时分析大型代码库。
输入契约：bug_description（必填）、context_path（必填，目录或文件）、reproduction_steps（可选）、error_logs（可选）、depth（shallow/normal/deep，默认 deep）。输出契约包含 root_cause、fix_applied、validation、confidence（0-1）。
使用方式：执行流程分六阶段，依次运行根因分析、上下文分析（代码行数超 10000 时用 Gemini MegaContext）、生成修复方案、Codex 自动修复、迭代测试（最多 5 次）、性能影响分析。示例命令：smart-bug-fix "API timeout under load" src/api/；可附加 --reproduction-steps 或 --error-logs。集成点包括 /bug-triage-workflow、/production-incident-response 级联，以及 /agent-rca、/gemini-megacontext、/codex-auto、/functionality-audit 等命令。
适用场景：需要系统化定位并修复缺陷、验证回归与性能影响的开发流程。
限制：资料未提供收费、价格、平台支持范围等信息；失败模式包括根因分析无结论、Codex 修复测试失败、检测到回归、性能下降，需按资料所述请求更多上下文、尝试替代方案、回滚或优化。