用途：在开发态、设备在线条件下对 MaaFramework（MaaFW）应用做实时调试与验收，定位识别、动作、流程、配置与验收各层问题，产出「定位结论 + 证据」，修复本身交接给其他技能。
主要能力：按症状分层分诊（配置层、识别层、动作层、流程层、验收层）；单节点识别验证与截图、hits/box 期望比对；识别成功但点击不落点的落点比对；ROI 校准与阈值调参；流程卡死与死循环归因；controller 连接与启动链路排查；端到端验收与 pipeline_override 生效验证。
使用方式：先定执行工具，Agent 自主默认 maafw-live，动手前做 version / env / probe 自检；有 dev-tools 的项目先执行 pnpm check 清结构错误。识别层用 reco 做识别单测、--act 做真机执行动作半；run 从 entry 起跑会继续走 next / on_error，不是单节点验证。协议字段语义查 MaaLLMWiki 版本锁定的协议原文（2.4-控制方式说明、3.1-任务流水线协议、3.3-ProjectInterfaceV2协议），工具命令查所选运行工具自身文档。
硬护栏：证据优先，结论须有实时观测证据；一次只改一个变量并立即复测；诊断截图与点击必须走框架截图链路；只定位不修复，修复交接 maafw-pipeline / maafw-interface / maafw-custom，离线证据分析转 maa-evidence；区分调用成功、任务成功、业务验收成功三层判定；关键帧及时留存。
适用场景：节点不命中或命中错、点击偏移、流程卡死、选项未生效、交付前端到端验收等。
限制：仅限开发态、设备在线；事后日志与证据诊断不属本技能；协议原文与工具文档任一不可达时标记「未验证」；部分排障分支、性能排查、验收记录模板等标注为 TODO，暂未提供。