SuperAPI AI 工具集

code-stacked-commit

通用与其它

查看项目

更新于 10-16 08:41

技能介绍

用途:该技能用于借助 Graphite CLI 管理堆叠提交,适合把一项工作拆成多个小而可审查的提交,或需要同步、提交堆叠式 PR 的场景。

前置条件:需先安装 Graphite,命令为 brew install graphite-dev || npm install -g @graphite-dev/cli。

主要能力与用法: 查看当前堆叠:gt stack,显示堆叠中各分支及其状态(已同步、待推送、进行中)。 创建新提交:gt branch create "feat(auth): add JWT authentication",在当前堆叠之上新建分支并提交已暂存改动,可用 -m 内联提交信息;建议先 git add 指定文件再创建提交,按逻辑单元重复。 变基到主干:gt branch restack,把堆叠中所有分支变基到最新 main,提交前或 main 前进后使用。 同步远端:gt branch sync,拉取远端最新改动并重新堆叠。 提交为 PR:gt branch submit,为堆叠中每个分支创建 PR,浏览器打开首个 PR,后续 PR 链接到它。 继续修改分支:git add . 后执行 gt branch continue,将改动追加到当前分支。 堆叠导航:gt branch checkout @parent 切到父分支,gt branch checkout @child 切到子分支。

建议实践:每个提交只做一项逻辑改动;使用约定式提交信息;提交前先 restack;堆叠保持较小(3-5 个提交较理想);多人协作时经常 sync。

故障处理:restack 冲突时在编辑器中解决后执行 gt branch continue;堆叠损坏可用 gt branch repair 修复 detached HEAD;分支过多可用 gt branch delete <name> 删除(不会删除远端)。

提交信息格式:<type>(<scope>): <subject>,可选正文,例如 feat(api): add user profile endpoint、fix(db): resolve connection pool exhaustion。

限制:资料未提供该技能的收费、平台支持范围及更多边界条件,暂未提供。