SuperAPI AI 工具集

git-chain

编程与开发

查看项目

更新于 10-15 20:32

技能介绍

用途:管理相互依赖的 Git 分支链(堆叠分支),如主分支之上层层叠加的功能分支。当根分支或链中某分支出现新提交时,git-chain 可按依赖顺序自动更新全部分支,免去逐个手动 rebase。

主要能力:先用 git chain setup <name> <root> <b1> <b2>… 创建链;git chain 查看当前链,git chain list 列出全部链。更新时可选 git chain rebase(重写历史、线性提交)或 git chain merge(保留历史、生成合并提交)。支持 git chain push 与 git chain push --force 推送全部分支、first/last/next/prev 在链内导航、backup 创建备份分支、prune 清理已并入根分支的分支、remove 移除当前分支或整条链。

典型用法:堆叠 PR 工作流——按 auth、profiles、settings 顺序建分支后执行 git chain setup user-feature main auth profiles settings;根分支有更新后执行 git chain rebase 再 git chain push --force 更新各 PR。基础分支收到评审意见时,提交修改后同样用 git chain rebase 传播到依赖分支。新增分支可用 git chain init user-feature main --after=profiles 插入指定位置。

前提与限制:需先安装 git-chain,用 git chain --version 验证;资料明确要求未安装时不要自动安装,应停下告知用户,推荐从源码克隆后 make install 或用 cargo install --path .。每个分支最多属于一条链。冲突时流程会暂停,需手动解决后 git add 并 git rebase --continue,再继续 git chain rebase;出错可用 git rebase --abort、git chain backup 的备份或 git reflog 恢复。rebase 会重写历史,共享分支建议改用 merge。更多标志与进阶用法见 references/rebase-options.md、merge-options.md、chain-management.md。