git-worktree

git-worktree

多 worktree 并行开发管理工具。主仓库当前 checkout 的分支即主干分支，是唯一主干，所有 worktree 的改动最终合并回主干。worktree 与任何总控/任务体系解绑——同一 worktree 可承载多个任务，若项目启用了 control skill，通过 $control switch 切换。

约定探测（所有操作的公共前置）

# 主仓库路径 = git worktree list 的第一行（git 保证主仓库永远排第一）
MAIN_ROOT=$(git worktree list | head -1 | awk '{print $1}')
# 主干分支 = 主仓库当前 checkout 的分支
TRUNK_BRANCH=$(git -C "$MAIN_ROOT" branch --show-current)
# worktree 目录命名前缀 = 主仓库目录名
REPO_NAME=$(basename "$MAIN_ROOT")
PARENT_DIR=$(dirname "$MAIN_ROOT")

# 布局探测：主仓库目录名 == 主干分支名（容器目录布局，如 ~/projects/myrepo/main）→ worktree 不带前缀
if [ "$REPO_NAME" = "$TRUNK_BRANCH" ]; then
    WT_PREFIX=""              # 容器布局：worktree 目录 = PARENT_DIR/{名称}
else
    WT_PREFIX="$REPO_NAME-"   # 传统布局：worktree 目录 = PARENT_DIR/{REPO_NAME}-{名称}
fi

若 TRUNK_BRANCH 探测为空（主仓库处于 detached HEAD），停下询问用户主干分支名，不猜测。

合并原则（所有涉及合并的操作均遵守）

1. 先提交源分支的未提交改动
2. 再提交目标分支的未提交改动
3. 执行 merge
4. 遇到冲突直接解决，不 stash、不建中间分支

---

触发入口（强制）

skill 被调用后，第一步必须用当前运行时支持的对话内菜单询问用户选择操作；无菜单工具时用纯文本列出选项：

问题：你想执行哪个 worktree 操作？

选项：

• 新建 worktree：从主干拉出新分支，在兄弟目录创建 worktree
• 合并到主干：把当前 worktree commit 并 merge 到主干（完工时用）
• 主干同步到所有 worktree：把主干 merge 进每个 feature worktree（重大改动时用）
• 清理当前 worktree：验证已全部合并到主干后删除 worktree 和分支

根据用户选择跳到对应 §。

---

§A. 新建 worktree

输入：向用户询问英文任务名（如 coupon-center、order-export）

命名规则：

• 目录名：{WT_PREFIX}{名称}（传统布局为 {REPO_NAME}-{名称}，容器布局直接 {名称}，探测逻辑见「约定探测」）
• 路径：主仓库的兄弟目录（PARENT_DIR/{WT_PREFIX}{名称}）
• 分支：feature/{名称}，从最新主干拉出
• 禁止放在主仓库任何子目录内（会污染 git status）

执行命令：

# 先跑「约定探测」得到 MAIN_ROOT / TRUNK_BRANCH / REPO_NAME / PARENT_DIR / WT_PREFIX
NAME="<用户提供>"

# 更新主干
git -C "$MAIN_ROOT" fetch origin "$TRUNK_BRANCH"

# 创建 worktree
git -C "$MAIN_ROOT" worktree add "$PARENT_DIR/$WT_PREFIX$NAME" -b "feature/$NAME" "$TRUNK_BRANCH"

# 验证
git -C "$MAIN_ROOT" worktree list

完成后：告知用户新 worktree 的完整路径和分支名。

---

§B. 合并当前 worktree 到主干

适用场景：当前 worktree 完工，把改动 merge 到主干。不同步到其他 worktree（如需同步，之后再执行 §C）。