用途：/debug-extension 用于排查已构建 .ppmplugin 控件在测试中出现的故障，包括崩溃、点击无反应、PCF 报错（ErrorCode/ErrorMessage）、宿主日志异常或行为不正确。由于 wrap 二进制运行在客户 shell 中，无法使用 logcat、Xcode 控制台或原生调试器，证据通常只有 PCF 错误码、原始 <name>Json 诊断输出、宿主日志行或用户描述。
主要能力：以调查为先，先定位根因再改代码。流程包括：验证是否为扩展仓库（需 PRD.md 与 package.json，建议有 ARCHITECTURE.md）；读取共享文档、PRD、ARCHITECTURE、manifest 与 .extension-state.md；收集 bug 报告；按症状映射到候选层（PCF/传输、分发契约、Android/iOS 原生模块、原生加载/生命周期、构建配置/RN 版本、行为/规格）；沿分发路径追踪并收集证据；给出带证据的排序诊断与置信度；区分代码漂移、规格错误或两者兼有；制定修复计划并等待确认后应用；应用后按自省协议复查；最后验证修复。
使用方式：在扩展仓库中调用该技能，提供症状、错误码、原始 Json、宿主日志、平台与复现步骤。修复涉及 PCF 时运行 npm run build --prefix "$PCF_DIR"；仅原生文件改动则需重新构建并在设备上验证。
适用场景：设备上出现故障且原因不明时；已知要改什么的功能变更应直接编辑，不必走此技能。
限制：不生成脚手架、不安装依赖、不构建二进制、不组装 bundle；无扩展仓库时拒绝运行；若需 PCF 编辑但 pcf/ 未搭建，会提示先运行 /generate-pcf-companion；证据不足时要求补充信息，不编造修复。具体命令、参数与平台细节以资料为准，其余暂未提供。