技能介绍

手动维护 CI/CD 管道的典型痛点

手动编写 GitHub Actions 工作流时，常面临 YAML 配置冗长易错、矩阵构建需重复定义参数、运行器资源分配依赖人工设置等问题。当项目需要支持多环境部署时，部署门控逻辑往往分散在不同工作流中，导致维护成本随规模增长快速上升。制品缓存策略若未统一，可能因重复下载依赖显著拖慢构建速度。

技能核心能力与工作方式

该技能通过 GitHub REST API 实现工作流自动化管理。核心能力包括：

工作流生成：根据仓库结构和分支策略，自动生成包含触发条件、任务步骤的 YAML 配置文件，支持 matrix 语法展开多维度构建参数
运行器管理：动态分配作业到合适的运行器，支持 self-hosted 与云运行器的优先级设置
制品缓存：基于任务依赖关系生成缓存键，通过 actions/cache 实现依赖包的高效复用
可复用工作流：将通用构建逻辑封装为 reusable workflows，供多个仓库或工作流调用
部署门控：在部署步骤前插入 environment 审批环节，支持按环境类型（如开发/生产）触发不同的验证逻辑

工作流程分三步：① 读取仓库现有配置与分支策略；② 生成包含触发器、作业、步骤的完整工作流定义；③ 通过 API 更新工作流文件并验证语法有效性。

适用边界与注意点

该技能依赖仓库已启用 GitHub Actions 功能，需要具备 repo:write 权限的 GitHub 令牌。生成的 YAML 文件可能需根据项目实际需求调整，例如自定义步骤中的命令参数。对于需要复杂条件判断的工作流逻辑，建议结合手动编写补充。涉及部署门控时，需确保环境名称与仓库设置一致。完整工作流语法参考官方文档 https://docs.github.com/en/actions。