GitLab CI 流水线 Linter

为什么需要它

.gitlab-ci.yml 的语法错误往往要到触发 Pipeline 时才暴露，而语义层面的问题更隐蔽：依赖成环让流水线永久卡住、同名 job 被重复定义后静默覆盖、依赖关系明明可以合并却仍然串行等待。手动排查这类问题既耗时又容易遗漏，尤其配置规模增长到几十个 job 之后。

它的工作方式

该技能调用 GitLab CI Lint API（/api/v4/ci/lint）对配置进行校验，核心能力包括：

• 语法校验：解析 YAML 结构，报告语法错误与非法字段。
• DAG 循环检测：构建 job 之间的依赖图，找出由 needs / depends 关系形成的环。
• 冗余定义识别：检测重复的 job 定义，避免后者覆盖前者却无人察觉。
• 图优化建议：基于依赖关系推荐更精简的 needs 结构，减少不必要的串行等待。

调用流程大致为：读取仓库中的 .gitlab-ci.yml → 组装 lint 请求 → 解析返回结果并输出结构化诊断。整个过程只做静态分析，不触发任何实际构建。

适用边界

• 结果受 GitLab CI Lint API 当前校验规则的限制，规则未覆盖的问题不会报告。
• Lint 通过不代表运行时行为一定正确：变量、环境与 include 的实际解析仍依赖 GitLab 实例配置。
• 它只给出诊断与建议，不自动改写配置文件，合并前的修改需要人工确认。