SuperAPI AI 工具集

gt

编程与开发

查看项目

更新于 10-15 20:31

技能介绍

用途:Graphite(gt)是管理堆叠式 PR 的 CLI 工具,把大型功能拆分为层层叠加的小改动。该技能提供心智模型、命令参考和工作流模式。

主要能力:分支采用父子线性链结构,每个被跟踪分支(除主干外)只有一个父分支;修改分支时自动对其上级分支做 restack。提供方向性导航(up 远离主干、down 朝向主干),以及创建、修改、提交、同步、移动、折叠、拆分、日志等命令。

使用方式:在 agent/CI 环境中调用任何 gt 命令都必须加全局标志 --no-interactive,例如 gt sync --no-interactive、gt submit --no-interactive、gt track --parent main --no-interactive、gt restack --no-interactive、gt create my-branch -m "message" --no-interactive。--force 不能替代 --no-interactive。--interactive 控制提示、分页器、编辑器和交互式选择器,--no-interactive 会全部禁用;注意 gt modify --interactive-rebase 是另一个无关标志。常用命令包括 gt create / modify / submit / submit --stack / sync,导航用 gt up / down / top / bottom / checkout,栈管理用 gt restack / move / fold / split / log。

适用场景:创建新栈、响应评审反馈、在中间插入分支、合并后同步清理、拆分大改动等。元数据存放于共享 .git 目录(如 .graphite_repo_config、.graphite_cache_persist、.graphite_pr_info),跨 worktree 共享。

限制与注意:不要直接用 git rebase,应使用 gt modify 或 gt restack;不要用 git branch -d 删除,应使用 gt delete;gt submit 默认也提交下栈,需用 --stack 包含上栈;合并后要执行 gt sync;避免使用 gt log short 查看分支状态。具体参考资料与更详细命令说明未在资料中完整给出,暂未提供。