mstar-branch-worktree

Load order（必读顺序）

首次 Read 本 skill 前：必须先 Read mstar-harness-core（SKILL.md）。 冲突时 以 mstar-harness-core 为准。

Spec 多 plan 命名（iteration_base_branch、spec_integration_branch、target_branch PR 门禁）→ mstar-conventions。L1/L2 worktree 分层（迭代 control vs feature、plan 内并行轨）→ 下文 「Worktree isolation layers」；L2 同仓并行可写派发前清单 → references/parallel-writable-pre-dispatch.md；迭代 lease claim/merge 细则 → mstar-iteration references/phase-2-worktree-lease.md（勿在本 skill 重复完整协议表）。下文为分支与 QC/QA 检出对齐主文。

Scope（摘要）

• 仅 PM 决定分支；其他可写角色不得自行新开分支或切回 main。
• Assignment 须含其一：Working branch: <existing> | create <new> from <base> | Branch policy: direct on <branch> — <reason>。
• L1（跨 plan / 迭代 Phase 2）：control worktree（snapshot control_worktree_path，检出 spec_integration_branch）+ 每 plan 独立 feature worktree（execution_lease.worktree_path ≠ control 路径）+ lease；见 「Worktree isolation layers」。
• L2（同 plan 内 ≥2 可写并发）：派发 前 完成 references/parallel-writable-pre-dispatch.md（含 git worktree、绝对 Worktree path；N 次并行 invoke ≠ 已隔离）。单 plan 多轨时 L1 不替代 L2。
• QC/QA 前：待审提交归并到 单一 Working branch HEAD；三审 + QA 共用一套 Review cwd + plan_id + Review range / Diff basis（逐字相同）。

Git 功能分支、同仓并发与 Worktree 对齐

Git 功能分支门禁（业务仓库）

适用于 cwd 为 Git 托管的业务/应用仓库 且本轮会产生仓库内可合并 diff 的任务（代码、业务向测试与 fixture、影响构建或运行时的配置等）。不用于约束 ~/.config/opencode/ 全局配置目录（该目录对 agent 只读；落盘仅由用户执行）。

默认规则

• 不得在默认保护分支（常见名：main、master；以项目约定为准）上直接实现功能改动，除非 Assignment 含显式例外。
• 例外须在 Assignment 中写明一行：Branch policy: direct on <branch> — <reason>（典型：团队约定的热修直接打默认分支）。

<base> 与叠分支（stacked branches）

• 门禁的目标是不在未授权的默认分支上直接提交，不是「只能从 main 开新分支」。
• 当需要从已有功能分支继续拆新分支时，Assignment 应写清祖先分支 <base>，例如：create feature/foo-part2 from feature/foo。
• <base> 可取：main / master（或项目默认分支名）、任意已存在的 feature/* / fix/*、远程跟踪分支名、或 current（表示以执行者检出时的 HEAD 为祖先，用于「就在当前分支上再拉一枝」）。
• 若只写 Working branch: feature/foo且无「create … from …」：表示沿用 / 切到该已存在分支上开发，不要求新建。
• 若写新建但未写 <base>：实现侧应停下问 project-manager（或按项目 AGENTS.md 的默认 base）；禁止擅自假设「一定是 main」。