SuperAPI AI 工具集

worktrees

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:该技能规定所有计划工作都在专用的 git worktree 中完成,不在主仓库检出中执行,从而实现隔离的计划执行环境。

主要能力:创建计划专用 worktree(约定路径 ../<repo-name>-worktrees/<plan-name>,分支 feat/<descriptive-name>,基于创建时的当前分支);在计划文件 specs/<plan-name>/plan.md 中记录 Worktree 的路径、分支和基分支;与基分支同步时使用变基而非合并;维护从 main/master 派生的预览分支 agent/<branch-name>,供他人检出预览;管理 worktree 生命周期(列出与移除)。

使用方式:从主仓库目录运行 git worktree add ../stream-chat-react-worktrees/<plan-name> -b <plan-branch-name> 创建;进入 worktree 后执行 yarn install。同步时运行 git fetch origin 与 git rebase origin/<base-branch>,遇冲突则解决后 git add 并 git rebase --continue,随后运行 yarn install、yarn types、yarn test。预览分支从主仓库创建 git checkout -b agent/<branch-name> origin/main 并推送,之后更新时检出该分支并合并计划分支再推送。移除时用 git worktree remove 及 git branch -d。

适用场景:需要将计划任务与主仓库隔离、在开发阶段前后同步基分支、或为他人提供预览分支时使用。

限制:不要在任务进行中同步;冲突解决时计划范围外文件优先采用基分支,计划拥有的文件优先采用 worktree;不要删除有未提交更改的 worktree(先提交或暂存);非必要不使用 git worktree remove --force;每个计划仅一个 worktree;未经明确批准不得从 worktree 推送;绝不要推送到远程。清单:git worktree list。计划结构与任务模板参见 make-plans 技能。