代码定位解决
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_50b005fe/skill-code-problem-solving。
技能介绍
你在排什么错
线上或本地报错时,常见做法是直接搜错误关键词,结果往往是几年前的博客、版本对不上的「偏方」,改完反而引入新问题。真正需要的是:先对齐权威来源,再按优先级逐级降级检索,并把根因、验证步骤和出处写清楚。
技能如何工作
本技能执行 「官方优先逐级溯源排错」 规范,按固定层级检索,不跳级:
- Level 1:官方文档(API、故障排查、FAQ)与官方仓库(
CHANGELOG、示例、测试用例) - Level 2:仓库 Issues / Discussions,优先维护者回复与已修复版本
- Level 3:国内技术社区(掘金、CSDN 等),仅在前两级无结果时使用,并对照官方文档验证
- Level 4:Stack Overflow、Reddit 等英文讨论
- Level 5:通用搜索引擎,过滤水文与搬运
输入侧建议带上 problem_description、可选的 error_stack_trace、framework_version 与 context;输出包括 rootcause、solutionsteps、verification、prevention 与 sources 权威链接列表。
适用边界
适合具体可描述的软件故障、编译/运行时错误、框架用法疑点。不要用于与排障无关的编码风格讨论、项目管理或过于模糊、无法识别技术栈的问题;从第三方社区采纳方案前,应回查官方文档确认版本兼容。
使用场景
- React 运行时抛出 `Cannot read property 'map' of undefined`,需要按官方文档与仓库 Issues 逐级检索并输出可验证的修复步骤。
- TypeScript 或构建工具升级后编译失败,需对照 CHANGELOG 与同版本 Issues 判断是已知缺陷还是本地配置不兼容。
- 生产告警里只有完整异常堆栈、对业务模块不熟,需要结构化给出根因、验证步骤并附上权威来源链接。
- 网上搜到的框架排障文章在本机无效,需要回查官方文档核对版本后再走 Level 1–2 重新定位。
适合人员
- 负责线上告警与工单的一线工程师,拿到用户或监控里的堆栈后要避免乱试偏方,需要根因、验证步骤和出处。
- 刚接手遗留代码库的维护开发,遇到框架报错时不清楚应先查官方文档还是直接搜社区文章。
- 主导依赖或主版本升级的同学,需要在报错后区分 breaking change、已知 bug 与项目自身用法问题。
- 需要写事故或排障复盘的技术同学,希望每次结论都能链回官方文档或 Issue 而非只留下代码片段。