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

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 生灭、`cbb update` 等空间级操作）；**会话形态按工具定**：桌面端单窗口 = 当前窗口把工作区根切进 worktree（上下文保留，空间根路径在案供回切）；CLI/TUI = 新开会话进 worktree
 
 **基准与防线（两模式共同，ADR 0002）：**
 

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

@@ -384,6 +384,8 @@ git -C "<ws_root>" worktree list
 
 目标 worktree 应已不在列表中。
 
+**工作区回根交接（必须执行）**：若用户的开发会话工作在 worktree 内（桌面端切根工作流，当前窗口的工作区根 = 已删除的 `<wt_path>`），此刻目录树已悬空——必须提示用户把工作区切回 `<ws_root>`（打开文件夹 / Open Folder / 切换工作目录），并在最终报告中给出该绝对路径。
+
 ---
 
 ## 最终报告
@@ -402,6 +404,7 @@ git -C "<ws_root>" worktree list
     （无未归档 change 时不显示本节）
   分支处理：feature-xxx 已保留（默认行为；如需删除分支，手动调用 scripts/delete-branches.js）
   剩余工作空间 worktree：<列出仍存在的，或 "无" >
+  👉 若你的窗口目录树仍停在已删除的 worktree，请切回工作空间根：<ws_root 绝对路径>
   Workspace cleaned up.
 ```
 
@@ -441,7 +444,7 @@ git -C "<ws_root>" worktree list
 - **合并判定依赖刷新后的远程引用，故 Step 2.0 先主动 `git fetch`**：feature 多由他人经 MR 合入远端，本地引用否则会陈旧误判
 - **并行块用临时文件收结果、不用共享变量**：原 bash 版本中 `&` 后台任务跑在独立子 shell；Node.js 同步执行无此问题
 - **`.gitignore` 无需清理**：创建时的 `.worktrees/` 条目提交在 feature 分支上，删分支时随分支消失（未合并）或无害保留（已合并）
-- **AI 配置只装在空间根（单层安装）**：worktree 内没有 AI 配置目录，关闭时无需处理
+- **AI 配置在 worktree 内是 junction（链接）**：物理副本只在空间根（单层安装），worktree 删除时链接随目录树消失，无需清理动作
 - **部分 `worktree remove` 失败**：已移除的无需回退，未移除的报告详情让用户处理后重跑
 - **Windows IDE 目录锁的三层降级**：`git worktree remove` 内部做两件事——①清元数据 ②删目录。Windows 文件锁只阻塞 ②，不阻塞 ①
 

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

@@ -320,7 +320,10 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 
 不执行脚本。AI agent 向用户输出最终报告（格式见「最终报告」），并完成以下交接声明：
 
-1. **开发会话开进 worktree**：新开 IDE 窗口 / agent 会话于 `<wt_path>`（AI 配置已 junction 就位，`/opsx:*` 等命令与技能在该会话可用）；本（根）会话保留作控制面——后续创建/关闭 worktree、`cbb update` 等空间级操作在此执行
+1. **开发会话开进 worktree**（按工具形态，二选一）：
+   - **桌面端（单窗口工作流）**：将当前窗口的工作区根切到 `<wt_path>`（打开文件夹 / Open Folder / 切换工作目录）——**无需新窗口**，聊天上下文保留；AI 配置已 junction 就位（`/opsx:*` 等命令照常可用），`.codespace/<app>/...` 相对路径原样生效
+   - **CLI / TUI agent**：新开会话于 `<wt_path>`；根会话保留作控制面——后续创建/关闭 worktree、`cbb update` 等空间级操作在此执行
+   - 无论哪种形态，**必须向用户报出空间根绝对路径 `<ws_root>`**（控制面地址：close 关闭 worktree 后回切用）
 2. **目录纪律（worktree 会话内自然成立）**：会话 cwd == 开发目录，上游相对路径原样生效；**分支感知 hook 已覆盖全部仓库**——任何落 main 的载荷提交会被拦截（大声失败是防线，不是故障）
 3. 不自动安装依赖：各仓库技术栈不一（Maven 依赖本机 `~/.m2` 全局共享、无需初始化；Node/Python 等由你进入 worktree 后执行正确的命令，如 `npm ci` / `pnpm`）
 4. **输出下一步建议**：最终报告必须包含「下一步建议」段（格式见「最终报告」），告知用户后续可走的流程；仅提示，不自动串联执行任何后续技能
@@ -335,7 +338,8 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 ✅ worktree 已创建：<wt_path>
    关联应用：<应用名 → .codespace/<应用名> 路径> 列表（应用子集或全量）
 🔗 AI 配置已 junction 就位：rules / skills / commands（cbb update 一处生效）
-📌 开发会话请开在 <wt_path>（新开 IDE 窗口 / agent 会话）；本根会话保留作控制面
+📌 开发会话开进 <wt_path>（桌面端：当前窗口切换工作区根即可，无需新窗口；CLI 端：新开会话）
+   空间根路径（控制面，close 后回切）：<ws_root>
 👉 下一步建议：
    1. 开始需求开发（开发会话内，二选一）：
       - 走 OpenSpec 工作流：/opsx:propose → /opsx:apply → /opsx:verify → /opsx:archive
@@ -428,7 +432,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 ### 完成后开发会话未开进 worktree
 
 - **问题：** 流程结束后开发会话仍停留在工作空间根目录（junction 好的 AI 配置没人加载），agent 在根会话里靠路径翻译干活，回到第一代失败模式
-- **修复：** Step 4 交接必须明确"开发会话开在 `<wt_path>`"（新 IDE 窗口 / agent 会话）；根会话保留作控制面（worktree 生灭、`cbb update`）
+- **修复：** Step 4 交接必须明确"开发会话开在 `<wt_path>`"（桌面端 = 当前窗口切工作区根；CLI = 新开会话）；根会话保留作控制面（worktree 生灭、`cbb update`）
 
 ### 用 `git checkout -b` 在创建 worktree 前切分支
 
@@ -469,7 +473,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>`、根会话保留作控制面"
+- Step 4 交接必须声明"开发会话开在 `<wt_path>`（桌面端 = 当前窗口切工作区根，CLI = 新开会话）、空间根路径在案作控制面"
 
 ---
 

package/package.json

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