GitHub Agentic Workflows 是什么?5,600 星的 gh-aw 把 Actions 改造成 Agent 平台,默认只读(基础篇)

GitHub Agentic Workflows 是什么?5,600 星的 gh-aw 把 Actions 改造成 Agent 平台,默认只读(基础篇)

GitHub 在 10 月 28 日把 GitHub Agentic Workflows 推到了正式可用。仓库 github/gh-aw 现在 5,627 星、625 个 fork、19,885 次提交,MIT 协议,最新版 v1.2.2(11 月 10 日)。它不给你画布,也不教你搭节点,只给一个 Markdown 文件——剩下的活,交给仓库里本来就有的 GitHub Actions。

一句话说清:你负责写”这件事该怎么判断”,它负责把 Agent 关进沙箱里跑,而且默认不给写权限。

它到底在解决什么问题

GitHub 自己的说法很克制:构建、测试、发布这类确定性的事继续用普通 Actions;需要判断的事——issue 分诊、PR 审查、CI 失败定位、文档维护、依赖分析、仓库周报——才交给 Agentic Workflow。所以它不是替代 CI,而是给 CI 补上一块”会看人话”的部分。

链路是这样的:.github/workflows/xxx.md,顶部 YAML frontmatter 写 on、permissions、tools、safe-outputs,正文就是人话指令。跑一次 gh aw compile,编译成标准的 xxx.lock.yml,复用你现有的 runner group 和策略;编译期会校验配置、把权限收紧、把 action 钉到具体 commit。

五个引擎,一份 Markdown

内置引擎五个:GitHub Copilot(默认,需要 Copilot 授权)、Claude Code、OpenAI Codex、Google Gemini,还有 Pi。换引擎基本就是换 frontmatter 里的一个字段,加一套凭据:Copilot 走 COPILOT_GITHUB_TOKEN,Anthropic 和 Google 都能配 keyless 的 Workload Identity Federation,不用往仓库里塞长期密钥。

上手:十分钟能跑起来

  1. 装扩展:gh extension install github/gh-aw,要求 gh v2.0 以上。
  2. 拉一个现成模板:gh aw add-wizard githubnext/agentics/repo-status。向导会让你选引擎、配认证,然后把 .md 和生成的 .lock.yml 一起提交——两个文件都要提交,lock 文件是 Actions 真正执行的那个。
  3. 跑:gh aw run repo-status,或者等它按 frontmatter 里的 cron 自己跑。看状态用 gh aw status,看账单用 gh aw logs。

想自己写就从空文件开始。frontmatter 里最小三件事:什么时候跑(on)、给它什么权限(permissions,只读最省心)、它能用什么工具(tools)。想让它能开 issue,得在 safe-outputs 里显式声明——这一项不是”给它写权限”,而是”允许它请求哪几种写操作”,真正写的是另一个作业。

GitHub Agentic Workflows 运行路径:Markdown 编译成 lock.yml,只读 Agent 作业在沙箱里跑,补丁经威胁检测与人工审批后由 safe-outputs 作业写回
一次 gh-aw 运行的完整路径:Agent 只读跑、出网只过白名单,写回由独立作业执行

实话

一、账是两份。 Actions 分钟数照算,推理另算。Agentic Workflows 用 AI Credits 计量,1 AIC = 0.01 美元,单次默认上限 1,000 AIC,也就是 10 美元。企业侧默认 5,000 AIC 一天、威胁检测作业 400 AIC、agent 步骤 20 分钟超时,都可覆盖。gh aw forecast 也从实验功能转正了,能估月度账单。

二、官方自己晒的数字更有意思。 仓库里的 Issue Monster 跑五次,38.5 万 token,约 3.1 AIC;PR 代码质量审查跑五次,49.3 分钟、10.3 万 token、14.8 AIC;贡献检查每次 8 到 9 分钟、3 万 token、38 次 API 调用、4 条 safe-output。结论很直白:分诊、巡检这类窄活一次不到一美分,代码审查贵一个量级,但还是几美分的量级。默认那 1,000 AIC 的帽子,对分诊来说宽得离谱。

三、隔离不是白送的。 自建 runner 走 ARC + DinD 也能跑,但 DinD 的 sidecar 默认是 privileged 容器。一边是被设计成只读的 Agent,一边是特权 Docker daemon,这条缝得自己盯着。

四、它已经被打过脸。 0.83.3 到 0.85.4 之间的版本,因为一个安全公告被”预防性退役”(GHSA-8h78-hpm7-29gg)。Agent 平台的攻击面不在模型,在自己那套权限、网关和产物处理里,这话不是玩笑。

五、厂商口径要打折。 GA 公告里 Accenture 说有个 lead 一周省了 29 小时,但没写怎么测的。信这个数字之前,先数一下自己仓库里有多少活是”需要判断”的。

边界在哪: 它只活在 GitHub 这个壳里。要拖拽画流程编排业务,得看 Dify 那一路;要把流程接进飞书钉钉企业微信,是 n8n 那一路;想让 Agent 在自己机器上常驻干活,是 OpenClaw 那一类。gh-aw 抢的是”CI 旁边那块需要判断的活”,这个定位在 Agent 平台三车道 里算第四种:不卖连接器、不卖画布、不卖代码框架,卖的是”仓库自带的执行环境”。

团队本来就在 GitHub 上跑 CI 的话,这是门槛最低的一次 Agent 落地:不用买平台、不用迁仓库、不用学新 DSL,写一个 md,编译,看一眼账单,再决定要不要放开第二个。反过来说,连 Actions 分钟数都在省的团队别急着上——Agent 的账单比 CI 更不像话。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注