SuperAPI AI 工具集

gt2gh

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

gt2gh 是一个 Go CLI,用于把 Graphite 管理的分支栈桥接到 GitHub 原生栈。项目名、仓库名、发布资产和 Homebrew formula 名都保持 gt2gh,Homebrew 安装的可执行文件名为 g2g,源码构建和未改名发布包使用 gt2gh。安装方式为 brew install shhac/tap/gt2gh。

主要命令:link 默认预览,--apply 是唯一会调用 gh stack link 的路径;sync 预览优先,仅在所选路径分支都已有打开的 GitHub PR 时应用,不修复合 PR;push 是预览优先的发布逃生通道,只允许在 --apply 时执行一次 git push --atomic --force-with-lease <remote> <branches>,默认远端为 origin;status 是只读分诊入口;unlink 是 link 的逆向操作,--apply 时调用 gh stack unstack;submit 是预览优先的 PR 创建恢复路径,可配合 --write-spec、--spec 非交互提交;graph、track、untrack 操作 gt2gh 自有的分支森林,只读 Git,不联网。

设计约束:Graphite 为权威来源,gt2gh 不会重排、rebase、提交或合并 Graphite 分支。选择某分支为枢轴时默认向下延伸唯一子链,不收编兄弟分支,--no-stack 是显式退出口。不猜测 trunk,需 --trunk 时其值必须已声明且为祖先。存储位于 Git 公共目录,用 git rev-parse --path-format=absolute --git-common-dir 定位,写入采用临时文件加重命名。

开发与测试:外部进程调用统一走 internal/subprocess.Runner;测试使用 PATH 上的假 gt、gh,不依赖凭证、网络或真实安装。改动 Go 文件后运行 gofmt -w 和 go test ./...,发布前可用 go vet ./...。提交暂存用 git hunk,未经用户明确要求不得提交、打标签、推送或执行真实 gt/gh 变更。

限制:非交互提交时多个 PR 模板需显式指定 --template 或 --no-template;命令行解析只支持严格、非交互的受支持发现方式,不读取 Graphite 内部元数据;不支持的行为会报告而不修复。