用途：面向 CI 失败排查，帮助定位失败步骤、在本地复现问题、找到根因并修复，适用于 CI 变红、容器无法启动或需要本地复现 Bug 的场景。触发说法包括“修复失败的 CI”“调试这个流水线”“为什么 CI 红了”“容器无法启动”“复现这个 Bug”。
主要流程：一、收集上下文，先读 CI 日志，确认哪个步骤失败、错误信息或堆栈、与本地环境的差异；对 Bug 报告提取复现步骤，参考 bug-thread-extraction.md。二、本地复现，先复现再改代码，可运行与 CI 相同的命令，例如 npm ci && npm test，或用 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 掩盖失败。资料未提供更细的安装或配置说明。