SuperAPI AI 工具集

git-branchless

通用与其它

查看项目

更新于 10-16 03:14

技能介绍

用途:该技能把 git-branchless 的心智模型(提交即检查点、分离 HEAD 为默认工作模式、分支仅作发布产物)落实到日常 git 操作中,将常见工作流路由到对应的 branchless 命令。

主要能力:按操作类别给出“总是/绝不”规则。栈编辑(重排、fixup、squash、split)用 git move、git move -F、git reword、git split(v0.11.0+);基座更新用 git sync --pull 或 git move -b 'stack()' -d origin/main;撤销已提交历史用 git undo -i;丢弃本地进行中的工作用 git hide -r <tip>;临时工作先分离 HEAD、提交后再建分支;发布时先建分支再 git push -u,或在支持的 forge 上用 git submit -c。amend、reword、move、split 后后代通常自动内存重栈,仅在 smartlog 提示被遗弃子树时手动 git restack。

使用方式:先做预检,确认当前仓库已初始化 branchless:

test -d "$(git rev-parse --git-common-dir)/branchless" && git config --get branchless.core.mainBranch

两项都成功则技能激活,回复一行 git-branchless active — main=<value>;任一失败则技能静默失效,回复 git-branchless not initialized; skill inactive,交回普通 git,且不主动建议 git branchless init。典型流程:git branchless init(每仓库一次)→ git switch --detach origin/main → 编辑并 git commit(或 git record)→ 用 git move / git amend / git reword / git split 精修 → git sync --pull 同步 → git test run --exec '<cmd>' 'stack()' 验证 → 建分支并推送 → 用 git undo -i 恢复。

适用场景:采用 branchless 的仓库中的栈式开发、变基、历史整理、二分定位首个失败提交与恢复丢失工作。

限制:未初始化 branchless 的仓库中技能不生效;git split 及其模式需 v0.11.0+,旧版本需用替代方案;git submit --forge github 在 v0.9.0 为实验性,GitHub 工作建议手动建分支加 git push,git submit 保留给 Phabricator;事件日志按仓库与克隆隔离,git undo 无法跨克隆或跨机器恢复;git sync 与 git move 的推测合并跳过仅在摘要行中体现,需自行阅读。若本地版本拒绝某标志,应回退到文档中最近的替代方案并说明该版本受限功能不可用。