智能调试助手

从错误信息快速定位问题根因，给出修复建议。

输入方式

接受以下任一形式：

• 错误信息文本（如 TypeError: Cannot read properties of undefined）
• 控制台日志片段
• 异常行为描述（如”组件反复渲染，页面卡顿”）
• 指定文件路径 + 问题描述

调试流程

1. 错误分类

根据输入信息归类：

2. 上下文收集

根据分类，自动执行对应的上下文收集：

通用步骤（所有类别都执行）：

1. 读取 package.json 识别技术栈和框架版本
2. 如果提供了文件路径，读取相关文件

按类别额外收集：

3. 模式匹配

将错误信息与常见前端错误模式进行匹配，快速给出方向。

高频错误速查

TypeError: Cannot read properties of undefined (reading ‘xxx’)

• 排查：可选链缺失 obj?.prop、API 返回结构变化、异步数据初始状态为 undefined
• 修复：添加空值保护、设置默认值、检查数据流

TypeError: xxx is not a function

• 排查：导入错误（default vs named export）、版本升级 API 变更、异步加载未完成
• 修复：检查 import 语句、查阅库的 changelog

Maximum update depth exceeded / Too many re-renders

• 排查：useEffect 依赖数组缺失/错误、setState 在 render 中调用、对象/数组引用不稳定
• 修复：修正依赖数组、使用 useMemo/useCallback 稳定引用

Cannot update a component while rendering another

• 排查：在渲染阶段调用了 setState（来自子组件的回调、context 更新）
• 修复：将更新移至 useEffect 或事件处理函数中

Objects are not valid as a React child

• 排查：渲染了原始对象 {obj}、日期对象未转字符串、Promise 未解析
• 修复：JSON.stringify 或提取具体字段

Vue: [Warn] Invalid prop type / Missing required prop

• 排查：PropTypes 定义与传入不匹配、组件 API 变更
• 修复：检查组件文档、修正 prop 传入

Vue: [Warn] Avoid using non-primitive value as key

• 排查：v-for 的 key 使用了对象而非原始值
• 修复：使用唯一 ID 字段作为 key

4. 输出格式

## 🔍 诊断结果

**错误类型**：[分类]
**根因**：[一句话说明]

### 问题定位
- 文件：`path/to/file.tsx`
- 行号：约 L42（基于堆栈 / 代码分析）
- 代码片段：
  ```tsx
  // 问题代码

修复建议

// 修复后的代码

预防措施

• [如何避免同类问题]

## 与 BugHunter 的分工

| 场景 | 使用工具 |
|------|---------|
| 拿到一个错误信息，想快速定位修复 | **smart-debugger**（本 skill） |
| 收到 Redmine Bug 工单，需要完整修复闭环 | **BugHunter**（subagent） |
| 难以定位的复杂 Bug，需要深度分析 | 先用 smart-debugger 初诊 → 转 BugHunter |