2. **确保数据加载完成**：使用 `await` 或检查 Promise 状态
3. **添加默认值**：使用 `data ?? []` 防止 undefined

## 📚 参考资料
- [MDN: undefined 处理](https://developer.mozilla.org/...)
- [Stack Overflow: Cannot read property of undefined](https://stackoverflow.com/...)

调试伴侣 SKILL.md

你的专属调试助手 —— 粘贴错误信息，立即得到根因分析和修复方案

技能简介

调试伴侣（Debug Companion）是一个 OpenClaw 技能，专门帮助开发者快速定位和修复代码错误。

核心能力

• - 🔍 智能解析：自动识别错误类型、文件位置、行号
• 🎯 根因分析：用大白话解释为什么会出错
• ✅ 修复建议：给出具体操作步骤，甚至直接生成补丁
• 📚 参考资料：附赠类似问题的解决方案链接

支持语言

语言	状态
Python	✅
JavaScript / Node.js

✅ | | TypeScript | ✅ | | Go | ✅ | | Java | ✅ | | C++ | ✅ | | Rust | ✅ | | PHP | ✅ | | Ruby | ✅ |

---

工作流程

用户发送错误信息/traceback
↓
错误信息解析
（提取错误类型、文件、行号）
↓
智能搜索
（Tavily + Code Search）
↓
根因分析 + 修复建议
↓
结构化输出

---

使用方式

触发词

用户发送以下内容时会激活技能：

• - 调试 + 错误信息
• 报错 + traceback
• 出了个bug
• 这个错误怎么修
• 直接粘贴错误信息/traceback

输入格式

推荐格式：

[错误类型]: [错误描述]
File [文件], line [行号], in [函数名]
[代码]
[更多堆栈信息]

示例：

TypeError: Cannot read property map of undefined
at processData (/app/utils.js:15:20)
at handleRequest (/app/server.js:42:10)

可选上下文

上下文	说明	示例
语言	指定编程语言	Python、JavaScript
代码片段

相关代码 | 粘贴出错的代码 | | 环境信息 | OS、版本等 | Node.js v18、Python 3.11 |

---

输出格式

markdown

🔍 错误解析

错误类型：TypeError
问题文件：/app/utils.js:15
问题描述：在 processData 函数中尝试调用 .map()，但数据是 undefined

🎯 根因分析

你正在对 data 变量调用 .map() 方法，但这个变量是 undefined。这通常是因为：

1. 1. API 返回的数据结构不符合预期
2. 异步操作尚未完成就开始处理
3. 数据获取函数出错返回了空值

✅ 修复建议

1. 1. 添加防御性检查：在使用 .map() 前检查 data 是否存在

javascript if (!data) { console.error(数据不存在:, data); return []; }

1. 2. 确保数据加载完成：使用 await 或检查 Promise 状态
2. 添加默认值：使用 data ?? [] 防止 undefined

📚 参考资料

• - MDN: undefined 处理
• Stack Overflow: Cannot read property of undefined

---

错误类型速查表

错误类型	常见原因
TypeError: Cannot read property X of undefined	访问了 undefined/null 的属性
ReferenceError: X is not defined

变量未定义或拼写错误 | | SyntaxError | 语法错误，缺少括号/引号等 | | IndexError: list index out of range | 数组索引越界 | | KeyError: X | 字典/对象没有这个键 | | NullPointerException | 空指针调用 | | ENOENT: No such file or directory | 文件路径错误 | | Permission denied | 权限不足 |

---

工具调用

技能内部使用以下工具：

工具	用途
tavilysearch	搜索类似问题的解决方案
codesearch

搜索官方文档和权威教程 |
| web_fetch | 抓取详细修复方案页面 |

---

注意事项

1. 1. 隐私安全：如果错误信息包含敏感路径或密钥，会自动脱敏处理
2. 上下文重要：提供更多代码上下文能获得更准确的建议
3. 版本相关：某些错误在不同版本语言中处理方式不同，请提供版本信息
4. 二次确认：涉及代码修改时，建议先在测试环境验证

---

示例对话

用户：

js报错：TypeError: Cannot read property map of undefined
at processData (utils.js:15:20)
at handleRequest (server.js:42:10)

调试伴侣：
（按上方输出格式返回完整分析）

---

更新日志

• - 2026-03-27：v1.0.0 初始版本

- 支持8种主流语言 - 错误解析+根因分析+修复建议 - Tavily搜索+代码搜索双保险