用途：针对用户描述的具体 Bug 执行深度根因分析，使用上下文隔离的 subagent 自主读取代码与 diff，避免在主 agent 中堆积代码内容。触发时机包括用户要求分析 Bug 根因，或提到「bug 分析」「根因分析」「调试」「debug」等关键词，以及报告错误或异常行为需要深入排查时。
使用方式分三步。第一步整理用户需求：把 Bug 现象（错误信息、异常行为）、触发条件或复现步骤、相关代码位置、重点关注方向整理为简洁指令；若用户未指定代码位置，则整理为「从项目入口和相关模块开始分析」。第二步启动分析 subagent：读取本目录下的 bug-analyzer.md，将其完整内容与整理后的需求拼接作为 prompt 传给 Agent 工具 spawn subagent，其中 description 为「Bug 根因分析」，prompt 为 bug-analyzer.md 完整内容加「\n\n## 分析任务\n」加用户需求指令，model 读取 bug-analyzer.md frontmatter 中的 model 字段决定，未指定则默认 sonnet。关键原则是：不要在主 agent 中搜集代码内容，只传递分析目标描述；subagent 自备 Bash、Read 等工具，会自行读取代码和 diff；必须传递 bug-analyzer.md 全部内容，不可截断或摘要。第三步输出分析结果：将 subagent 返回的分析结果直接输出给用户，不做摘要或缩写。
适用场景：用户已能描述具体故障现象、希望定位根因的调试排查任务。限制：需依赖 Agent 工具与 subagent 机制；如果用户未提供代码位置或复现步骤，分析范围会受描述完整度影响；其他收费、平台与效果信息暂未提供。