用途:诊断并优化 CI/CD 流水线,适用场景包括反馈时间中位数或 p95 过长、运行器排队久、重复的 setup 或依赖恢复、缓存未命中与传输昂贵、测试耗时或不稳定、重复/过期/无关运行、运行器规格与池争用、CI 成本、监控已推送提交直至最终结论、部署流水线收敛与产物一致性。不适用于:无性能问题的一行 YAML 语法修正;应用运行时性能(端点、页面加载);非优化目标的部署执行;代码审查或产品缺陷排查。
主要能力:按“框定—测量—定位关键路径—选择单一有界实验—在精确 SHA 上远端验证—停止”的流程工作。先区分排队、setup、执行、传输、收尾耗时;用同提交的可比运行取中位数与 p95、缓存命中率、各作业耗时与 DAG;按真实依赖定位关键路径。优化顺序为:不启动它、取消过期工作、复用已验证工作、缩短路径、减少传输字节,最后才加算力。
使用方式:接触工作流 YAML 前先读 references/optimization-workflow.md;测量协议见 references/measurement.md;按主导瓶颈路由到对应参考文件,例如 github-actions、caching、testing-and-flakiness、containers、deployment 等。验证已推送提交可用 scripts/ci-watch.py(不要读其源码,--help 说明契约)。
限制与授权边界:读取配置与历史、计算基线、起草建议、按请求编辑本地文件、运行校验器属正常工作;而推送或合并超出要求内容、取消或重跑他人 CI、删除缓存、更改 CI/组织/仓库设置或防火墙、SSH 进入在线运行器、部署/提升/回滚/生产迁移、削弱或跳过任何门禁,均需每次显式授权。不得为“更快”删除或绕过必需测试与安全门禁。仅在测得瓶颈与容量支持时才引入 Bazel、远程执行、自托管机群等重型机制。验证须针对精确 head_sha 与产物摘要,过期 SHA 或重试变绿不算证据;无法证明变更文件、合并基线、缓存正确性、图完整性或安全范围时,回退到完整验证。报告需含基线、关键路径证据、精确改动、前后匹配运行与 run ID、有效性检查、成本影响、剩余风险与回滚、达到的证据层级;缺失证据须明确说明。