gh-aw-fleet：声明式管理 GitHub Agentic Workflows 的舰队管理工具

核心概述

gh-aw-fleet是一款声明式舰队管理器，用于集中管理多个仓库中的GitHub Agentic Workflows，支持通过单一配置文件实现跨仓库的工作流部署、同步和升级。

基础信息

• 原作者/维护者: rshade
• 来源平台: GitHub
• 原始链接: https://github.com/rshade/gh-aw-fleet
• 发布时间: 2026年6月
• 当前版本: v0.1.0（2026年4月发布）

随着GitHub Agentic Workflows在多仓库中的普及，维护一致性面临挑战：

1. 配置漂移: 每个仓库独立固定gh-aw版本，导致配置不一致，需手动同步。
2. 成本追踪困难: GitHub Copilot于2026年6月1日转向使用量计费模式，per-repo工具无法跨舰队查看积分消耗，成本管理复杂。

当管理3个及以上使用Agentic Workflows的仓库时，分散管理方式变得繁琐。

gh-aw-fleet通过以下机制实现集中化管理：

1. 声明式配置: 使用fleet.json文件声明期望状态（仓库与工作流的对应关系），并固定上游版本。
2. 协调命令:
   • deploy: 部署工作流到指定仓库
   • sync: 同步配置到各仓库
   • upgrade: 升级工作流到新版本
   • add: 添加新仓库到舰队
3. 漂移检测: status命令可检测配置偏离期望状态的仓库。
4. 成本追踪: fleet.json支持按仓库/配置文件/成本中心归因消耗，未来将推出consumption子命令（参见Issue #57）。

基于PR的工作流

每个舰队操作都会在目标仓库打开PR，无强制推送或直接提交到main分支，确保变更可审查和追溯。

与gh-aw的关系

两者互补：

• gh-aw负责编译Markdown工作流到GitHub Actions并运行AI代理；
• gh-aw-fleet负责部署已存在的上游工作流，不涉及新工作流创作。

适合使用

• 运营3个及以上仓库，使用或计划使用gh-aw编译的Agentic Workflows；
• 希望集中声明工作流与仓库的对应关系，并固定上游版本；
• 需要同步偏离期望状态的仓库；
• 熟悉基于PR的变更流程。

不适合使用

• 仅运营1个仓库（直接使用gh aw即可）；
• 需创作新工作流（gh aw的职责）；
• 希望使用托管/集中式服务（本工具为本地CLI，无服务器组件）。

项目状态

当前版本v0.1.0（2026年4月发布），v1.0前公共接口（CLI标志、fleet.json模式）可能变化。核心命令（deploy/sync/upgrade/add）、漂移检测（status）及template fetch功能已可用。

实际价值

• 配置一致性: 确保所有仓库使用正确版本的工作流；
• 降低管理开销: 从逐个仓库管理转为集中式声明管理；
• 成本可见性: 为跨仓库Copilot使用量追踪奠定基础；
• 安全变更: 通过PR流程确保变更可审查。

gh-aw-fleet代表了基础设施管理的模式转变：从命令式（逐个操作）到声明式（描述期望状态），这一模式已在Kubernetes、Terraform等工具中验证，现应用于GitHub工作流管理。

对于采用GitHub Agentic Workflows的团队，尤其是使用Copilot使用量计费模式的团队，gh-aw-fleet提供了必要的管理层，帮助在规模扩大时保持控制。