用途
Debug Operations 是一套面向软件缺陷排查的系统化调试技能，将调试过程从零散尝试转变为可重复的方法论。它适用于崩溃、卡死、输出错误、性能下降以及间歇性故障等问题的定位与修复，并强调从症状追溯到根因，再通过回归测试与文档更新防止同类问题再次出现。
主要能力
Bug 分类决策树
技能提供一棵从症状出发的决策树，帮助快速缩小排查范围：
- 崩溃：区分段错误/访问违规（空指针、缓冲区溢出、释放后使用、栈溢出）、Panic/致命错误（断言失败、不可恢复状态、内存耗尽）与未处理异常（缺少错误处理、意外输入类型、网络失败）。
- 卡死：区分死锁（锁顺序、互斥锁争用、通道阻塞）、无限循环（循环终止条件、计数器溢出、递归调用）与阻塞 I/O（网络超时、DNS 解析、磁盘满、文件锁）。
- 输出错误：区分逻辑错误（运算符优先级、边界条件、布尔逻辑）、数据损坏（并发修改、编码不匹配、截断）与差一错误（循环边界、数组索引、栅栏柱错误）。
- 性能问题：区分慢查询（缺少索引、N+1 查询、全表扫描、锁等待）、内存膨胀（无淘汰缓存、引用泄漏、大分配）与 CPU 尖峰（热循环、正则回溯、过度 GC、忙等待）。
- 间歇性故障：区分竞态条件（共享可变状态、读-改-写、检查后行动）、时序依赖（超时值、时钟偏移、事件顺序假设）与环境特定（操作系统差异、区域设置、时区、文件系统大小写敏感）。
六步系统化调试工作流
- 复现：确认缺陷存在并建立可靠复现，记录精确输入、环境与操作序列。
- 隔离：将故障缩小到最小范围，使用二分查找（git bisect、注释代码对半）、桩、功能开关与环境隔离。
- 定位：找到根因而非近因，使用 5 Whys、执行追踪与关键点状态检查，区分症状与底层缺陷。
- 修复：应用针对根因的最小正确改动，避免散弹式调试，理解修复为何有效。
- 验证：确认修复解决原问题且不引入回归，重跑原始复现用例、完整测试套件与相关边界用例。
- 预防：添加回归测试，更新文档或运行手册，考虑同类缺陷是否存在于别处，并与团队分享发现。
复现检查清单
技能提供一份复现检查清单，涵盖：最小复现步骤是否已编号且无歧义、环境是否记录（操作系统、运行时版本、依赖、配置）、精确输入是否记录（请求负载、命令行参数、文件内容）、时序敏感性是否评估、是否尝试单线程复现、复现是否自动化、是否确认确定性失败、是否识别复现所需特定数据或状态。
隔离技术速查表
技能列出多种隔离技术及其适用场景：git 二分查找（定位引入缺陷的提交）、代码二分查找（注释一半代码反复测试）、桩/模拟（用已知正常的假实现替换依赖）、功能开关（逐个关闭功能）、环境隔离（Docker 容器、全新虚拟机、干净安装）、网络拦截（mitmproxy、Charles Proxy、模拟服务器）、输入缩减（逐步移除输入字段/数据直到缺陷消失）、依赖锁定（锁定所有依赖后逐个更新）。
根因分析模板
技能提供 5 Whys 示例与故障树基础。5 Whys 示例以“API 登录返回 500 错误”为例，逐层追问至根因（部署脚本的 --fast 标志跳过迁移），并给出修复与预防措施。故障树部分说明从观察到的失败向下追溯到根因叶子节点，每个分支为 AND/OR 门。
语言专属调试器速查
技能整理多种语言与工具的启动命令和关键命令：
- Node.js：Chrome DevTools（node --inspect-brk app.js，打开 chrome://inspect 设置断点）、ndb（npx ndb app.js）。
- Python：pdb（python -m pdb script.py，n/s/c/p/bt）、debugpy（python -m debugpy --listen 5678 --wait-for-client script.py，VS Code 附加配置）、breakpoint()（Python 3.7+ 在代码中插入断点）。
- Go：Delve（dlv debug ./cmd/server，b/c/n/p）、Delve 测试（dlv test ./pkg/...）、Delve 附加（dlv attach PID）。
- Rust：rust-gdb（rust-gdb target/debug/myapp）、rust-lldb（rust-lldb target/debug/myapp）、CodeLLDB（VS Code 扩展）。
- 浏览器：DevTools（F12 或 Ctrl+Shift+I，Elements、Console、Network、Sources、Performance、Memory）。
快速调试片段
技能提供各语言快速进入调试器的代码片段，例如 Node.js 的 debugger 语句与条件断点、Python 的 breakpoint() 与条件断点、Go 的 runtime/debug.PrintStack() 与 SIGQUIT、Rust 的 RUST_BACKTRACE=1 与 RUST_BACKTRACE=full。
基于日志的调试模式
技能介绍策略性日志放置（入口、状态、分支、出口、错误）、关联 ID（在入口生成 X-Request-ID 并跨服务传播，用 rg 搜索）、时间线重建（合并排序多源日志、查找活动间隙）、结构化日志查询（jq 查询 JSON 日志，如按用户筛选错误、慢请求耗时分布、按类型统计错误）。
常见调试陷阱
技能列出常见陷阱及修复方式，包括：只修症状不修根因、生产环境无安全网调试、海森堡 bug（观察时消失）、假设偏见、缺少复现用例、过度依赖打印/日志调试、不检查最近改动、忽略警告信息、调试错误版本/分支、不读完整堆栈跟踪、一次改动多个地方、未捕获“之前”状态。
使用方式
该技能以参考文档形式组织，包含三份参考文件：
- references/systematic-methods.md（约 600 行）：科学方法、二分查找、增量调试、差分调试、时间旅行调试、团队调试。
- references/tool-specific.md（约 650 行）：浏览器 DevTools、Node.js、Python、Go、Rust、数据库、网络、Docker 调试工具。
- references/common-scenarios.md（约 550 行）：内存泄漏、死锁、竞态条件、性能回退、API 调试、部署问题。
使用时可根据当前缺陷类型查阅对应章节，按六步工作流推进，并借助决策树与速查表快速定位工具与排查方向。
适用场景
适用于开发与运维过程中需要定位崩溃、卡死、输出错误、性能问题与间歇性故障的场景，尤其适合需要跨语言调试、根因分析与回归预防的团队。
限制
技能资料未提供具体安装命令、收费方式、平台支持范围或效果保证。部分内容（如参考文件行数）为资料中标注的近似值。实际使用效果取决于具体环境与问题复杂度。