GitLab CI 流水线验证器

什么时候会出问题

.gitlab-ci.yml 的改动通常不会在编辑器里直接报错：stage 之间引用错、job 依赖未声明、artifact 路径拼错，或者 rules 条件写偏，都要等到流水线创建、MR 合并或部署前才暴露。这类问题经常导致三类浪费：排查信息散落在 CI 日志、失败发生在多人协作之后、修复成本随着流水线复杂度升高。

它怎么验证配置

这个技能把配置文件当作需要校验的输入，而不是等到 GitLab 运行流水线时再发现错误：

• 读取项目里的 .gitlab-ci.yml，把它交给 gitlab-ci-lint API endpoint 做 schema 校验；
• 检查 stage、needs、artifacts、rules 等关键字段是否符合 GitLab CI/CD schema；
• 在提交或合并前暴露 stage 依赖错误、无效 artifact 路径，以及明显配置错乱的 rules；
• 给出可定位的校验结果，方便开发者先修配置，再进入真实流水线。

适用边界

它适合作为提交前的快速门禁，用来拦截 schema 层和常见配置冲突；但它不是完整模拟运行器。运行环境、变量注入、protected branch、标签匹配、runner 可用性和真实 job 行为仍需要在 CI 或 dry-run 中确认。