ci-cd-pipeline-builder

CI/CD 流水线构建器

根据检测到的项目技术栈信号，生成可用于生产环境的 CI/CD 流水线。分析锁文件、清单文件和脚本，生成经过优化的流水线，并配置恰当的缓存、矩阵策略、安全扫描和部署门禁。支持 GitHub Actions、GitLab CI、CircleCI 和 Buildkite，并支持蓝绿、金丝雀和滚动更新等部署策略。

关键词： CI/CD、GitHub Actions、GitLab CI、流水线、部署、缓存、矩阵构建、蓝绿部署、金丝雀部署、安全扫描、SAST、容器构建、环境门禁

核心能力

• 技术栈检测 — 从锁文件和清单文件中推断语言／运行时、包管理器、构建／测试／代码检查命令、框架和基础设施（Docker、K8s、Terraform）。
• 流水线生成 — 生成 lint／test／build／deploy 阶段，并配置正确的依赖关系、缓存、矩阵构建、工件传递和条件执行。
• 部署策略 — 支持蓝绿、金丝雀、滚动更新、重建、功能开关集成和手动审批门禁。
• 安全集成 — 支持 SAST（CodeQL、Semgrep、Snyk）、依赖项和容器扫描（Trivy、Grype）、机密扫描和 SBOM 生成。
• 优化 — 根据包管理器匹配缓存、路径过滤、并发控制和快速失败矩阵。

适用场景

• 为新仓库搭建 CI/CD
• 在不同 CI 平台之间迁移
• 优化缓慢或不稳定的流水线
• 为现有的仅含 CI 阶段的流水线添加部署阶段
• 在流水线中加入安全扫描
• 设置多环境部署（预发布、生产）

先行确认

生成流水线前，请确认以下输入。如果有任何信息未知或含糊不清，请先询问，不要自行假设：

• 目标平台 — GitHub Actions、GitLab CI、CircleCI 或 Buildkite（决定 pipeline_generator.py 通过 --platform 输出的 YAML 方言）
• 项目技术栈 — 语言／运行时、包管理器，以及是否使用 Docker／K8s／Terraform（决定技术栈检测、缓存和生成的阶段）
• 部署策略和门禁 — 蓝绿、金丝雀、滚动更新或仅 CI，以及是否需要手动审批门禁（决定部署阶段和条件）

停止规则：只询问对输出影响最大的 2-3 项。如果用户说“先起草一版”，则继续操作，并在产物顶部列出假设。

工具

工具	用途	命令
pipeline_generator.py	根据项目技术栈检测结果生成流水线 YAML	python scripts/pipeline_generator.py . --platform github --deploy
cache_optimizer.py	分析流水线配置并提出缓存改进建议	python scripts/cache_optimizer.py --dir . --severity high
pipeline_linter.py	检查流水线 YAML 中的常见问题	python scripts/pipeline_linter.py --dir . --severity warning

参考资料

根据任务加载相应的参考资料——保持本文件精简，按需查阅详情：

• references/pipeline-templates.md — 技术栈检测启发式规则、完整的 GitHub Actions 模板（Node.js/pnpm/Next.js 和 Python/uv/FastAPI）、对应的 GitLab CI 配置、缓存策略参考表、流水线优化技术和部署策略决策框架。生成流水线或选择部署策略时阅读。
• references/quality-and-operations.md — 合并前验证清单、常见问题、最佳实践、故障排除表和成功标准。合并生成的流水线前或流水线出现异常时阅读。

范围与限制

此技能涵盖：

• 为 GitHub Actions、GitLab CI、CircleCI 和 Buildkite 生成 CI/CD 流水线
• 根据锁定文件、清单、Dockerfile 和基础设施即代码定义检测技术栈
• 通过决策框架选择部署策略（蓝绿、金丝雀、滚动、重新创建）
• 优化流水线，包括缓存、矩阵构建、路径筛选和并发控制

此技能不涵盖：

• 运行时基础设施配置或云资源管理（参见 engineering/saas-scaffolder）
• 超出 CI 集成扫描范围的应用级安全加固（参见 engineering/skill-security-auditor）
• 部署后的监控、告警和可观测性配置（参见 engineering/observability-designer）
• 部署期间的数据库迁移编排（参见 engineering/migration-architect）

集成点

技能	集成方式	数据流
engineering/dependency-auditor	将漏洞扫描结果传入流水线安全门禁	审计结果会触发流水线失败或生成警告注释
engineering/release-manager	协调版本管理与变更日志，并将其纳入部署阶段	发布标签会触发有条件地执行部署作业
engineering/observability-designer	部署后的健康检查和告警与流水线门禁相辅相成	流水线会触发冒烟测试；可观测性工具会确认部署健康状况
engineering/env-secrets-manager	管理流水线环境变量引用的密钥	密钥轮换策略会影响流水线密钥存储的配置
engineering/migration-architect	数据库迁移作为流水线中的部署前步骤运行	迁移状态会控制应用部署作业是否执行
engineering/runbook-generator	生成与部署策略相匹配的回滚运行手册	流水线失败时会提供相关回滚运行手册的链接