gh-aw(工作流代理)

作者 多模态速递

仓库里那些重复的 triage、打标签、发日报,写成 Actions YAML 又长又难维护。gh-aw 让你用 Markdown 加 YAML frontmatter 定义 AI 仓库自动化,由 Actions 执行,自带安全边界和权限控制,GitHub 官方出品。

Github
Skill 编程开发 v1.0.0 热度 410

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-79(gh-aw(工作流代理))。
详情页:https://www.cweto.cn/work-79.html
GitHub:https://github.com/github/gh-aw
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

Skill 说明

gh-aw 是什么

GitHub Agentic Workflows(简称 gh-aw)是 GitHub 官方的仓库自动化工具,公式是:Actions + Agent + Safety。它让开发者用 Markdown 加 YAML frontmatter 来定义 AI 驱动的仓库自动化,而不是手写越来越长的 Actions 工作流。

设计上把「安全」当成了一等公民:仓库里专门有 Security and permissions 一节,说明权限模型和边界。执行仍然跑在 GitHub Actions 上,你熟悉的基础设施和审计链路都不用换。

组成说明
定义方式Markdown 正文 + YAML frontmatter
执行环境GitHub Actions
安全性内置权限模型与安全边界说明
配套命令create / install / package 三套流程
参考文档仓库内附完整 workflow 参考

因为是官方项目,它和 GitHub 的权限体系、仓库策略是同一套语言,不用自己做桥接。

gh-aw 怎么安装

官方把安装说明放在仓库里的一份 Markdown 上,直接取:

https://raw.githubusercontent.com/github/gh-aw/main/install.md

新建一个工作流用 create 说明:

https://raw.githubusercontent.com/github/gh-aw/main/create.md

要把一组工作流打包成可复用仓库,用 package 说明:

https://raw.githubusercontent.com/github/gh-aw/main/package.md

gh-aw 怎么使用

  1. 先按 install.md 装好工具链。
  2. 用 create.md 的流程新建一个工作流:正文写自然语言指令,frontmatter 里配触发条件和权限。
  3. 把工作流提交进仓库,剩下的交给 Actions 执行。
  4. 权限按最小化原则给,只授它真正需要的那几项。
  5. 需要复用到多个仓库就打包成 workflow 仓库,用 package.md 的流程发布。
  6. 完整语法和可用能力查仓库内的 workflow 参考文档。

gh-aw 适合谁用

  • 维护活跃开源仓库、issue 和 PR 量大到靠人处理不过来的维护者。
  • 想把「自动分类、自动回复、自动发日报」这类重复工作交给 AI 的团队。
  • 已经重度使用 GitHub Actions、希望沿用现有权限与审计体系的组织。
  • 要在一个组织内多个仓库复用同一套自动化流程的平台团队。
  • 不在 GitHub 上托管代码的项目用不了——它是深度绑定 Actions 的。

gh-aw 项目地址

  • GitHub 仓库:https://github.com/github/gh-aw
  • 项目入口:https://gh.io/gh-aw
  • 安装说明:https://raw.githubusercontent.com/github/gh-aw/main/install.md
  • 新建工作流:https://raw.githubusercontent.com/github/gh-aw/main/create.md
  • 打包发布:https://raw.githubusercontent.com/github/gh-aw/main/package.md
  • 完整参考:https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md