用途:该技能用于配合 Graphite(gt)命令行工具管理堆叠式 PR(stacked PRs),覆盖创建、导航、修改、提交与排障流程,资料来源于 dagster-io/erk。
主要能力与常用命令:创建分支与 PR 用 gt create branch-name -m "message";修改当前分支用 gt modify -m "message";堆栈导航用 gt up、gt down、gt top、gt bottom;查看结构用 gt ls;提交评审用 gt submit --no-interactive;基于主干重排用 gt restack;调整父分支用 gt track --parent <branch>;重命名用 gt rename <new-name>;调整顺序用 gt move;删除分支用 gt delete <branch> -f -q(可加 --upstack / --downstack)。
用法要点:常规流程为改动文件、git add <files>、gt create、逐个重复、最后 gt submit --no-interactive。分支命名建议采用 terse-stack-feature-name/terse-description-of-change 形式。提交前用 gt ls 确认第一个 PR 的父分支是 main,若不对则 gt checkout <first-branch>、gt track -p main、gt restack。提交后用 gh pr edit 更新标题与描述,并建议用 Write 工具生成 /tmp/pr-body.md 再以 --body-file 传入,避免 shell 转义破坏 Markdown。PR 描述应包含 Stack Context 和 Why? 等部分。遇到未跟踪分支报错时,可先 gt track -p main。
限制与排障:资料说明 gt restack 会重排所有需要重排的分支,可能命中无关分支冲突,此时可改用定向 git rebase <target>,配合 git rebase --continue 或 --skip,之后用 gt modify --no-edit 同步跟踪信息。未提供该技能的收费、平台限制或其它功能细节。