gh-aw：AI 智能体仓库自动化

项目简介

GitHub Agentic Workflows（gh-aw）是一个 GitHub CLI 扩展，让开发者用带 YAML frontmatter 的 Markdown 定义 AI 驱动的仓库自动化，并通过 GitHub Actions 安全地运行 AI 智能体。gh aw compile 命令会校验这些源文件，并生成 GitHub Actions 实际执行的 .lock.yml 工作流。

确定性的工作（构建、测试、lint、部署、可复现脚本）继续使用常规 GitHub Actions；只有在任务需要推理或理解时才添加 agentic workflow，例如 issue 分诊、pull request 审查、CI 失败排查、文档维护、依赖分析、仓库报告。它是现有 CI/CD 的补充，而不是替代。

内置 AI 引擎包括 GitHub Copilot、Claude Code、OpenAI Codex、Google Gemini 和 Pi。

主要功能

• Markdown 编写工作流：YAML frontmatter 配置触发器、权限、工具和 AI 引擎，Markdown 正文告诉 AI 智能体要完成什么。
• 编译为 Actions 工作流：gh aw compile 校验源文件并生成 .lock.yml。
• 多 AI 引擎可选：GitHub Copilot、Claude Code、OpenAI Codex、Google Gemini、Pi。
• 默认只读与沙箱化：agent 任务默认只有只读 GitHub 访问权限并运行在沙箱中。
• safe-outputs 受控写入：配置的 GitHub 写操作会被缓冲、校验，再由独立任务在受限权限下执行。

安装与使用

先安装 GitHub CLI，再安装扩展：

gh extension install github/gh-aw

安装后按快速开始选择 AI 引擎、添加示例工作流，并通过 GitHub Actions 运行。

常用文档：

• 创建工作流
• 选择并认证 AI 引擎
• 按任务浏览示例
• 安全架构说明
• FAQ

注意事项

• 项目曾披露安全漏洞，版本 >= 0.83.3, < 0.85.4 已被预防性下线。
• 权限、工具、网络访问和生成文件都需要在工作流部署前人工审查；即使谨慎使用，仍可能出问题，请自行承担风险。

本作品整理自 GitHub 开源项目 github/gh-aw，原作者 @github，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。