关于 gitlab-ci-generator
用于为包含后端和前端的 SaaS 产品生成并调整 `.gitlab-ci.yml` 流水线的技能。它以指定模板为基础,适配仓库路径和命令,记录 CI 变量名称,并检查 YAML 与作业布局。
主要功能
- 01复制基础流水线模板
- 02适配路径、镜像和测试命令
- 03配置基于分支的部署规则
- 04记录 CI 变量名称
- 05检查 YAML 和作业布局
适用场景
- 01为前后端 SaaS 设置 CI
- 02按仓库目录结构调整流水线
- 03根据项目清单匹配测试和构建作业
- 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