菜单
在 bare repo + worktree 结构中创建隔离的工作目录。自动检测 workspace、同步配置、 安装依赖和 git hooks。当用户说"创建 worktree"、"新 worktree"、"create worktree"、 "新建分支"、"开个新分支"时使用此 skill。即使用户只是说"我要做一个新功能"或 "帮我开个分支做 xxx"，也应考虑触发此 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
完成 worktree 的完整合并流程：本地验证 → PR CI → merge → post-merge CI → 发布准备 → Release Notes → 创建 Release → 清理。 使用 git merge --no-ff 保留完整分支历史。 支持项目级钩子（.bare/custom-hooks/）实现个性化发布流程。 触发词："合并worktree"、"merge-worktree"、"合并PR"、"发布"、"release"、"上线"。
Reference for writing workflow JS scripts. Auto-loaded when using workflow-generate or writing/editing workflow scripts for Pi. Covers runtime environment, injected globals, constraints, and script patterns. Not for general coding or subagent usage.
Use when the user says "轻量执行", "lite execute", "按 Wave 执行", "goal 模式执行 plan", "执行 plan", or has a completed plan.md (from lite-plan) or execution-plan.md (from mid-detail-plan) and needs to execute the Waves. ADR-029 后阶段 A+B 由 workflow run execute-full-workflow 机器接管（worktree-setup → dev waves → test+review → cleanup），主 agent 不再直接派 subagent。 对应 CW action: dev (workflow 内 implementer 渐进式提交) + test (workflow 内 test-runner 渐进式提交). Not for planning (lite-plan / mid-detail-plan). Not for retrospect (coding-retrospect).
Use when the user says "issue拆分", "问题分解", "issue decomposition", "方案对比", "tradeoff analysis", "优先级排序", or has finished system-architecture.md and needs to break it into prioritized issues with solution comparisons. Produces issues.md as a fog-of-war decision map. Step 3 of 6. Not for business requirements (Step 1) or architecture modeling (Step 2). Not for non-functional risk analysis (Step 4) or code-level design (Step 5).
Use when the user says "mid 详细计划", "中等功能实施设计", "issues+nfr+架构+计划一起做", "批量设计实施", or has finished mid-plan and needs issues.md + non-functional-design.md + code-architecture.md + execution-plan.md (+ code-skeleton) + detail.json (CW detail action 入参). 纯设计 skill，不写实现代码。对应 CW action: detail. Not for L3 heavy (use full-*). Not for requirements/architecture (that is mid-plan).
[internal] Shared reference files for the lite workflow (lite-plan / coding-execute / coding-retrospect). Not invoked directly — sibling lite-* skills resolve paths via ../lite-shared/references/{file}.md. Kept hidden from model invocation.
| name | create-worktree |
| description | 在 bare repo + worktree 结构中创建隔离的工作目录。自动检测 workspace、同步配置、 安装依赖和 git hooks。当用户说"创建 worktree"、"新 worktree"、"create worktree"、 "新建分支"、"开个新分支"时使用此 skill。即使用户只是说"我要做一个新功能"或 "帮我开个分支做 xxx"，也应考虑触发此 skill。 |
在 bare repo + worktree 结构中创建新分支的隔离工作目录。
create-worktree.sh <branch-name> [base-branch]
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
branch-name | $1 | 是 | 分支名，如 feat/new-feature。/ 自动转为 - 作为目录名 |
base-branch | $2 | 否 | 基础分支。省略时自动检测远程 HEAD 分支（通常为 main） |
# 创建新功能分支（基于 main）
bash ~/.claude/skills/create-worktree/create-worktree.sh feat/new-feature
# 基于指定分支创建
bash ~/.claude/skills/create-worktree/create-worktree.sh fix/bug develop
# 检出已有分支
bash ~/.claude/skills/create-worktree/create-worktree.sh 024-ai-data-api
.bare/ 的目录）git fetch origin --prune 获取最新远程引用base-branch 创建新分支.claude/settings.local.jsonfrontend/package.json 存在 → pnpm install（回退 npm install）package.json 且无 frontend/ → npm installbackend/pyproject.toml → uv sync成功时输出：
Workspace: /path/to/project-workspace
基础分支: main
Fetching from remote...
创建分支 'feat/new-feature' (基于 origin/main)...
已复制 .claude/settings.local.json (from main)
已安装 git hooks
============================================
Worktree 创建完成!
分支: feat/new-feature
路径: /path/to/project-workspace/feat-new-feature
============================================
| 退出码 | 输出 | 原因 |
|---|---|---|
| 1 | Error: 未找到 workspace | 当前目录不在 workspace 内，需要 cd 到 workspace 子目录 |
| 1 | Error: .bare/ 不是一个有效的 bare git 仓库 | workspace 结构损坏 |
| 1 | Error: 目录 'xxx' 已存在 | 同名 worktree 已存在 |
bash ~/.claude/skills/create-worktree/create-worktree.sh <branch-name> [base-branch]"Worktree 创建完成!"