用途:该技能面向使用 Graphite 命令行工具 gt 管理堆叠式 pull request 的开发者,覆盖从创建分支、组织 PR 堆叠到提交审查的完整流程。
主要能力:创建分支与提交(gt create branch-name -m "message");修改当前分支(gt modify -m "message");在堆叠中导航(gt up、gt down、gt top、gt bottom);查看堆叠结构(gt ls);提交整组 PR 供审查(gt submit --no-interactive);将堆叠变基到主干(gt restack);调整父分支(gt track --parent <branch>);重命名分支(gt rename <new-name>);在堆叠中移动分支(gt move);非交互删除分支(gt delete <branch> -f -q,可用 --upstack/--downstack)。还包括处理未跟踪分支、拆分 PR、处理变基冲突以及针对复杂堆叠使用直接 git rebase 的说明。
用法要点:先 git add 暂存改动,再用 gt create 创建分支;重复以形成堆叠;提交前用 gt ls 确认首个分支以 main 为父分支,必要时执行 gt track -p main 与 gt restack。PR 描述建议写入 /tmp/pr-body.md 后用 gh pr edit <PR_NUMBER> --title "..." --body-file /tmp/pr-body.md,避免 Bash heredoc。分支命名建议采用“stack-feature/terse-description”形式。
适用场景:需要把一个较大的改动拆成多个可独立通过构建的小 PR、按栈审查与合并的团队协作流程;处理 worktrees 下的未跟踪分支;修复错误父分支或重排 PR。
限制:技能只描述 gt 与 git 操作,未提供安装方式、版本要求或平台支持信息,这些暂未提供;部分具体校验命令需参考项目自身配置(如 CLAUDE.md)。