用途:系统性诊断和修复 Unity 项目中的代码 bug。它收集症状(错误信息、堆栈跟踪、描述),对 bug 分类,读取相关代码,按类别套用诊断树,给出修复方案并补充防御性代码与预防建议。
主要能力:按 bug 类型分流,包括编译错误、运行时异常(NullReference、MissingComponent、MissingReference、IndexOutOfRange、InvalidOperation、StackOverflow、OperationCanceled)、逻辑错误、性能问题、视觉问题、物理问题以及 async/Awaitable 问题。输出统一格式:症状 | 原因 | 修复 | 预防。
使用方式:用户描述 bug 或粘贴错误信息;技能先分类 bug 类型,再读取涉及文件,套用诊断树,最后产出诊断。常用检索方式如 Grep("class 脚本名", type: "cs") 定位文件,Read 读取完整代码,Grep("GetComponent|Find|SendMessage", 文件) 查找高风险调用,Grep("void Update|void FixedUpdate", 文件) 定位热路径。对堆栈跟踪需从最深层到最上层逐个读取调用链中的文件。
前提:需要访问 Unity 项目源码文件,最好提供准确的错误信息或堆栈跟踪;仅限 Claude Code 工具(Read、Grep、Glob),不需要 MCP Unity。
限制与规则:必须先读真实源码再诊断,不得凭空猜测原因;不得忽略堆栈跟踪;不得用 try/catch 掩盖 bug;不得假设问题出在 Unity 引擎本身;修复不得引入回归。若为通用性能问题应改用 /perf-audit,需要重构用 /unity-refactor,需要测试验证用 /unity-test。无堆栈跟踪、不可复现、第三方包错误、仅构建时出现或与帧率相关等疑难情况,资料给出了对应的排查方向。详细诊断树与常见 bug 表见 references/diagnostic-trees.md 和 references/common-bugs.md。