代码问题解决
使用官方优先逐级溯源排错方法论进行系统化的软件问题故障排查。当用户需要排查软件问题或搜索权威解决方案时调用此技能。
概述
本技能遵循 「官方优先逐级溯源排错方法论」，提供标准化软件开发问题定位检索规范。采用权威源自上而下逐层降级检索，拒绝直接搜第三方博客，最大化避免过时、错误、偏方解决方案，减少踩坑。
何时使用此技能
当出现以下情况时使用此技能：
- 用户遇到需要故障排查的软件错误或缺陷
- 用户需要诊断和解决技术问题
- 用户在搜索框架/工具使用疑问
- 用户不确定如何搜索技术解决方案
- 用户需要权威、可靠的解决方案而非一般性建议
何时不要使用此技能
以下情况不要使用此技能：
- 用户寻求与故障排查无关的一般性编码建议或最佳实践
- 用户询问与故障排查无关的主题（如项目管理、设计模式）
- 用户寻求营销或商业建议
- 用户查询过于模糊，无法识别具体的技术问题
输入/输出结构
输入
| 参数 | 类型 | 描述 | 示例 |
|---|---|---|---|
problem_description |
string | 问题或错误的详细描述 | "在React项目中遇到错误：Cannot read property 'map' of undefined" |
error_stack_trace |
string (可选) | 可用的完整错误堆栈 | "TypeError: Cannot read property 'map' of undefined at Component.js:45" |
framework_version |
string (可选) | 正在使用的框架/工具版本 | "React 18.2.0", "TypeScript 4.9" |
context |
string (可选) | 环境或设置的额外上下文 | "使用Node.js v18 on Windows，项目使用Vite创建" |
输出
| 组件 | 描述 |
|---|---|
root_cause |
问题的根本原因 |
solution_steps |
解决问题的分步说明 |
verification |
验证解决方案有效的步骤 |
prevention |
防止问题再次发生的建议 |
sources |
查阅的权威来源列表 |
执行步骤
Level 1：官方一手权威资料（最高优先级）
步骤 1.1：官方文档搜索
- 在官方文档的API参考、故障排查或FAQ章节中搜索具体错误
- 查找与该错误相关的已知问题或错误列表
- 检索解释错误原因和解决方案的相关文档章节
步骤 1.2：官方源码仓库
- 检查相关项目的官方源码仓库（GitHub/Gitee/GitLab）
- 查看源码注释、示例或测试用例，这些可能展示问题或其解决方案
- 查看变更日志（CHANGELOG），确认当前版本是否存在该bug或是否已修复
Level 2：官方社区问答（第二优先级）
步骤 2.1：仓库内置讨论区 Issues/Discussions
- 在仓库的错误跟踪器中搜索相同的错误堆栈或类似问题
- 筛选维护者回复的官方临时解决方案或修复版本
- 若无现成答案，可查看社区临时变通方案（需谨慎甄别）
Level 3：国内专业技术社区（第三优先级）
仅当Level 1-2无结果时再检索
步骤 3.1：搜索专业技术社区
- 在掘金、CSDN、博客园、阿里云开发者社区等平台搜索
- 优先筛选高赞、带版本号的复现代码文章
- 应用前需对照官方文档验证解决方案
Level 4：全球通用开发者社区（海外补充）
步骤 4.1：国际平台
- 在Stack Overflow、Reddit r/编程板块、Dev.to搜索英文错误讨论
- 对于开源框架和工具类错误，完整错误消息的搜索命中率极高
Level 5：通用搜索引擎（最后一步）
步骤 5.1：搜索引擎
- 仅在所有其他渠道无匹配时使用百度/Google
- 过滤自媒体水文和搬运文
配套实操技巧
精准检索能力
- 复制完整异常堆栈、报错原文、框架版本号一起搜索
- 杜绝模糊关键词
版本过滤意识
- 检索时过滤过时版本解决方案
- 只匹配项目当前使用版本
方案验证习惯
- 从第三方社区拿到方案后，回查官方文档确认兼容性
- 不直接复制运行
沉淀复盘习惯
- 解决问题后，补充记录官方原始解决方案链接，留存备忘
- 避免重复检索
失败策略
如果 Level 1（官方文档）失败：
- 验证错误描述是否准确完整
- 检查框架版本是否与文档版本匹配
- 如无相关文档，进入 Level 2
如果 Level 2（官方Issues）失败：
- 在问题跟踪器中尝试不同的搜索关键词
- 检查问题是否已关闭但无解决方案
- 使用更具体的搜索词进入 Level 3
如果 Level 3（国内社区）失败：
- 验证所搜索社区是否与技栈相关
- 考虑问题是否过于小众无法公开讨论
- 使用英文搜索词进入 Level 4
如果 Level 4（国际社区）失败：
- 检查问题是否可能是新发现的尚未记录的错误
- 考虑准备最小可复现案例提交社区
- 作为最后手段进入 Level 5
如果 Level 5（通用搜索）失败：
- 问题可能非常具体或新发现
- 建议用户向官方仓库报告问题并提供最小可复现案例
- 建议基于已记录的类似模式提供临时变通方案
使用示例场景
场景1：遇到报错信息
用户输入： "我在React项目中遇到这个错误：Cannot read property 'map' of undefined"
技能执行流程：
1. Level 1：搜索React官方文档关于map属性undefined的说明
2. Level 2：在React GitHub Issues中搜索相同错误堆栈
3. Level 3：如前两级无结果，再搜索掘金、CSDN等技术社区
4. Level 4：搜索Stack Overflow英文相关讨论
5. Level 5：最后使用Google/Baidu通用搜索
场景2：排查依赖版本冲突
用户输入： "TypeScript 4.9版本在编译时报错，不知道是不是版本问题"
技能执行流程：
1. Level 1：查阅TypeScript官方CHANGELOG，确认4.9版本已知问题
1. Level 1：查看TypeScript官方文档关于版本兼容性的说明
2. Level 2：搜索TypeScript GitHub Issues中关于4.9版本的报错
3. 依此逐级检索
技能原则
- 始终遵循官方优先原则
- 按顺序逐级检索，不可跳过
- 优先验证官方来源方案
- 记录解决方案链接便于后续复盘
