mcpField
N
ns-gitlab-ci-generator

ns-gitlab-ci-generator

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

关于 ns-gitlab-ci-generator

此技能根据仓库布局和项目配置生成或调整 SaaS 项目的 `.gitlab-ci.yml`。适用于包含后端与前端的项目，并通过分支配置测试、构建和部署流程。

主要功能

  1. 01复制基线 CI 模板
  2. 02适配端到端测试目录
  3. 03匹配镜像与测试命令
  4. 04配置分支部署规则
  5. 05检查 YAML 与任务布局

适用场景

  1. 01为 SaaS 仓库创建 GitLab CI
  2. 02按分支配置测试和部署
  3. 03根据项目结构调整 CI 任务

安装

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

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

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

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

详细介绍

GitLab CI 生成器

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

会话启动

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

适用场景

  • 创建或调整 .gitlab-ci.yml
  • product_class 为 saas 或 intelligent_saas（必须包含后端 + 前端）
  • 基于分支进行测试／构建／部署

不适用范围

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

输入

  • 目标分支（至少包括 develop、homolog、main）
  • E2E 文件夹名称（testes-cypress、tests-e2e 或 frontend/cypress）

工作流

A — 复制基线

将 references/templates/gitlab-ci.template.yml 复制到 .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 变量

在可选的 docs/context/ci-cd-notes.md 中记录：

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

检查 YAML 格式；确认作业与仓库布局匹配。

参考资料

文件适用场景
references/templates/gitlab-ci.template.yml基线流水线

相关技能

  • ns-e2e-tests — E2E 文件夹约定
  • ns-spec-driven references/e2e-test-task-generator.md — 规划 E2E 范围

评论

支持 Markdown