SuperAPI AI 工具集

use-worktrees

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:该技能用于通过 Git worktree 将功能或里程碑工作隔离在独立目录中,避免不同开发任务互相干扰。

主要能力与用法: 创建:worktree 统一放在 ~/worktrees/<repo-dir>/<branch-slug>,分支名中的 / 换成 -。命令为 git worktree add ~/worktrees/<repo-dir>/<branch-slug> -b <branch> <target-branch>。对已有分支(如打开的 PR),先执行 git fetch origin <branch>:<branch>,并去掉 -b。在 herdr(HERDR_ENV=1)中不要用 herdr worktree create,应在当前工作区新开 pane:herdr pane split --current --direction right --cwd <worktree-path> --no-focus,并用 herdr pane report-metadata <new-pane-id> --source agentmanager --token parent=$HERDR_PANE_ID 标记为 worker。之后安装依赖,并从主检出复制 .env 等被忽略的配置。并行 worktree 需各自独立的部署阶段,不得让并行检出改动同一部署状态。 同步:在检查点以及可能被并行工作影响前,用 git merge <target-branch> 把目标分支合并进 worktree 分支;不要对共享分支做 rebase 或改写。每次同步后运行完整检查套件。若目标与当前分支占用了同一迁移编号,需重新编号;lockfile 保留双方 manifest 改动并重新生成,不要手改。 收尾:做最终同步、通过检查、推送并创建 PR;不要自行合并到目标分支,合并应在 PR 上按用户要求进行。禁止 force-push,禁止批量 --theirs/--ours 解决冲突。 清理:创建者负责移除 worktree,正在其中工作的 agent 不要动它。提交、推送并进入 PR 后应立即移除:git worktree remove <path>、git branch -d <branch>,并关闭为其打开的 herdr pane。若仍有未提交或未推送内容,需先报告,仅在用户明确批准后才能移除。

限制:具体依赖安装方式、检查套件命令和部署阶段配置资料未提供。