Agent Skills
返回列表
💻

汐构四阶段根因调试

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据官方安装指南 https://skillhub.cn/install/skillhub.md ,在你的 AI 助手中安装名为 @user_51eaa4de/xigou-systematic-debugging 的技能。

技能介绍

你遇到的调试困境

在修代码时,容易陷入「看到错误就开始改」的循环:

  • 症状驱动的伪修复陷阱:错误信息指向的方向未必是根因(比如把异常信息中的 URL 直接改写成 mock 接口地址 - 根据推测可能出现类似场景),改完可能只是掩盖了真正的逻辑漏洞。
  • 变量爆炸导致的排查卡顿:当问题涉及多个模块交互时(如支付链路中的前端请求、后端验证、第三方回调),变量组合多到无法系统排查。
  • 上下文混乱放大调试难度:修改代码后未同步更新注释或文档(根据类似场景推测),导致后续维护者(甚至自己)需要重新理解「为什么这里要这么写」。

技能如何帮你做结构化排查

该技能的核心是通过三个循环能力 + 一张流程图实现流程化排查:

  • 分阶段执行的循环指令集(根据资料推测可能包含:复现问题→收集信息→定位根因→修复验证的循环步骤):每个阶段明确当前目标(如先确认异常类型,再验证环境依赖),避免跳过对不同类型异常(如语法错误、运行时错误、逻辑错误)的检查。
  • 可视化决策路径图(根据流程图分节点推测:包含异常类型索引、现有工具状态检查、缺失能力识别等分支):当排查时,可正在通过(推测可能匹配的)决策分支定位下一步操作(比如遇到超时异常时,不会直接重启服务,而是先确认网络请求是否被正确拦截)。
  • 分阶段聚焦核心任务控制:通过将排查过程拆分为多个循环(推测可能包括:信息收集循环→工具匹配循环→修复验证循环),减少多任务切换带来的认知负荷。

适用边界与使用提醒

  • 该技能的效果依赖你能正确提供信息:需保留代码逻辑所在的关键上下文(如函数调用链片段)和修改环境的提示词。
  • 流程图只是辅助你建立排查习惯的工具:遇到特殊问题时,仍需手动补充上下文(根据推测类似场景可能出现过的注意事项)。

使用场景

  • 修复支付回调超时问题时,需要在前端请求、后端验证、第三方接口之间定位究竟哪个环节出了问题
  • 线上接口偶发 502 错误,日志被截断无法复现,需要按结构化步骤从现有信息中推导根因
  • 接手他人维护的祖传代码,改了 A 模块后 B 模块的测试开始挂,需要梳理调用链并定位真正的影响要素
  • CI 流水线中单元测试间歇性失败,需要区分是代码逻辑变更、环境依赖版本漂移还是 mock 数据过时

适合人员

  • 独立开发者:一个人维护多个服务,遇到问题只能靠自己,需要一套不依赖团队的系统排查流程
  • 后端工程师:负责微服务架构中的某个服务,回调链路长、外部依赖多,定位跨服务故障时容易在信息不清时反复试错
  • 技术负责人:需要 review 他人提交的 bug 修复方案,希望对方能展示完整的根因分析过程而不是凭直觉改代码
  • 初级程序员:刚入行不久,看到报错习惯直接复制网上方案,需要养成先理解问题再动手修改的习惯