SuperAPI AI 工具集

git-workflow

办公与效率

查看项目

更新于 10-16 09:54

技能介绍

用途:为仓库定义 Squad 三分支模型与 issue 工作流。main 仅放已发布、已打 tag、npm 上的代码,打 tag 时执行 npm publish;dev 为集成分支,所有功能工作先落这里,合并时执行 npm publish --tag preview;insiders 为抢先体验通道,从 dev 同步,同步时执行 npm publish --tag insiders。

主要能力:规范分支命名,issue 分支必须用 squad/{issue-number}-{kebab-case-slug},例如 squad/195-fix-version-stamp-bug。给出从 dev 起分支、标记 issue 进行中、创建以 dev 为基的草稿 PR、推送并转就绪、合并后清理本地与远端分支的完整步骤。支持并行多 issue:同一仓库同时处理 2 个以上 issue 时用 git worktree,为每个 issue 创建独立工作目录(如 ../squad-195),各自持有从 dev 拉出的 squad/{number}-{slug} 分支,共享 .git 对象库。每个 worktree 内按单 issue 流程提交、推送、开 PR,PR 均以 dev 为目标。.squad/ 目录在各 worktree 中为副本,因 .gitattributes 对追加型文件声明 merge=union,规则是只追加、不改写不重排。合并后从主克隆执行 git worktree remove、git worktree prune 并删除分支。多仓库场景把下游仓库以兄弟目录克隆,各仓库独立建 issue 分支并开 PR,在 PR 描述中写依赖关系,按依赖先合并;提交前可用 npm link、go.mod replace、pip install -e . 做本地联调,但提交前须移除本地链接,CI 应使用已发布包或 PR 专用引用。升级管道:dev 到 insiders 在构建通过后自动同步,dev 到 main 在准备稳定发布时手动合并再打 tag;热修复从 main 拉 hotfix/{slug},PR 到 dev,紧急时 cherry-pick 到 main。

限制与反模式:不要从 main 起分支,PR 不要直接面向 main,分支名必须符合规范,不要直接提交到 main 或 dev,worktree 活跃时不要在主克隆切换分支,跨仓库工作不要用 worktree 而用独立克隆,PR 合并后应及时清理 worktree。资料未提供具体安装命令与收费信息。