SuperAPI AI 工具集

multi-repo

部署与运维

查看项目

更新于 10-15 23:57

技能介绍

用途:当功能跨越多个仓库边界时,协调跨仓库的原子化变更,跟踪依赖关系、管理关联 PR,并在破坏性变更传播前发现它们。适用于需要多仓库协同更新、管理仓库依赖图、创建应一起或按顺序合并的关联 PR、检测影响下游仓库的破坏性变更,以及微服务或 monorepo 替代架构;不适用于单仓库变更、fork/同步操作、纯文档变更或无跨仓库依赖的变更。

主要能力:维护仓库依赖图(dependencies.yaml)、关联 PR 集合(linked-prs.yaml)和破坏性变更历史(breaking-changes.log),数据存放于 ~/.amplihack/.claude/data/multi-repo/。核心操作包括初始化依赖图、添加仓库依赖、检测破坏性变更、创建关联 PR、按依赖顺序协调合并。依赖图使用简单 YAML,记录 depends_on、exposes(如 API 契约)及版本约束。

使用方式:通过命令如“Initialize multi-repo dependencies”“Add dependency: my-org/web-client depends on my-org/api-server for REST API”触发操作。检测破坏性变更时会识别当前分支改动是否触及暴露契约,查找下游仓库并生成影响报告。创建关联 PR 时按依赖顺序建分支、开 PR 并互相引用。合并时先合无依赖仓库,再合依赖方,每次合并后等待 CI 通过。可与 worktree-manager 配合使用 git worktree add 创建隔离工作区,也可与 PM Architect 集成跟踪跨仓库工作流。

限制:依赖图为按工作区存储而非集中式;PR 操作需要已认证的 gh CLI;破坏性变更检测为启发式,可能漏掉运行时变更;不支持循环依赖。