SuperAPI AI 工具集

graphite

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:该技能用于指导使用 Graphite(gt)在分支堆叠(stack)中进行导航与 restack,维护本地堆叠状态,并说明如何用 gt 替代部分 git 操作。

导航命令:gt up 上移一层,gt down 回到父分支,gt prev/gt next 按 gt log 顺序前后移动,gt top 到栈顶,gt bottom 到最接近 trunk 的分支,gt ls 以短格式显示所有跟踪分支及依赖关系。

堆叠管理:gt restack 保证当前栈中每个分支的父分支都在其提交历史中,必要时变基,仅维护本地、不访问远程;gt get 从远程同步指定分支或栈,未指定时同步当前栈;gt sync 同步所有分支(含 trunk)并提示删除已合并分支。

分支与提交:gt create <branch-name> 在当前分支之上创建并堆叠新分支,需遵循 /gt-create 工作流;gt move 将当前分支变基到目标分支并 restack 后代,可用 --onto <target-branch> 避免交互;gt split 拆分当前分支,高度交互。提交管理用 gt modify,会自动 restack 后代:gt modify --amend 修补当前分支头提交,gt modify -c 新建提交。建议优先用 gt 替代 git,例如用 gt create 代替 git checkout -b,用 gt modify -c -m "message" 代替 git commit -m,用 gt modify --amend 代替 git commit --amend,用 gt modify -cam "message" 代替 git commit -am,以保持元数据一致并自动 restack。

交互与冲突:gt modify、gt move、gt split、gt restack 默认可能交互,应尽量通过显式分支名或 --onto 等标志避免交互选择器;若必须用户输入而无法通过标志提供,应停止并通知用户。遇到变基冲突时,用 git status 或错误输出定位冲突文件,编辑解决冲突标记,运行 gt add -A(或 git add <file>)暂存,再运行 gt continue 继续;切勿使用 git rebase --continue,因为 Graphite 有自己的状态跟踪。完成后应运行测试验证。

限制:严禁运行 gt ss、gt submit、gt squash,PR 提交、更新与分支压缩须手动或按指定流程处理。资料未提供安装、收费、价格、平台或效果信息。