SuperAPI AI 工具集

multi-repo-git-ops

通用与其它

查看项目

更新于 10-15 20:07

技能介绍

用途:在采用 git submodule 的多仓库系统中执行 Git 操作。父仓库只做规划与编排,各服务仓库是独立 Git 仓库,拥有各自分支、历史与 CI/CD,因此每次操作都需先判断影响哪些仓库。

主要能力:动态发现项目结构(从 .gitmodules 读取子模块路径与跟踪分支,不假设服务名或目录布局);按服务默认分支创建特性分支;在服务仓库内提交与推送;为每个服务创建 PR;合并后更新父仓库的子模块指针;跨仓库查看状态与同步子模块。

必要用法:先发现结构,例如 git config -f .gitmodules --get-regexp '.path$' 与 git config -f .gitmodules --get-regexp '.branch$';无分支配置时用 git remote show origin | grep 'HEAD branch'。分支命名:工单类为 {type}/{TICKET-ID}-{short-description},BMAD 故事为 feat/{story-key}。提交须在服务目录内进行,遵循 Conventional Commits,如 feat(auth): add JWT validation endpoint;禁止添加 AI 的 Co-Authored-By 尾注。父仓库指针更新用 chore: 类型。

BMAD 集成:检测 _bmad-output/implementation-artifacts/ 目录后启用。故事文件位于该目录,状态记录在 sprint-status.yaml;ready-for-dev → in-progress 时在受影响服务创建分支,review 时推送并建 PR,done 后更新父仓库指针。

适用场景:多服务项目、子模块编排、BMAD 故事开发、release-please 自动版本与变更日志。

限制:仅适用于使用 git submodule 的多仓库结构;BMAD 与 release-please 相关规则仅在项目实际采用时适用;推送 develop/dev 等分支可能触发自动部署,需先与用户确认;资料未提供具体平台、收费或效果信息。