team-skills 1.6.1 → 1.6.2

package/CHANGELOG.md

@@ -7,6 +7,16 @@
 
 ## [Unreleased]
 
+## [1.6.2] - 2026-06-29
+
+### 变更
+
+- team-orchestrator: Step 1.5.2 从自动创建功能分支改为分支策略选择（Fork/不Fork），用户显式选择是否创建新分支
+- team-orchestrator: 移除"当前分支≠基准分支时自动跳过"的隐式规则，仅保留 `--no-branch` 显式跳过
+- team-orchestrator: Mermaid + ASCII 流程图分支步骤标签同步更新
+- team-finish: Step 2 新增当前分支获取 + 基准分支守卫（`branch == base_branch` 时 BLOCKED）
+- team-finish: Step 3 选项模板增加分支信息展示，选项描述使用具名分支变量 `{branch}`
+
 ## [1.6.1] - 2026-06-28
 
 ### 变更

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "team-skills",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "AI Agent Skills framework — Spec-Driven development with directed-graph rollback and quality gates",
   "type": "module",
   "bin": {

package/skills/team-finish/SKILL.md

@@ -94,10 +94,12 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
 - **IF** `exit_code == 0` → 逐条排除占位符/测试值/注释 → 真实凭证 → **BLOCKED**，**WRITE**（对话中）凭证位置，要求修复后重新验证
 - **ELSE** → **GOTO** Step 2
 
-### Step 2：确定基准分支
+### Step 2：确定当前分支与基准分支
 
 > 精确找到合并目标。基准错误 = 合并到错误分支，后果比不合并更糟。
 
+**EXEC** `git branch --show-current` → **ASSERT** `exit_code == 0` → 获取 `branch`
+
 **RESOLVE** `base_branch`（首个命中即停）：
 
 1. `READ("docs/tasks/{slug}/.checkpoint.json").base_branch`
@@ -112,6 +114,8 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
 
 - 失败（分支无公共祖先）→ **BLOCKED**，触发 **ASK_HUMAN**
 
+**IF** `branch == base_branch` → **WRITE**（对话中）"当前已在基准分支 {base_branch} 上，无功能分支需要完成。" → **BLOCKED**
+
 ### Step 3：展示选项
 
 > 让用户在完整信息下做选择。选项列表必须覆盖所有合理路径，不替用户预判。
@@ -119,22 +123,23 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
 **WRITE**（对话中）选项列表：
 
 ```
+当前分支：{branch}，基准分支：{base_branch}
 实现完成，测试已通过。请选择集成方式：
 
 1. [默认] 合并到 {base_branch} 并推送
-   → push 功能分支（留档） → merge 到 {base_branch} → push {base_branch} → 清理本地功能分支
+   → push {branch}（留档） → 切换到 {base_branch} → merge → push → 清理 {branch}
    适用：有合并权限，可直接集成
 
 2. 创建 Pull Request
-   → push 功能分支 → 创建 PR 等待审查
+   → push {branch} → 创建 PR 等待审查
    适用：需要 Code Review 或 CI 门禁
 
 3. 保留当前分支
-   → 不做任何操作，功能分支原样保留
+   → 不做任何操作，{branch} 原样保留
    适用：尚需打磨，或等待外部依赖就绪
 
 4. 丢弃本次工作（需二次确认）
-   → 切回 {base_branch} → 强制删除功能分支
+   → 切换到 {base_branch} → 强制删除 {branch}
    适用：实验性工作，确认不再需要
 
 请选择 [1]：

package/skills/team-orchestrator/SKILL.md

@@ -11,7 +11,7 @@ description: Use when task needs full spec→impl→test→review pipeline with
 
 ```mermaid
 flowchart TD
-    CONFIRM_GOAL["CONFIRM_GOAL: 人类确认目标"] --> branch["创建功能分支"]
+    CONFIRM_GOAL["CONFIRM_GOAL: 人类确认目标"] --> branch["分支策略选择（Fork/不Fork）"]
     branch --> team-spec["team-spec: 规格制定"]
     team-spec --> CONFIRM_SPEC["CONFIRM_SPEC: 人类确认规格"]
     CONFIRM_SPEC --> team-impl["team-impl: TDD 实现"]
@@ -102,8 +102,8 @@ NO AGENT DISPATCH WITHOUT CONFIRM_GOAL HUMAN CONFIRMATION FIRST
                      │ 确认  │ 不确认 → 返回修改
                      ▼       └────────┐
               ┌──────────────────┐     │
-              │  创建功能分支     │     │
-              │  {slug} 分支     │     │
+              │  分支策略选择     │     │
+              │  Fork / 不Fork   │     │
               └──────┬───────────┘     │
                      │                 │
                      ▼                 │
@@ -417,14 +417,34 @@ NO AGENT DISPATCH WITHOUT CONFIRM_GOAL HUMAN CONFIRMATION FIRST
 3. **FOR** `name` **IN** [`main`, `master`, `develop`]：**EXEC** `git show-ref --verify refs/heads/{name}` → **IF** `exit_code == 0` → 首个存在即停
 4. *NONE* → **ASK_HUMAN**，请求用户指定基准分支
 
-#### 1.5.2 创建功能分支
+#### 1.5.2 分支策略选择
 
-1. **EXEC** `git branch --show-current` → **ASSERT** `exit_code == 0` → 获取当前分支名
+1. **EXEC** `git branch --show-current` → **ASSERT** `exit_code == 0` → 获取 `current_branch`
 2. **EXEC** `git status --porcelain` → **ASSERT** `exit_code == 0`
    - **IF** `output` NOT_EMPTY → **GOTO** 1.5.2.1
-3. **EXEC** `git checkout -b {slug}`
-   - **IF** `exit_code != 0`（分支已存在）→ **EXEC** `git checkout {slug}` → **ASSERT** `exit_code == 0`
-4. **WRITE** checkpoint：`current_step=Step 2, branch={slug}, base_branch={基准分支名}, completed_steps 追加 Step 1.5`
+
+3. **WRITE**（对话中）分支策略选项：
+
+```
+当前分支：{current_branch}，基准分支：{base_branch}
+请选择分支策略：
+
+1. [默认] Fork — 从当前位置创建新分支 {slug}
+   适用：功能开发需要隔离，便于回退和 PR
+
+2. 不 Fork — 直接在当前分支 {current_branch} 上工作
+   适用：当前分支已是工作分支，或不需要分支隔离
+
+请选择 [1]：
+```
+
+**MATCH** `user_choice`：
+
+- `Option 1`（Fork，默认）→ **EXEC** `git checkout -b {slug}`
+  - **IF** `exit_code != 0`（分支已存在）→ **EXEC** `git checkout {slug}` → **ASSERT** `exit_code == 0`
+  - **WRITE** checkpoint：`current_step=Step 2, branch={slug}, base_branch={基准分支名}, completed_steps 追加 Step 1.5`
+- `Option 2`（不 Fork）→ **WRITE** checkpoint：`current_step=Step 2, branch={current_branch}, base_branch={基准分支名}, completed_steps 追加 Step 1.5`
+- *DEFAULT* → 请求用户从以上选项中选择
 
 #### 1.5.2.1：处理未提交变更
 
@@ -434,16 +454,15 @@ NO AGENT DISPATCH WITHOUT CONFIRM_GOAL HUMAN CONFIRMATION FIRST
 
 **MATCH** `user_choice`：
 
-- `stash 后继续` → **EXEC** `git stash` → **ASSERT** `exit_code == 0` → **GOTO** 1.5.2 步骤 3
-- `先提交再继续` → 等待用户提交 → **GOTO** 1.5.2 步骤 3
+- `stash 后继续` → **EXEC** `git stash` → **ASSERT** `exit_code == 0` → **GOTO** 1.5.2 步骤 3（展示分支策略选项）
+- `先提交再继续` → 等待用户提交 → **GOTO** 1.5.2 步骤 3（展示分支策略选项）
 - `取消` → **BLOCKED**
 - *DEFAULT* → 请求用户从以上选项中选择
 
 不自动 stash 或丢弃。
 
-**跳过条件**（不创建分支）：
+**跳过条件**（跳过分支策略选择，不展示选项）：
 
-- **IF** 当前分支名 ≠ `base_branch` → 使用当前分支，checkpoint 中 `branch` 记录当前分支名
 - **IF** 用户指定 `--no-branch` → 直接在当前分支上工作
 
 **恢复场景**：**IF** 断点续传（checkpoint 已有 `branch` 字段）→ **ASSERT** `当前分支 == checkpoint.branch`。不一致 → 提示用户切换分支，不自动切换。