gh-aw

GitHub Agentic Workflows（`gh-aw`）是一个 GitHub CLI 扩展，使开发者能够使用带 YAML frontmatter 的 Markdown 文件定义 AI 驱动的仓库自动化。该扩展将每个代理工作流编译为标准 GitHub Actions 工作流，使 AI 代理能够在 GitHub Actions 中安全运行。 代理工作流专为需要推理或解释的任务设计，例如问题分类、拉取请求审查、CI 失败调查、文档维护、依赖分析和仓库报告。它们补充而非替代用于确定性构建、测试、代码检查、部署和可复现脚本的传统 GitHub Actions。 内置 AI 引擎包括 GitHub Copilot、Claude Code、OpenAI Codex、Google Gemini 和 Pi。代理任务默认是只读且沙箱化的，配置的 GitHub 写入通常通过具有范围权限的已验证 `safe-outputs` 任务应用。 安全性、权限和受控写入是核心设计关注点。支持的代理任务路径默认采用只读 GitHub 访问和沙箱执行。安全输出缓冲配置的写入，验证它们，并在具有范围权限的单独任务中应用。这些控制是可配置的，因此工作流作者必须在部署前审查权限、工具、网络访问和生成的文件。 快速开始：使用 `gh extension install github/gh-aw` 安装扩展，然后按照快速入门指南选择 AI 引擎、添加示例工作流，并通过 GitHub Actions 运行它。 文档涵盖创建工作流、选择和认证 AI 引擎、按任务分类的示例、安全架构和常见问题解答。AI 代理和检索工具可以使用已发布的代理提示索引、完整提示语料库和 AI 可读项目摘要。 注意：在版本 `>= 0.83.3, < 0.85.4` 中发现了一个安全漏洞；这些版本已作为预防措施被撤回。