用途:指导在任意仓库中采用 GitHub Agentic Workflows(gh-aw),从调研到生产可用。触发场景包括仓库尚无智能体工作流、想了解 gh-aw 工作流模式、批量创建多个工作流、排查 MCP 服务器启动失败或 lockdown mode 等报错。
主要能力:分四阶段推进。一是调研(约15-20分钟),用 gh api 列出 github/gh-aw 仓库的工作流,阅读5-10个样例并归类,对比本仓库自动化现状,产出缺口分析与优先级清单。二是并行创建(约30-45分钟),为每个工作流独立启动代理线程,读取参考工作流并适配,写入 .github/workflows/[name].md,配置 safe-outputs、最小权限与工具,并在特性分支提交。三是 CI 诊断与集成(约15-30分钟),运行 gh aw compile 修复 YAML 语法错误,用 rebase 解决合并冲突,用 gh pr checks 监控外部检查。四是校验与部署(约10-15分钟),确认编译出 .lock.yml、权限遵循最小特权、safe-outputs 限额、网络防火墙规则、错误恢复,并用 workflow_dispatch 测试后合入。
使用方式:前置条件为安装 gh CLI(gh --version)与扩展(gh extension install github/gh-aw),具备写权限与令牌。可直接说“Adopt GitHub Agentic Workflows in this repository”,或用“investigation only”仅调研。技能内附带 Repo Guardian 模板:复制 repo-guardian.md 与 repo-guardian-gate.yml 到 .github/workflows,执行 gh aw compile repo-guardian,配置 COPILOT_GITHUB_TOKEN 密钥后提交三个文件。
适用场景:README 举出安全合规(secret 校验、容器扫描、许可证、SBOM)、开发自动化(PR 打标、issue 分类、过期 PR 管理、changelog)、质量保障(覆盖率、变异测试、性能回归)及维护与团队沟通等。
限制:文档强调避免单体工作流、硬编码仓库值、宽泛权限与未测试即启用;需实现限流退避、重试与审计;成功标准为仓库有 10-20 个生产工作流。具体收费、价格与平台支持范围暂未提供。