Agent Skills
返回列表
💻

GitHub Actions 工作流构建器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/github-actions-workflow-builder-skill。

技能介绍

要解决的问题

手写 GitHub Actions 工作流 YAML 有几个反复出现的坑:on.workflow_dispatch 的触发语法、matrix 的 include 组合、通过 workflow_call 复用工作流时的输入输出声明。这类错误往往要到 CI 实际运行时才暴露,排查成本高。维护多环境部署(如 Node.js、Python 服务发布到 Azure App Service)时,同一份 YAML 还要反复调整触发条件、runner 选择和凭据引用。

技能如何工作

这个技能在 GitHub Actions 的 YAML 层做两件事:生成与校验。

  • 基于 actions/toolkit SDK 的约定生成工作流,而非复制粘贴手写模板;
  • 默认以 workflow_dispatch 作为触发方式,便于手动触发调试;
  • 支持 matrix builds,用矩阵展开多版本、多平台的组合构建;
  • 支持 workflow_call 可复用工作流,以及 composite actions,并要求 input/output schema 定义完整,避免调用方与被调用方约定不一致。

适用边界与注意点

  • 前提是仓库已启用 Actions,且有对应运行时(如 Node.js、Python);
  • 目标场景偏部署类:Node.js / Python 到 Azure App Service,包括 Docker 容器部署方式,技能本身不做部署逻辑之外的编排;
  • 更通用的触发选择、runner 配置等细节以官方文档为准:https://docs.github.com/en/actions

使用场景

  • 仓库需要一份可手动触发的 CI 工作流,想用 workflow_dispatch 写好触发条件并确保 YAML 语法一次通过
  • 同一服务要同时构建多个 Node.js 版本或部署到多个环境,需要用 matrix 展开组合构建
  • 团队有多个服务共享部署流程,想拆成 workflow_call 可复用工作流并规范输入输出声明
  • 已有工作流文件在 CI 里频繁报 schema 错误,需要逐项校验 input/output 定义并修复

适合人员

  • 维护 CI 流水线的 DevOps 工程师,需要快速生成或修正 GitHub Actions YAML
  • 负责把 Node.js 服务发布到 Azure App Service 的后端开发者,需要可靠触发和运行工作流
  • 通过 Docker 容器把 Python 服务部署到 Azure App Service 的开发者,需要处理构建与部署配置
  • 为团队沉淀可复用部署流程的开发者,需要定义 workflow_call 和组合动作的输入输出契约