Agent Skills
返回列表
代码定位解决

代码定位解决

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 而非只留下代码片段。