系统化调试与根因分析
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/siviter-xyz-dot-agent-debugging。
技能介绍
要解决什么问题
错误堆栈、偶发异常和「本地能跑、线上不对」往往让人在改代码和猜原因之间打转。没有固定流程时,容易一次改一大片、引入回归,或在 CI 红掉后仍不清楚根因在哪一层。
技能如何工作
本技能把调试当成可重复的工程流程,而不是随手试错:
- 证据优先:从错误信息、日志和可复现步骤出发,而不是凭感觉改
- 六步流程:捕获错误 → 最小复现 → 隔离失败点 → 假设验证(含调试日志)→ 最小修复 → 验证无回归
- 策略性日志:在入口/出口、状态变迁、分支与外部调用等位置打点,问题解决后再决定是否保留
- 错误模式:对照常见类别(空值/类型、时序、状态污染、配置等),参见资料中的模式说明
- 修复收尾:强调 CI(类型、测试、lint)、原子化提交与语义化 commit,并在提交前与用户确认
适用边界与注意点
它侧重根因分析与修复纪律,不替代你本地的调试器或性能剖析工具;references/ 中的文档需要你在上下文中按需引用。对无法稳定复现的分布式/竞态问题,仍需结合环境隔离与更长观测周期,技能提供的是结构化思路而非万能答案。
使用场景
- 单测或集成测试失败,需要按堆栈和日志缩小到具体函数再改最小补丁
- 生产或预发出现异常信息,要先整理复现条件再动代码
- 线上行为与预期不符,想在关键分支和外部 API 调用处加临时调试日志定位
- 修完 bug 后要让类型检查、测试和 lint 在 CI 里全绿再组织提交
适合人员
- 负责维护共享代码库、希望每次修 bug 都留下可复现步骤与验证记录的后端工程师
- 在 Code Review 里常被追问「为什么这样改」、需要按假设—证据链写清调试过程的全栈开发者
- 发布前 CI 偶发失败、要在不扩大 diff 的前提下定位最近变更或依赖问题的 DevOps 同学
- 带新人排障时想用统一六步流程和错误模式清单减少随手大改的团队 Tech Lead