github/gh-aw

这是什么？

核心功能

• 01用带 YAML frontmatter 的 Markdown 定义触发器、权限、工具和 AI 引擎。
• 02通过 gh aw compile 将每个工作流编译为标准 GitHub Actions 工作流。
• 03支持 GitHub Copilot、Claude Code、OpenAI Codex、Google Gemini 和 Pi 引擎。
• 04智能体任务默认只读并在沙箱中运行。
• 05GitHub 写操作经由校验过的 safe-outputs 任务以受限权限执行。

适用场景

• 自动分类新 issue 并添加标签。
• 在 CI 中由 AI 智能体辅助审查 Pull Request。
• 排查失败的 CI 运行并总结原因。
• 维护文档并定期生成仓库报告。

快速上手

1. 1

   安装 GitHub CLI 扩展

   gh extension install github/gh-aw
2. 2

   按照快速入门选择 AI 引擎、添加示例工作流并通过 GitHub Actions 运行

使用前须知

• !需要 AI 引擎账户或 API 密钥，例如 GitHub Copilot、Claude Code、OpenAI Codex 或 Google Gemini。
• !智能工作流需要人工仔细监督，README 提示请自担风险使用。
• !版本 0.83.3 至 0.85.4 之前的版本因发现安全漏洞已被撤回。

标签

常见问题

gh-aw 是什么？

GitHub CLI 扩展，用 Markdown 编写 AI 驱动的仓库自动化，并通过 GitHub Actions 安全运行。 GitHub Agentic Workflows（gh-aw）允许开发者用带 YAML frontmatter 的 Markdown 文件定义仓库中的 AI 智能体任务。执行 gh aw compile 命令后，每个工作流会被编译为标准的 GitHub Actions 工作流文件，在 GitHub 上运行。

gh-aw 可以免费使用吗？用的什么许可证？

gh-aw 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

gh-aw 还在维护吗？

活跃维护中。gh-aw 最近一次提交是在 2026年10月20日。

gh-aw 适合用来做什么？

自动分类新 issue 并添加标签。 在 CI 中由 AI 智能体辅助审查 Pull Request。 排查失败的 CI 运行并总结原因。 维护文档并定期生成仓库报告。

gh-aw 怎么安装和运行？

安装 GitHub CLI 扩展: gh extension install github/gh-aw 按照快速入门选择 AI 引擎、添加示例工作流并通过 GitHub Actions 运行

在哪里获取 gh-aw？

源代码和安装说明在 GitHub 上：https://github.com/github/gh-aw