调试策略
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/debugging-strategies。
技能介绍
调试里常见的问题
线上偶发失败、本地无法复现、堆栈指向框架而非业务代码——这类问题往往让人在改参数、重试和「感觉像是」之间空转。性能回归和分布式链路里的延迟,如果没有可观察信号和缩小范围的方法,排查成本会指数上升。
技能如何组织排查
本技能把流程固定为四步:先复现问题并收集日志、追踪与环境细节;再提出假设并设计受控实验;用二分查找和定向检测把嫌疑面收窄;最后记录发现并验证修复是否真正消除症状。需要更细的模式与检查清单时,可参照 resources/implementation-playbook.md。
适用场景包括:难以捉摸的错误、性能调查、生产事故、崩溃转储或堆栈分析、分布式系统调试。
适用边界
若问题没有可复现路径或可观察症状,或任务纯属功能开发、且无法访问日志、追踪或运行时信号,这套策略难以落地——应先补齐观测与复现条件,再按上述步骤推进。
使用场景
- 线上服务间歇性 500,需在保留日志与追踪的前提下复现并定位到具体模块或版本变更
- 发布后出现接口 P99 延迟升高,要用假设与二分法对比配置、依赖与代码路径
- 收到用户崩溃转储或完整堆栈,需从栈帧与环境信息反推根因并验证修复
- 微服务调用链中某环节超时,需结合追踪 ID 在多个节点间缩小故障范围
适合人员
- 负责线上稳定性、需在值班中快速复现并记录生产异常的后端工程师
- 性能回归发布后,要用受控对比而非盲目回滚来定位瓶颈的开发或平台同学
- 维护多实例部署、常处理堆栈与分布式追踪的 SRE 或基础设施工程师
- 跨服务联调时错误难以稳定复现,需要系统化假设与缩小范围的全栈或后端开发