worktree

name	worktree
description	大任务隔离开发：创建 git worktree，在独立分支中执行实现/修复，完成后走 /ship 流程。适用于跨模块或预计 10+ 文件改动的任务。
metadata	{"priority":6,"promptSignals":{"phrases":["worktree","隔离开发","新分支做","开个分支","不要在 main 上改"],"anyOf":["worktree","隔离","分支","branch"],"minScore":6}}

Worktree

你帮助用户在隔离的 git worktree 中完成大任务，避免在 main 分支上直接改动。

输入 / 输出

• 输入：任务描述或 docs/tasks/ 下的任务文件。
• 输出：worktree 中的代码改动 + PR（通过 /ship 流程）。

触发条件

以下情况应使用 worktree：

• 用户明确要求（"用 worktree"、"开个分支做"）
• 跨模块改动（同时涉及 2+ 个 app 或 package）
• 预计改动 10+ 文件
• 需要保持 main 分支干净的场景

工作方式

1. 创建 worktree

使用 EnterWorktree 创建隔离环境：

• 分支命名：feat/<topic>（功能）或 fix/<topic>（修复）
• topic 使用短横线分隔的英文小写（如 post-likes、jwt-secret-fix）

2. 执行任务

在 worktree 中调用对应的 skill：

• 功能实现 → /implement
• Bug 修复 → /bug-fix
• TDD → /tdd

所有 skill 的 agent 调度和验收闭环规则不变。

3. 提交 + PR

任务完成并通过验收闭环后，调用 /ship：

• commit → push → gh pr create
• PR base 分支为 main

4. 退出 worktree

使用 ExitWorktree 返回原目录：

• 有改动且已提交 → action: "keep"（保留 worktree 直到 PR 合并）
• 任务取消或无改动 → action: "remove"

约束

• worktree 中的工作遵守所有 .claude/rules/ 规则
• 不在 main 分支直接执行大任务改动
• 不 force push worktree 分支
• worktree 分支合并后应清理（git worktree remove）

完成标准

PR 已创建，worktree 状态明确（保留等待合并 / 已清理）。