---
name: fec-debug
description: 前端问题诊断与修复：覆盖构建失败、运行时错误、UI 异常、接口问题，使用统一诊断框架按类型分流。
---

按 `fec-debug-framework` 执行前端问题诊断与修复。先分类问题类型（build / runtime / ui / api），再进入对应诊断模块执行 5 步法（分类→收集→假设→验证→修复）。复杂或跨类型问题可委托 **`fec-debugger`** 子代理。

## 问题类型速查

| 类型    | 典型场景                                        |
| ------- | ----------------------------------------------- |
| build   | lint/type-check/test/build/CI 失败              |
| runtime | JS 异常、白屏、组件渲染错误、路由异常、状态丢失 |
| ui      | 样式错位、交互异常、动画卡顿、响应式问题        |
| api     | 请求失败、超时、数据不一致、CORS、缓存问题      |

## 执行步骤

1. 读取用户描述的问题，按 `fec-debug-framework` Step 1 分类问题类型。
2. 进入对应诊断模块，执行 Step 2 收集证据。
3. 基于证据提出假设（Step 3），逐一验证（Step 4）。
4. 确认根因后执行最小修复（Step 5），运行受影响验证命令。
5. 输出诊断报告到 `reports/debug-YYYY-MM-DD-HHmmss.md`。

## 强约束

- 不通过关闭规则、删除测试或降低类型安全来「修复」问题
- 不顺手重构无关代码
- 不在缺少证据时猜测根因
- 修复后必须验证，不能只改不测