用途：在运行中的 Flutter 应用里复现、检查、诊断并修复故障。核心流程是把报告的症状变成可重复的失败，找到第一个不正确的状态或失败边界，施加受支持的最小修复，再重复同一流程作为证据。
建立运行时：先读 SDK 约束、flavors、入口点、defines、目标平台、近期改动以及已有日志或崩溃产物；在另起一份副本前先发现可用设备与正在运行的应用，并保留用户选定的目标与环境。不要仅凭最后一个栈帧、截图或下游断言推断根因，需记录确切触发条件、预期结果、实际结果、构建模式、平台以及重启后是否仍复现。环境支持时可用 Dart 与 Flutter MCP 做 widget 树检查、结构化日志与运行时诊断，否则用 DevTools 与 CLI 输出获取同等证据。
按需加载参考：选择目标、附加到已有进程、处理启动或生命周期失败、缩小偶发症状时，读复现与附加相关文档；用 inspector、debugger、日志、网络、内存、CPU 或帧视图验证具体假设时，读 DevTools 诊断文档。
窄范围诊断：使用框架错误详情、因果栈、结构化日志、断点、监视与受控状态变更，只在证据所及范围内跨 widget、状态、isolate、传输、插件与原生边界追踪数据与所有权。选择修复前，要求每个相关边界都给出首个错误转换；权限或生命周期失败需显式追踪原生回调、插件或通道结果与错误映射、应用状态所有者以及恢复或已销毁的消费者，不要停在罗列可能原因或预先采用防御性空检查。一次只改一个相关变量；临时插桩须有界、脱敏，并在完成前移除或转为持久诊断。热重载保留状态，不能证明启动、注册、初始化、生成代码或原生配置正确；插件或原生注册变更需在每个受影响的支持目标上完整重建并干净进程启动，检查启动与注册日志，确认不支持目标按包文档行为失败而非意外缺失插件路径，必要时重装。
边界：设备验收流程执行归 flutter-device-testing；profile 模式追踪与性能前后对比归 flutter-performance；持久自动化测试策略归 flutter-testing；生产遥测设计归 flutter-observability；通道、FFI、插件、平台视图或原生生命周期内的修复归 flutter-platform-integration。
验证：在等价条件下重复原失败流程，再走最近的错误与生命周期路径，在拥有缺陷的层添加最小持久回归测试，并说明目标、构建模式、所用命令或工具、观察到的证据以及未复现或未验证的内容。