用途:该技能让 AI 助手在 Graphite 仓库中改用 gt 命令管理分支与堆叠式 PR(stacked PRs),即相互依赖的 PR 链,适合单个 PR 难以承载的大型改动。
主要能力:自动检测当前仓库是否启用 Graphite(运行 bash skills/use-graphite/scripts/graphite-detect.sh,enabled: true 时使用 gt,false 时仍用标准 git/gh);通过 PreToolUse 钩子阻止 git push、gh pr create、git rebase、git commit --amend 等冲突命令;提供堆叠工作流、状态判断、故障排查与 PR 描述补全指引。
使用方式:先运行检测脚本,再用 gt log short 查看堆叠结构、git status 查看未提交改动。单 PR 流程为本地开发并验证后 gt create <branch>、git add 与 git commit、gt submit。堆叠流程按依赖逐层执行 gt create step-1-schema、step-2-api、step-3-ui,最后 gt submit --stack。命令对应关系:git checkout -b 用 gt create,git push 与 gh pr create 用 gt submit,git rebase main 用 gt restack,git commit --amend 用 gt modify -c。gt submit 生成的是草稿 PR 且描述为空,需用 gh pr view <N> --json body --jq '.body' 检查,再用 gh pr edit 补全标题与正文。
适用场景:大型功能(500 行以上)、重构加功能、数据库迁移加代码等按依赖拆分的改动;建议堆叠保持 3 至 5 个 PR,每日 gt sync。
限制:仅适用于已启用 Graphite 的仓库;git add、git commit、git status、git log、git diff、git stash 等仍照常使用;gt 不可用时需以 # BYPASS_GRAPHITE: <reason> 注释绕过钩子;安装与认证命令为 npm install -g @withgraphite/graphite-cli、gt auth login、gt repo init --trunk main。具体项目验证命令需自行查看项目配置,资料未提供统一命令。