GitHub Actions CI 流水线构建器

当 CI 管道复杂到需要「维护」而非「编写」时

手动编写 GitHub Actions 工作流时，开发者常面临三个具体问题：多环境适配需要重复编写相似 YAML、构建矩阵扩展时容易遗漏配置项、跨项目复用逻辑需复制粘贴代码片段。这些问题在项目迭代中逐渐积累，最终导致 CI 配置文件臃肿、维护成本飙升。

从 YAML 生成到 API 管理的全流程支持

该技能通过两种方式解决上述痛点：

• 模板化生成：基于 GitHub 官方文档规范，自动产出包含 jobs、strategy.matrix 等核心结构的 YAML 模板，支持直接嵌入 if 条件判断和 needs 依赖链。
• API 驱动管理：调用 GET/POST /repos/{owner}/{repo}/actions/workflows 接口，实现工作流的动态创建、更新和版本回退，避免直接操作文件带来的语法风险。

关键操作步骤包括：

1. 通过 REST API 获取现有工作流列表，分析触发条件与运行器配置
2. 根据需求生成包含 matrix 节点的 YAML 内容，自动补全 node-version、os 等参数
3. 使用 PUT 接口上传新工作流文件，同步更新分支保护规则

适用边界与技术注意点

• 前置条件限制：要求目标仓库已启用 Actions 功能，且需要 repo:write 权限的 PAT 用于 API 调用
• 矩阵构建优化：当 strategy.matrix 包含超过 50 个节点时，建议拆分为多个 workflow_call 触发器
• 复用工作流约束：跨仓库复用需确保被引用工作流使用 workflow_run 事件且包含 workflow_call 定义
• 复合动作维护：建议通过 action.yml 的 runs.steps 定义最小化步骤，避免过度封装导致调试困难

该方案特别适合需要同时维护多个微服务 CI 管道的团队，但需注意 GitHub 对单次 API 请求返回结果的数量限制（默认 30 条/页）。