用途：在配置 GitLab CI/CD 流水线、定义阶段（stages）或设置 workflow 规则时使用，覆盖流水线结构、阶段顺序与执行流程。
主要能力：可在 .gitlab-ci.yml 中声明 stages 顺序（如 build、test、deploy），设置 default 的 image、before_script 与 cache（示例使用 node:20-alpine、npm ci --cache .npm --prefer-offline，缓存路径 .npm/）；通过 workflow.rules 按分支、标签或流水线来源控制触发，例如 $CI_PIPELINE_SOURCE == "merge_request_event"、$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH；同一 stage 内可并行运行多个 job（如 test:unit、test:integration、test:e2e）；用 needs 构建 DAG 流水线，可指定依赖或留空 [] 立即执行；通过 include 引入本地文件、其他项目模板或 GitLab 内置模板（如 Security/SAST.gitlab-ci.yml）；workflow.auto_cancel 可设置 on_new_commit: interruptible 取消冗余流水线。
使用方式：在仓库根目录编辑 .gitlab-ci.yml，按 stages、default、workflow、job 的 script 与 needs 组织配置，并可用 include 拆分大配置。资料中给出的最佳实践包括：明确阶段顺序、用 needs 优化执行、用 workflow 规则避免不必要流水线、用 include 拆分配置、为可取消 job 设置合适的 interruptible 标志。
适用场景与限制：适用于 GitLab CI/CD 流水线设计与维护。资料未提供安装命令、收费或价格、平台支持范围及具体版本限制，部分内容以示例形式呈现，实际使用需结合项目情况调整。