用途：调试失败的 CI 流水线、容器启动失败，以及在本地复现 bug。适用于 CI 变红、容器无法启动、需要复现缺陷等场景。触发说法包括“fix failing CI”“debug this pipeline”“why is CI red”“container won't start”“reproduce this bug”。
主要能力与流程：
- 收集上下文：先读 CI 日志，确认哪一步失败、错误信息或堆栈、与本地环境的差异；对 bug 报告提取复现步骤，参考 bug-thread-extraction.md。
- 本地复现：不要盲改代码，先复现失败。可运行与 CI 相同的命令，如 npm ci && npm test；或匹配 CI 环境，如 docker build -t debug-image . 后 docker run --rm debug-image npm test。
- 定位根因：常见 CI 失败模式见 ci-patterns.md，包括依赖版本不匹配、缺少环境变量、时序/竞态条件、平台差异（Linux 与 macOS）、容器问题（见 docker-debug.md）。
- 修复：解决真实问题而非症状，如显式固定依赖版本、在 CI 配置中补充缺失的环境变量、用合理等待修复不稳定测试、使用跨平台路径。
- 验证：推送修复并确认 CI 通过，使用 git push && gh run watch，未变绿不算完成。
限制与反模式：不要靠重跑 CI 碰运气、不要在未复现 CI 环境的情况下本地修复、不要禁用失败测试、不要加宽泛的 || true 掩盖失败。资料未提供具体安装方式、收费或平台信息。