@jspg-ai/coding-bb 0.0.3-beta.26 → 0.0.3-beta.28

package/cbb/dev-standards/rules/cbb-ai-behavior.md

@@ -112,7 +112,7 @@ trigger: always_on
 **模式二 · worktree 模式（并行 / 隔离）：**
 
 - `cbb-worktree-init` 建隔离 worktree（AI 配置内容子目录已 junction 就位），**开发会话开进 `.worktrees/worktree-<需求名>/`**，可多需求并行；app 检出收拢在 `<wt>/.codespace/<app>/`——**镜像空间根布局**（`.codespace/<app>/...` 相对路径两模式通用，ADR 0003）
-- 根会话保留作控制面（worktree 生灭、`cbb update` 等空间级操作）；**会话形态按工具定**：桌面端单窗口 = 当前窗口把工作区根切进 worktree（上下文保留，空间根路径在案供回切）；CLI/TUI = 新开会话进 worktree
+- 根会话保留作控制面（worktree 生灭、`cbb update` 等空间级操作）；**会话形态按工具定，能自动则 agent 亲自做**：OpenCode 桌面端 = agent 自动把会话切进/切出 worktree（`session_move`，上下文保留、不列入用户待办，空间根路径在案供回切）；无会话搬移能力的桌面端 = 用户手动切根；CLI/TUI = 新开会话进 worktree
 
 **基准与防线（两模式共同，ADR 0002）：**
 

package/cbb/worktrees/skills/cbb-worktree-close/SKILL.md

@@ -323,21 +323,23 @@ node "<skill_dir>/scripts/remove-worktrees.js "<ws_root>" "<branch>" "<force>"
 
 所有 worktree 已成功移除后，如果当前 shell 的工作目录位于**已被关闭的 worktree 内**，需要主动让 IDE 窗口切回 `WS_ROOT`，避免 IDE 窗口指向已删除的目录。
 
-> ⓘ **本节是 close-worktree 专属逻辑**：与 init-worktree 的 Step 5 不共享、不交叉同步。init-worktree 负责"创建后**在新窗口打开** worktree"，本节负责"关闭后切回根目录"，两者职责独立。
+> ⓘ **本节是 close-worktree 专属逻辑**：与 init-worktree 的 Step 5 不共享、不交叉同步。init-worktree 负责"创建后把开发会话开进 worktree"，本节负责"关闭后切回根目录"，两者职责独立。
 
 **AI agent 行为**：
-1. 检查当前 cwd 是否在被关闭的 worktree 内
-2. 仅当匹配时，调用对应 IDE 的 `--reuse-window` 命令切回 WS_ROOT：
+1. 检查当前会话 / IDE 窗口是否指向被关闭的 worktree
+2. **OpenCode 等支持会话搬移的工具**：agent 亲自经 code-mode 调用 `opencode.session_move` 把会话切回 `<ws_root>`——自动完成、上下文保留、**不列入用户待办**，切完核对工作目录
+3. **Qoder / Cursor / VS Code**：调用对应 IDE 的 `--reuse-window` 命令切回 WS_ROOT：
    - Qoder → `qoder --reuse-window "<ws_root>"`
    - Cursor → `cursor --reuse-window "<ws_root>"`
    - VS Code → `code --reuse-window "<ws_root>"`
-3. **JetBrains 跳过主动切换**——`idea64 <path>` 会启动新进程或提示"打开/在新窗口打开"，让用户手动操作
+4. **JetBrains 跳过主动切换**——`idea64 <path>` 会启动新进程或提示"打开/在新窗口打开"，让用户手动操作
 
 **关键点**：
-- **只在 pwd 匹配被关闭的 worktree 时触发**——如果 IDE 窗口本身在 WS_ROOT 内，或会话位于其他目录，再切一次是多余的
+- **只在会话 / 窗口匹配被关闭的 worktree 时触发**——如果已在 WS_ROOT 内，再切一次是多余的
+- **OpenCode 会话切回是零成本自动动作**——`session_move` 复用当前会话（上下文保留、无新窗口），agent 亲自做，严禁推给用户
 - **仅切 Qoder / Cursor / VS Code**——这三者的 `--reuse-window` 是轻量级"切目录"，不重启 IDE
 - **不会产生孤立窗口**——`--reuse-window` 是复用当前窗口切换目录，**不会打开新窗口**。即使 IDE 已开着指向 WS_ROOT 的其他窗口，本步骤也不会重复创建，仅是把当前指向已删除目录的窗口切走
-- **失败不致命**——`--reuse-window` 失败时仅警告，后续分支删除不受影响
+- **失败不致命**——`session_move` / `--reuse-window` 失败时仅警告，后续分支删除不受影响
 
 ### 4.4 分支处理（默认跳过，按需手动调用）
 
@@ -384,7 +386,7 @@ git -C "<ws_root>" worktree list
 
 目标 worktree 应已不在列表中。
 
-**工作区回根交接（必须执行）**：若用户的开发会话工作在 worktree 内（桌面端切根工作流，当前窗口的工作区根 = 已删除的 `<wt_path>`），此刻目录树已悬空——必须提示用户把工作区切回 `<ws_root>`（打开文件夹 / Open Folder / 切换工作目录），并在最终报告中给出该绝对路径。
+**工作区回根交接（必须执行）**：若用户的开发会话工作在 worktree 内（当前会话工作目录 = 已删除的 `<wt_path>`），此刻目录已悬空——**OpenCode 等支持会话搬移的工具由 agent 自动 `session_move` 切回 `<ws_root>`，不列入用户待办**；无该能力的工具才提示用户把工作区切回 `<ws_root>`（打开文件夹 / Open Folder / 切换工作目录），并在最终报告中给出该绝对路径。
 
 ---
 
@@ -404,7 +406,7 @@ git -C "<ws_root>" worktree list
     （无未归档 change 时不显示本节）
   分支处理：feature-xxx 已保留（默认行为；如需删除分支，手动调用 scripts/delete-branches.js）
   剩余工作空间 worktree：<列出仍存在的，或 "无" >
-  👉 若你的窗口目录树仍停在已删除的 worktree，请切回工作空间根：<ws_root 绝对路径>
+  👉 仅当所用工具不支持自动切根、且你的窗口仍停在已删除的 worktree 时，请手动切回工作空间根：<ws_root 绝对路径>
   Workspace cleaned up.
 ```
 

package/cbb/worktrees/skills/cbb-worktree-init/SKILL.md

@@ -18,7 +18,7 @@ description: "为一个需求在 workspace 与各关联应用仓库同步创建
 - **AI 配置 junction（ADR 0002 防线 B）**：创建 worktree 后把根的 AI 配置**内容子目录**（rules / skills / commands）junction 进工作树——开发会话开在 `<wt_path>`（上游 `/opsx:*` 相对路径原样生效，零翻译）；工具状态落在工作树自建空壳目录，不互相污染；`cbb update` 在根跑一次全 worktree 生效
 - **本技能必须在业务工作空间根目录执行**（即由 `cbb setup` 初始化、包含 `CBB-WORKSPACE.json` 的目录）
 - 输入约定：**自由文本**（需求名等）直接在对话中提问并等待回复，禁止使用 `AskUserQuestion`；`AskUserQuestion` 仅用于固定选项决策场景（如 push 失败处理、远程分支已存在时的二选一）
-- 关联应用默认为 `CBB-WORKSPACE.json` 的**全量 apps**；支持按需求语境传入**应用子集**（见 Step 1），需要增减应用时编辑该文件并重跑本技能（幂等）
+- 关联应用恒为 `CBB-WORKSPACE.json` 的**全量 apps**，AI 不询问范围、不从需求语境收窄（worktree 单仓库创建成本低，全量镜像空间根布局）；仅当**用户显式点名**应用时才经 `--apps` 传子集（见 Step 1），需要增减应用时编辑该文件并重跑本技能（幂等）
 - **模式选择（ADR 0002）**：接到需求先判断用户要哪种模式——要**并行 / 隔离** → 本技能；**单线程快改、当前会话就地干** → 引导 `cbb-local-mode`。用户明确指定即遵从，agent 只给推荐不代决
 
 ---
@@ -143,7 +143,7 @@ worktree 需要知道要关联哪些应用仓库。
 
 ## Step 1：关联应用与代码同步
 
-> ⓘ **关联应用 = 需求涉及的应用子集**：从需求语境提取（"改订单导出" → 订单相关应用）；纯 workspace 内容的需求 → 仅 workspace。子集判断错了零代价——重跑本技能幂等补齐（已存在的分支/worktree 自动复用，详见「幂等重跑」章节）。涉及全部应用 / 不确定时用全量。
+> ⓘ **关联应用 = 全量 apps**：直接使用 `CBB-WORKSPACE.json` 的全部应用，**不询问范围、不从需求语境收窄**。仅当用户显式点名应用（如"只建 jspg-cvat"，典型用于排除状态异常的无关仓库）时才传子集。范围判断错了零代价——重跑本技能幂等补齐（已存在的分支/worktree 自动复用，详见「幂等重跑」章节）。
 > 需要增减应用时，编辑 `CBB-WORKSPACE.json` 后**重跑本技能**即可。
 
 ### 1.1 同步 `.codespace/` 目录代码
@@ -164,10 +164,10 @@ node "<skill_dir>/scripts/sync-repos.js" "<ws_root>"
 
 ### 1.2 最终输出
 
-列出本次关联的应用（按 Step 1 确定的子集）及本地路径（保留序号便于复核），向用户展示并确认：
+列出本次关联的应用（全量，或用户显式指定的子集）及本地路径（保留序号便于复核），**仅作信息展示，不作为提问确认点**：
 
 ```
-确认关联应用（需求 <需求名> 涉及子集）：
+关联应用（需求 <需求名>，全量）：
   后端：
     [1] ep-user-auth-app  → .codespace/ep-user-auth-app
     [2] ep-user-info-server → .codespace/ep-user-info-server
@@ -175,7 +175,7 @@ node "<skill_dir>/scripts/sync-repos.js" "<ws_root>"
     [3] ep-user-web → .codespace/ep-user-web
 ```
 
-> 后续所有步骤中的 `APP_REPOS` 均指向 `$WS_ROOT/.codespace/<应用名>/`，不再依赖开发者手动配置本地路径。**子集应用名单由 AI 在对话上下文维护，经 `--apps` 参数传给 Step 3.3 / 3.5 脚本（逗号分隔）；不传 = 全量。**
+> 后续所有步骤中的 `APP_REPOS` 均指向 `$WS_ROOT/.codespace/<应用名>/`，不再依赖开发者手动配置本地路径。**缺省不传 `--apps`（= 全量）；仅当用户显式点名应用时，才把子集名单经 `--apps` 参数传给 Step 3.3 / 3.5 脚本（逗号分隔）。**
 
 ---
 
@@ -241,7 +241,7 @@ node "<skill_dir>/scripts/update-gitignore.js" "<ws_root>" "<branch>"
 node "<skill_dir>/scripts/create-branches.js" "<ws_root>" "<branch>" [--apps "app1,app2"]
 ```
 
-- `--apps`：Step 1 确定的应用子集（逗号分隔）；缺省 = 全量
+- `--apps`：仅用户显式点名应用时传入（逗号分隔）；缺省 = 全量
 
 **解读输出**：
 - 退出码 0 + 末行 `BRANCH_RESULT [...]` → 全部创建或复用成功
@@ -275,7 +275,7 @@ node "<skill_dir>/scripts/create-branches.js" "<ws_root>" "<branch>" [--apps "ap
 node "<skill_dir>/scripts/create-worktrees.js" "<ws_root>" "<branch>" [--apps "app1,app2"]
 ```
 
-- `--apps`：与 Step 3.3 相同的应用子集；缺省 = 全量
+- `--apps`：与 Step 3.3 相同（仅用户显式点名时传入）；缺省 = 全量
 
 脚本内部自动完成：
 1. **元数据自愈**：仅 `git worktree prune`（清理"目录已缺失/失效"的注册项）；**绝不删除任何物理目录**（0.0.3-beta.11 起——旧版"清理无元数据残留目录"因 Windows 路径分隔符不匹配会误删活跃 worktree，已整体移除）
@@ -320,8 +320,9 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 
 不执行脚本。AI agent 向用户输出最终报告（格式见「最终报告」），并完成以下交接声明：
 
-1. **开发会话开进 worktree**（按工具形态，二选一）：
-   - **桌面端（单窗口工作流）**：将当前窗口的工作区根切到 `<wt_path>`（打开文件夹 / Open Folder / 切换工作目录）——**无需新窗口**，聊天上下文保留；AI 配置已 junction 就位（`/opsx:*` 等命令照常可用），`.codespace/<app>/...` 相对路径原样生效
+1. **开发会话开进 worktree**（按工具形态，**能自动则 agent 亲自做，不推给用户**）：
+   - **OpenCode 等支持会话搬移的工具（桌面端单窗口工作流）**：由 **agent 自己**把当前会话的工作目录切到 `<wt_path>`（经 code-mode 调用 `opencode.session_move`，`directory = <wt_path>`）——聊天上下文保留、无需新窗口、**不列入用户待办**；AI 配置已 junction 就位（`/opsx:*` 等命令照常可用），`.codespace/<app>/...` 相对路径原样生效
+   - **无会话搬移能力的桌面端工具（Claude Code / Qoder 等）**：提示用户把当前窗口的工作区根切到 `<wt_path>`（打开文件夹 / Open Folder / 切换工作目录）
    - **CLI / TUI agent**：新开会话于 `<wt_path>`；根会话保留作控制面——后续创建/关闭 worktree、`cbb update` 等空间级操作在此执行
    - 无论哪种形态，**必须向用户报出空间根绝对路径 `<ws_root>`**（控制面地址：close 关闭 worktree 后回切用）
 2. **目录纪律（worktree 会话内自然成立）**：会话 cwd == 开发目录，上游相对路径原样生效；**分支感知 hook 已覆盖全部仓库**——任何落 main 的载荷提交会被拦截（大声失败是防线，不是故障）
@@ -336,9 +337,9 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 
 ```
 ✅ worktree 已创建：<wt_path>
-   关联应用：<应用名 → .codespace/<应用名> 路径> 列表（应用子集或全量）
+   关联应用：<应用名 → .codespace/<应用名> 路径> 列表（全量，或用户显式指定的子集）
 🔗 AI 配置已 junction 就位：rules / skills / commands（cbb update 一处生效）
-📌 开发会话开进 <wt_path>（桌面端：当前窗口切换工作区根即可，无需新窗口；CLI 端：新开会话）
+📌 开发会话已开进 <wt_path>（OpenCode：agent 已自动切换会话工作目录；CLI 端：新开会话；无搬移能力的桌面端：已提示用户切根）
    空间根路径（控制面，close 后回切）：<ws_root>
 👉 下一步建议：
    1. 开始需求开发（开发会话内，二选一）：
@@ -379,7 +380,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 | workspace 主分支 tracked 内容（openspec/、cbb/ 等） | 自动 checkout 到工作树，无需额外动作（cp/clone 都是多余的） |
 | AI 配置目录（.claude/、.qoder/、.opencode/ 等） | Step 3.6 junction 内容子目录进工作树；唯一物理副本在空间根，`cbb update` 一处生效 |
 | 需求名（同时作分支名和工作树目录名） | 用户在对话中纯文本输入，参考 Step 3.1 命名规则（kebab-case，禁 `..`、路径分隔符、空格） |
-| 关联应用范围 | 需求语境提取子集（`--apps` 传入，缺省全量）；增减应用后重跑本技能（幂等） |
+| 关联应用范围 | 恒为全量（不询问、不从需求语境收窄）；用户显式点名应用时 `--apps` 传子集；增减应用后重跑本技能（幂等） |
 | 单线程快改 / 不需要隔离 | 引导 cbb-local-mode（本地模式，就地切分支） |
 | 运行环境 node 不可用 | 脚本 fail-fast 并提示用户到系统终端重试 |
 | 推送（认证/网络/保护分支/远程已存在） | 不在本技能——`cbb-worktree-push` 处理（lazy push，ADR 0002） |
@@ -432,7 +433,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 ### 完成后开发会话未开进 worktree
 
 - **问题：** 流程结束后开发会话仍停留在工作空间根目录（junction 好的 AI 配置没人加载），agent 在根会话里靠路径翻译干活，回到第一代失败模式
-- **修复：** Step 4 交接必须明确"开发会话开在 `<wt_path>`"（桌面端 = 当前窗口切工作区根；CLI = 新开会话）；根会话保留作控制面（worktree 生灭、`cbb update`）
+- **修复：** Step 4 交接必须确保"开发会话开在 `<wt_path>`"（OpenCode 等支持会话搬移的工具 = agent 亲自经 `session_move` 切换、不列入用户待办；无该能力的桌面端 = 提示用户切根；CLI = 新开会话）；根会话保留作控制面（worktree 生灭、`cbb update`）
 
 ### 用 `git checkout -b` 在创建 worktree 前切分支
 
@@ -473,7 +474,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 - 严格 Step 3.3 → Step 3.5 顺序（先统一创建分支，再统一创建 worktree；workspace 工作树先建，各应用按序补建）
 - Step 3.6 junction AI 配置（失败不阻塞，但要报告）
 - 所有脚本调用以 `node "<skill_dir>/scripts/<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 缺省由脚本内部从 CBB-WORKSPACE.json 读取，子集用 `--apps` 传入）；**执行时 cwd 保持在工作空间根**（`check-env.js` / `parse-config.js` 按 cwd 定位）
-- Step 4 交接必须声明"开发会话开在 `<wt_path>`（桌面端 = 当前窗口切工作区根，CLI = 新开会话）、空间根路径在案作控制面"
+- Step 4 交接必须确保"开发会话开在 `<wt_path>`"（支持会话搬移的工具 = agent 自动 `session_move` 切换，**禁止把切根列入用户待办**；其余 = 用户切根 / CLI 新开会话）、空间根路径在案作控制面
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.26",
+  "version": "0.0.3-beta.28",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {