系统调试专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/zhaono1-agent-playbook-debugger。
技能介绍
要解决什么问题
线上报错、本地能跑生产不行、异步竞态或「undefined 上读属性」这类问题,如果只靠直觉改代码,很容易在错误文件里打转。本技能面向可复现、可定位、可验证的调试流程,而不是泛泛的「看看日志」。
技能如何工作
触发条件包括:你主动报告 bug、说「debug this」、描述与预期不符的行为,或追问「为什么不行」。助手会按 playbook 分阶段推进:
- 理解问题:明确复现步骤、期望 vs 实际行为、错误信息与上下文。
- 隔离问题:结合堆栈、错误码与日志做关联;用二分注释、最小复现等方式缩小范围。
- 分析根因:对照常见类别(空值/类型、异步、状态、网络、环境、内存、并发等)选用调查路径。
- 形成假设:对每个可能原因提出假设、设计可执行的验证测试、确认或否定。
- 修复与验证:落地修改、必要时补日志、回归测试并防止再次发生。
此外还提供错误报文速查表、Divide and Conquer / 加日志 / 最小复现等模式,以及调试检查清单与 debug report 脚本输出结构(见 references)。
适用边界与注意点
- 技能强调的是方法论与排查清单,具体语言侧的命令与工具需结合你当前栈(如 JavaScript/TypeScript、Python、Go 章节)。
- 若问题无法稳定复现,应优先把精力放在复现条件与最小案例上,否则后续隔离与假设验证会失真。
- 修复阶段默认要求不破坏既有行为并考虑回归测试;不要将未经验证的猜测当作根因结论。
使用场景
- 生产环境出现堆栈报错,需要按复现步骤和日志把故障点缩到具体模块
- 本地改完仍偶发失败,怀疑异步竞态或状态未更新,要按类别表逐项验证
- 接口返回 Connection refused / Timeout,要从网络、端口与服务是否启动做结构化排查
- 修完 bug 怕被回归,需要按检查清单确认定位、根因、修复与回归测试都已闭合
适合人员
- 维护 Node/TS 服务的后端工程师,经常处理 `undefined` 与类型相关运行时错误
- 负责线上事故的同事,需要在工单里写清复现路径、假设验证与修复结论
- 写 Python/Go 脚本的开发者,遇到环境差异(本地可跑、部署失败)要对照环境类排查步骤
- Tech Lead 带新人排查时,希望对话按五阶段和错误报文表而不是随意改代码