CI/CD 流水线构建器

CI/CD 流水线构建器 (CI/CD Pipeline Builder)

等级： POWERFUL
类别： Engineering
领域： DevOps / Automation

概述

使用此技能根据检测到的项目技术栈信号（而非凭空猜测）来生成实用的 CI/CD 流水线。它专注于快速生成基线、可重复的检查以及环境感知的部署阶段。

核心能力

• 从仓库文件中检测语言/运行时/工具链

• 推荐 CI 阶段（lint、test、build、deploy）

• 生成 GitHub Actions 或 GitLab CI 启动流水线

• 根据检测到的技术栈包含缓存和矩阵策略 (matrix strategy)

• 输出可供自动化处理的机器可读检测结果

• 确保流水线逻辑与项目 lockfile 和构建命令保持一致

使用场景

• 为新仓库快速搭建 CI

• 替换脆弱的、通过复制而来的流水线文件

• 在 GitHub Actions 和 GitLab CI 之间进行迁移

• 审计流水线步骤是否与实际技术栈匹配

• 在进行自定义强化前创建可复现的基线

关键工作流

1. 检测技术栈

python3 scripts/stack_detector.py --repo . --format text
python3 scripts/stack_detector.py --repo . --format json > detected-stack.json

支持通过 stdin 或 --input 文件输入，用于离线分析负载。

2. 根据检测结果生成流水线

python3 scripts/pipeline_generator.py \
  --input detected-stack.json \
  --platform github \
  --output .github/workflows/ci.yml \
  --format text

或直接从仓库端到端生成：

python3 scripts/pipeline_generator.py --repo . --platform gitlab --output .gitlab-ci.yml

3. 合并前验证

1. 确认项目中存在相关命令（test、lint、build）。
2. 尽可能在本地运行生成的流水线。
3. 确保所需的 Secrets/环境变量已记录在案。
4. 确保部署任务由受保护的分支/环境管控。

4. 安全地添加部署阶段

• 从纯 CI 开始（lint/test/build）。

• 添加具有明确环境上下文的 Staging 部署。

• 添加带有手动门禁/审批的 Production 部署。

• 保持发布/回滚命令明确且可审计。

脚本接口

• python3 scripts/stack_detector.py --help

• python3 scripts/pipeline_generator.py --help

参考资料

• references/pipeline-design-notes.md — 常见陷阱、最佳实践、检测启发式算法、生成策略、平台决策笔记、合并前验证清单及扩展指南

• references/github-actions-templates.md

• references/gitlab-ci-templates.md

• references/deployment-gates.md

• README.md