SuperAPI AI 工具集

cross-repo

部署与运维

查看项目

更新于 10-15 23:48

技能介绍

cross-repo 是 GitHub Repo Manager 的跨仓库编排技能,由 commands/repo-manager.md 在检测到跨仓库模式时加载。它面向“多仓库”而非单仓库会话,负责作用域推断、批量变更策略、fork/archive 处理与速率限制预算。

用途与适用场景:所有者询问多个仓库(如“检查我所有仓库”“哪些仓库需要 X”),或询问以关注点而非单一仓库为范围的问题(如“有无待处理 PR”“安全状况”),以及为多个仓库设置或修改配置时生效。

主要能力:

  1. 作用域推断——从请求推断要检查的仓库和模块,例如社区健康→仅公开仓库;安全状况→所有仓库;Wiki 状态→启用 Wiki 的公开仓库;开放 PR 或通知→所有仓库;议题分类→有开放议题的仓库;发布就绪→Tier 4 为主。
  2. 执行流程——先用 gh-manager repos list --type all 发现仓库,再用 gh-manager config portfolio-read 读取组合配置,过滤 fork、归档仓库及配置中 skip: true 的仓库,用 gh-manager repos classify --repo owner/name 分类层级,然后对每个仓库运行目标模块,最后按关注点而非仓库分组呈现跨仓库报告。
  3. 批量变更策略——Tier 1–3 直接提交默认分支,Tier 4 创建草稿 PR 供审查后合并。执行前用 AskUserQuestion 确认,可选择全部修复、逐个处理或取消。
  4. 速率限制与错误处理——批量前用 gh-manager auth rate-limit 检查剩余预算;单个仓库失败则继续其余仓库并报告,缺少 PAT 权限则跳过相应仓库。

限制:fork 和归档仓库默认跳过(归档仓库所有变更返回 403),需在组合配置中显式包含;提交直接落到默认分支的变更不易回滚,Wiki push 可能覆盖手工内容,创建 PR 会产生通知。部分能力依赖已有组合配置与合理的 PAT 作用域。