mcpField
G
gitlab-ci-generator

gitlab-ci-generator

github.com/nextstage-brasil云与 DevOps046 次安装5 天前更新
代码仓库

关于 gitlab-ci-generator

用于为包含后端和前端的 SaaS 产品生成并调整 `.gitlab-ci.yml` 流水线的技能。它以指定模板为基础,适配仓库路径和命令,记录 CI 变量名称,并检查 YAML 与作业布局。

主要功能

  1. 01复制基础流水线模板
  2. 02适配路径、镜像和测试命令
  3. 03配置基于分支的部署规则
  4. 04记录 CI 变量名称
  5. 05检查 YAML 和作业布局

适用场景

  1. 01为前后端 SaaS 设置 CI
  2. 02按仓库目录结构调整流水线
  3. 03根据项目清单匹配测试和构建作业
  4. 04使用前检查流水线配置

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nextstage-brasil/skills --skill gitlab-ci-generator

安装后在 Claude Code 中输入/gitlab-ci-generator确认已加载。

附带文件evals/evals.jsonreferences/templates/gitlab-ci.template.yml

详细介绍

GitLab CI 生成器

为后端 + 前端 SaaS 布局生成 {product_root}/.gitlab-ci.yml。

Harness 探索

如果存在,请加载 {harness}/rules/infra-rules.mdc、backend-tests-rules.mdc、e2e-tests-rules.mdc。读取 {product_root}/docker-compose.yml。

适用场景

  • 创建或调整 .gitlab-ci.yml
  • product_class 为 saas 或 intelligent_saas(必须包含后端 + 前端)
  • 基于分支的测试/构建/部署

不适用范围

  • 仅包含 agent_runtime 的流水线
  • 超出模板约定的云资源配置

输入

  • 已确认 {product_root}
  • 目标分支(至少包括 develop、homolog、main)
  • E2E 文件夹名称(testes-cypress、tests-e2e 或 frontend/cypress)

工作流

A — 复制基线模板

将 references/templates/gitlab-ci.template.yml 复制到 {product_root}/.gitlab-ci.yml

对于独立的产品仓库:路径相对于产品根目录(backend/、frontend/)。

B — 必须进行的调整
项目操作
E2E 文件夹在 changes: 和作业 cd 中匹配产品文件夹
PHP 镜像与后端 Dockerfile 保持一致
测试命令与 composer.json / package.json 保持一致
锁文件在缓存键中使用 yarn.lock 或 package-lock.json
部署分支如果分支不是 main/homolog/develop,则调整正则表达式
禁用 E2E从部署作业的 needs 中移除 E2E 作业,或记录 RUN_REMOTE_E2E=false

不要复制其他产品的 CI 文件——只能使用此模板。

C — GitLab CI 变量

在可选文件 {product_root}/docs/context/ci-cd-notes.md 中记录:

  • ENV_BACKEND、ENV_FRONTEND、测试数据库变量、RUN_REMOTE_E2E、GCP 密钥——仅记录名称,不记录机密值
D — 验证

检查 YAML 语法;确认作业与仓库布局相符。

参考

文件使用时机
references/templates/gitlab-ci.template.yml流水线基线

相关技能

  • code-e2e-tests — E2E 文件夹约定
  • pm-e2e-test-generator — 规划 E2E 范围

评论

支持 Markdown