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

package/cbb/worktrees/skills/cbb-worktree-close/scripts/find-workspace-root.js

@@ -5,8 +5,8 @@ require('./silence-popup');
  * 唯一真源：cbb/worktrees/_shared/scripts/find-workspace-root.js
  * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
  *
- * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 workspace-config.json 副本干扰）
- * 兜底：当前目录含 workspace-config.json
+ * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 CBB-WORKSPACE.json 副本干扰）
+ * 兜底：当前目录含 CBB-WORKSPACE.json
  *
  * 退出码：
  *   0 - 定位成功，输出 WS_ROOT 绝对路径
@@ -44,19 +44,19 @@ if (worktreeList.ok) {
   }
 }
 
-// 兜底：当前目录含 workspace-config.json
+// 兜底：当前目录含 CBB-WORKSPACE.json
 if (!wsRoot) {
   const cwd = process.cwd();
-  if (fs.existsSync(path.join(cwd, 'workspace-config.json'))) {
+  if (fs.existsSync(path.join(cwd, 'CBB-WORKSPACE.json'))) {
     wsRoot = cwd;
   }
 }
 
 // 校验
-if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'workspace-config.json'))) {
+if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'CBB-WORKSPACE.json'))) {
   console.error('❌ 未找到工作空间根目录');
-  console.error('   原因：git worktree list 失败且当前目录无 workspace-config.json');
-  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 workspace-config.json）下执行本技能');
+  console.error('   原因：git worktree list 失败且当前目录无 CBB-WORKSPACE.json');
+  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 CBB-WORKSPACE.json）下执行本技能');
   process.exit(1);
 }
 

package/cbb/worktrees/skills/cbb-worktree-close/scripts/remove-worktrees.js

@@ -83,14 +83,23 @@ function removeWt(repoPath, wtPath, name) {
 }
 
 // 1. 应用 worktrees
-const configPath = path.join(wsRoot, 'workspace-config.json');
+const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
 
 const apps = config.apps || [];
+/** 解析 app worktree 物理路径：新布局 .codespace/<app> 优先，兼容 ≤beta.23 旧平铺 <app> */
+function resolveAppWt(appName) {
+  const nested = path.join(wtDir, '.codespace', appName);
+  if (fs.existsSync(path.join(nested, '.git'))) return nested;
+  const legacy = path.join(wtDir, appName);
+  if (fs.existsSync(path.join(legacy, '.git'))) return legacy;
+  return nested;
+}
+
 console.log('=== 移除应用 Worktrees ===');
 for (const app of apps) {
-  const appWt = path.join(wtDir, app.name);
+  const appWt = resolveAppWt(app.name);
   const appPath = path.join(wsRoot, '.codespace', app.name);
   removeWt(appPath, appWt, app.name);
 }

package/cbb/worktrees/skills/cbb-worktree-close/scripts/safety-check.js

@@ -152,19 +152,28 @@ function checkRepo(name, repoPath, wtPath) {
   return { name, wt: wtPath, fetch_ok: fetchOk, dirty_files: dirtyFiles, merged, main, remote_exists: remoteExists, remote: remoteName, unpushed_count: unpushedCount };
 }
 
-const configPath = path.join(wsRoot, 'workspace-config.json');
+const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
 
 const apps = config.apps || [];
 const wtDir = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
 
+/** 解析 app worktree 物理路径：新布局 .codespace/<app> 优先，兼容 ≤beta.23 旧平铺 <app> */
+function resolveAppWt(appName) {
+  const nested = path.join(wtDir, '.codespace', appName);
+  if (fs.existsSync(path.join(nested, '.git'))) return nested;
+  const legacy = path.join(wtDir, appName);
+  if (fs.existsSync(path.join(legacy, '.git'))) return legacy;
+  return nested;
+}
+
 const results = [];
 
 results.push(checkRepo('workspace', wsRoot, wtDir));
 
 for (const app of apps) {
-  const appWt = path.join(wtDir, app.name);
+  const appWt = resolveAppWt(app.name);
   const appPath = path.join(wsRoot, '.codespace', app.name);
   results.push(checkRepo(app.name, appPath, appWt));
 }

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

@@ -12,13 +12,13 @@ description: "为一个需求在 workspace 与各关联应用仓库同步创建
 ## 核心原则
 
 - 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**（Windows PowerShell / macOS bash / Linux bash / Git Bash 均无需适配）
-- 物理位置与 `init-worktree` 兼容：`.worktrees/worktree-<需求名>/<应用名>/`
+- 物理位置（ADR 0003）：workspace worktree 在 `.worktrees/worktree-<需求名>/`，各 app worktree 收拢在其 `.codespace/<应用名>/` 容器内——**镜像空间根布局**（应用检出恒在 `.codespace/<app>/`，相对路径两模式通用）
 - 所有仓库使用统一的分支名（不加前缀）；worktree 目录名自动加 `worktree-` 前缀；**分支基线统一取 `origin/<main>`（ADR 0002，不取 HEAD）**
 - **lazy push（ADR 0002）**：本技能**不向远端推送任何分支**——远端副作用收敛到 `cbb-worktree-push` 唯一出口；推送失败早暴露的职责由 push 技能的 dry-run 承担
 - **AI 配置 junction（ADR 0002 防线 B）**：创建 worktree 后把根的 AI 配置**内容子目录**（rules / skills / commands）junction 进工作树——开发会话开在 `<wt_path>`（上游 `/opsx:*` 相对路径原样生效，零翻译）；工具状态落在工作树自建空壳目录，不互相污染；`cbb update` 在根跑一次全 worktree 生效
-- **本技能必须在业务工作空间根目录执行**（即由 `cbb setup` 初始化、包含 `workspace-config.json` 的目录）
+- **本技能必须在业务工作空间根目录执行**（即由 `cbb setup` 初始化、包含 `CBB-WORKSPACE.json` 的目录）
 - 输入约定：**自由文本**（需求名等）直接在对话中提问并等待回复，禁止使用 `AskUserQuestion`；`AskUserQuestion` 仅用于固定选项决策场景（如 push 失败处理、远程分支已存在时的二选一）
-- 关联应用默认为 `workspace-config.json` 的**全量 apps**；支持按需求语境传入**应用子集**（见 Step 1），需要增减应用时编辑该文件并重跑本技能（幂等）
+- 关联应用默认为 `CBB-WORKSPACE.json` 的**全量 apps**；支持按需求语境传入**应用子集**（见 Step 1），需要增减应用时编辑该文件并重跑本技能（幂等）
 - **模式选择（ADR 0002）**：接到需求先判断用户要哪种模式——要**并行 / 隔离** → 本技能；**单线程快改、当前会话就地干** → 引导 `cbb-local-mode`。用户明确指定即遵从，agent 只给推荐不代决
 
 ---
@@ -34,7 +34,7 @@ node "<skill_dir>/scripts/<name>.js" <参数>
 ```
 
 > - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
-> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `workspace-config.json` 与 git 仓库
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `CBB-WORKSPACE.json` 与 git 仓库
 > - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
 
 脚本输出：
@@ -47,7 +47,7 @@ node "<skill_dir>/scripts/<name>.js" <参数>
 - `<branch>`：需求名字符串
 - `<wt_path>`：worktree 绝对路径
 
-所有脚本读 workspace-config.json：app 列表从 `<ws_root>/workspace-config.json` 读取，不需要传 JSON 参数。
+所有脚本读 CBB-WORKSPACE.json：app 列表从 `<ws_root>/CBB-WORKSPACE.json` 读取，不需要传 JSON 参数。
 
 ---
 
@@ -80,7 +80,7 @@ node "<skill_dir>/scripts/check-env-deep.js"
 - Node.js >= 16.7.0
 - `.worktrees/` 目录可写
 
-### 0.2 读取并校验 workspace-config.json
+### 0.2 读取并校验 CBB-WORKSPACE.json
 
 ```bash
 node "<skill_dir>/scripts/parse-config.js"
@@ -93,23 +93,23 @@ node "<skill_dir>/scripts/parse-config.js"
 
 ### 0.3 配置引导
 
-当 `workspace-config.json` 缺失、`apps` 为空或格式错误时，向用户说明情况并给出两个选项：
+当 `CBB-WORKSPACE.json` 缺失、`apps` 为空或格式错误时，向用户说明情况并给出两个选项：
 
 ```
-⚠️ 当前工作空间尚未配置关联应用（workspace-config.json 缺失或 apps 为空）。
+⚠️ 当前工作空间尚未配置关联应用（CBB-WORKSPACE.json 缺失或 apps 为空）。
 worktree 需要知道要关联哪些应用仓库。
 
 请选择：
-  [1] 我自行配置 workspace-config.json，配好后告诉你继续
-  [2] 提供应用仓库地址，我帮你写入 workspace-config.json
+  [1] 我自行配置 CBB-WORKSPACE.json，配好后告诉你继续
+  [2] 提供应用仓库地址，我帮你写入 CBB-WORKSPACE.json
 ```
 
 **选项 1：用户自行配置**
 - 停止当前技能流程
-- 提示用户：*"请编辑 workspace-config.json 后回复'继续'，或重新执行 init-worktree。"*
+- 提示用户：*"请编辑 CBB-WORKSPACE.json 后回复'继续'，或重新执行 init-worktree。"*
 - 用户回复"继续"后，重新从 Step 0 开始校验
 
-**选项 2：帮用户写入 workspace-config.json**
+**选项 2：帮用户写入 CBB-WORKSPACE.json**
 - 直接在对话中请用户提供应用信息，格式示例：
   ```
   应用名: ep-user-auth-app
@@ -120,7 +120,7 @@ worktree 需要知道要关联哪些应用仓库。
   仓库地址: git@code.example.com:team/ep-user-info-server.git
   类型: back（可选值：front 前端 / back 后端 / mixed 前后端混合）
   ```
-- 解析后写入 `workspace-config.json`：
+- 解析后写入 `CBB-WORKSPACE.json`：
   ```json
   {
     "apps": [
@@ -131,20 +131,20 @@ worktree 需要知道要关联哪些应用仓库。
   ```
 - 写入成功后提交到当前分支（确保 Step 2 状态检查通过）：
   ```bash
-  git add workspace-config.json
-  git commit -m "chore: add workspace-config.json"
+  git add CBB-WORKSPACE.json
+  git commit -m "chore: add CBB-WORKSPACE.json"
   ```
   > 若当前不在主分支上，提示用户切回主分支后再提交；若已在主分支上则直接提交。
 - 提交后重新从 Step 0 校验，通过后继续 Step 1
 
-> ⚠️ **禁止**：在 workspace-config.json 无效时跳过本步骤直接创建 worktree，否则无法确定关联应用。
+> ⚠️ **禁止**：在 CBB-WORKSPACE.json 无效时跳过本步骤直接创建 worktree，否则无法确定关联应用。
 
 ---
 
 ## Step 1：关联应用与代码同步
 
 > ⓘ **关联应用 = 需求涉及的应用子集**：从需求语境提取（"改订单导出" → 订单相关应用）；纯 workspace 内容的需求 → 仅 workspace。子集判断错了零代价——重跑本技能幂等补齐（已存在的分支/worktree 自动复用，详见「幂等重跑」章节）。涉及全部应用 / 不确定时用全量。
-> 需要增减应用时，编辑 `workspace-config.json` 后**重跑本技能**即可。
+> 需要增减应用时，编辑 `CBB-WORKSPACE.json` 后**重跑本技能**即可。
 
 ### 1.1 同步 `.codespace/` 目录代码
 
@@ -154,7 +154,7 @@ node "<skill_dir>/scripts/sync-repos.js" "<ws_root>"
 ```
 
 **用法**：
-- `<ws_root>`：工作空间根绝对路径（apps 由脚本内部从 `<ws_root>/workspace-config.json` 读取，全量 fetch/clone）
+- `<ws_root>`：工作空间根绝对路径（apps 由脚本内部从 `<ws_root>/CBB-WORKSPACE.json` 读取，全量 fetch/clone）
 
 **解读输出**：
 - 退出码 0 + 末行 `SYNC_RESULT [...]` → 全部成功
@@ -280,7 +280,7 @@ node "<skill_dir>/scripts/create-worktrees.js" "<ws_root>" "<branch>" [--apps "a
 脚本内部自动完成：
 1. **元数据自愈**：仅 `git worktree prune`（清理"目录已缺失/失效"的注册项）；**绝不删除任何物理目录**（0.0.3-beta.11 起——旧版"清理无元数据残留目录"因 Windows 路径分隔符不匹配会误删活跃 worktree，已整体移除）
 2. **workspace worktree 创建**：`git worktree add .worktrees/worktree-<branch> <branch>`
-3. **app worktree 创建**（物理嵌套在 workspace worktree 内）
+3. **app worktree 创建**（收拢在 workspace worktree 的 `.codespace/` 容器内，镜像空间根布局）；≤beta.23 旧平铺布局自动 `git worktree move` 迁移
 
 **解读输出**：
 - 退出码 0 + 末行 `WT_PATH <绝对路径>` → 全部成功，AI 解析出 worktree 绝对路径供后续 Step 4 使用
@@ -333,7 +333,7 @@ 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 会话）；本根会话保留作控制面
 👉 下一步建议：
@@ -354,7 +354,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 
 | 场景 | 重跑行为 |
 |------|----------|
-| 空间新增了应用（编辑 `workspace-config.json` 后） | Step 1 拉取新应用代码 → Step 3.3 为新应用建分支 → Step 3.5 创建缺失的嵌套 worktree → Step 3.6 补 junction |
+| 空间新增了应用（编辑 `CBB-WORKSPACE.json` 后） | Step 1 拉取新应用代码 → Step 3.3 为新应用建分支 → Step 3.5 在 `.codespace/` 容器内创建缺失的 app worktree → Step 3.6 补 junction |
 | 上次 init 中途失败 | 已存在的分支 / worktree 自动复用，`.gitignore` 处理自动跳过，仅补齐缺失部分 |
 | 应用从 config 移除 | 已创建的分支 / worktree **不会**自动删除；如需清理用 `cbb-worktree-close` skill 关闭后重建 |
 | **本地模式升级 worktree**（ADR 0002） | Step 3.3 分支已存在 → reused（本地阶段提交随身带走）；先 `git checkout main` 腾出各仓库本地检出，再重跑本技能 |
@@ -385,10 +385,10 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 
 ## 常见错误
 
-### 跳过 workspace-config.json 直接硬编码仓库地址
+### 跳过 CBB-WORKSPACE.json 直接硬编码仓库地址
 
 - **问题：** 直接在代码中写死仓库 URL 或本地路径，不同团队的仓库地址不同
-- **修复：** 始终从 `workspace-config.json` 读取应用与远程仓库的映射；配置缺失/为空时按 Step 0.3 配置引导处理，不支持在流程中临时指定配置外的仓库
+- **修复：** 始终从 `CBB-WORKSPACE.json` 读取应用与远程仓库的映射；配置缺失/为空时按 Step 0.3 配置引导处理，不支持在流程中临时指定配置外的仓库
 
 ### 状态检查对 app 仓库执行完整五项检查
 
@@ -468,7 +468,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 - 所有仓库分支统一从 `origin/<main>` 创建（`git branch <需求名> ${REMOTE}/${MAIN}`），不依赖本地检出状态（本地模式进行中重跑不受污染）
 - 严格 Step 3.3 → Step 3.5 顺序（先统一创建分支，再统一创建 worktree；workspace 工作树先建，各应用按序补建）
 - Step 3.6 junction AI 配置（失败不阻塞，但要报告）
-- 所有脚本调用以 `node "<skill_dir>/scripts/<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 缺省由脚本内部从 workspace-config.json 读取，子集用 `--apps` 传入）；**执行时 cwd 保持在工作空间根**（`check-env.js` / `parse-config.js` 按 cwd 定位）
+- 所有脚本调用以 `node "<skill_dir>/scripts/<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 缺省由脚本内部从 CBB-WORKSPACE.json 读取，子集用 `--apps` 传入）；**执行时 cwd 保持在工作空间根**（`check-env.js` / `parse-config.js` 按 cwd 定位）
 - Step 4 交接必须声明"开发会话开在 `<wt_path>`、根会话保留作控制面"
 
 ---
@@ -478,7 +478,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 | 脚本 | 功能 | 参数 | 退出码 |
 |------|------|------|--------|
 | `check-env.js` | 环境探活 | 无 | 0/1/2 |
-| `parse-config.js` | 解析 workspace-config.json | 无 | 0/1/2 |
+| `parse-config.js` | 解析 CBB-WORKSPACE.json | 无 | 0/1/2 |
 | `sync-repos.js` | 同步 .codespace/ 仓库（兜底 clone 时补装提交防线 hook） | ws_root | 0/1/2 |
 | `check-repos.js` | 状态检查 | ws_root | 0/1/2 |
 | `update-gitignore.js` | 安全更新 .gitignore | ws_root, branch | 0/1/2 |

package/cbb/worktrees/skills/cbb-worktree-init/scripts/check-env.js

@@ -48,7 +48,7 @@ console.log('✅ git OK:', checks.git.out);
 const insideRepo = tryExec('git rev-parse --is-inside-work-tree');
 if (!insideRepo.ok || insideRepo.out !== 'true') {
   console.error('❌ 当前目录不是 Git 仓库');
-  console.error('   init-worktree 必须在工作空间根目录（包含 workspace-config.json）下执行');
+  console.error('   init-worktree 必须在工作空间根目录（包含 CBB-WORKSPACE.json）下执行');
   process.exit(2);
 }
 console.log('✅ 当前目录是 git 仓库');

package/cbb/worktrees/skills/cbb-worktree-init/scripts/check-repos.js

@@ -36,7 +36,7 @@ if (!wsRoot) {
 }
 
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, "workspace-config.json");
+  const configPath = path.join(wsRoot, "CBB-WORKSPACE.json");
   if (!fs.existsSync(configPath)) return null;
   try {
     const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
@@ -46,7 +46,7 @@ function loadAppsFromConfig() {
 
 const apps = loadAppsFromConfig();
 if (!apps) {
-  console.error("workspace-config.json missing or apps empty");
+  console.error("CBB-WORKSPACE.json missing or apps empty");
   process.exit(1);
 }
 

package/cbb/worktrees/skills/cbb-worktree-init/scripts/create-branches.js

@@ -25,7 +25,7 @@ if (appsFlagIdx >= 0) {
 }
 
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) return null;
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
@@ -35,7 +35,7 @@ function loadAppsFromConfig() {
 
 const allApps = loadAppsFromConfig();
 if (!allApps) {
-  console.error('workspace-config.json missing or apps empty');
+  console.error('CBB-WORKSPACE.json missing or apps empty');
   process.exit(1);
 }
 
@@ -46,7 +46,7 @@ const apps = appFilter
 if (appFilter) {
   const unknown = [...appFilter].filter(n => !allApps.some(a => a.name === n));
   if (unknown.length > 0) {
-    console.error('❌ --apps 中的应用不在 workspace-config.json：' + unknown.join(', '));
+    console.error('❌ --apps 中的应用不在 CBB-WORKSPACE.json：' + unknown.join(', '));
     process.exit(1);
   }
   console.log('ℹ️  应用子集（' + apps.length + '/' + allApps.length + '）：' + apps.map(a => a.name).join(', '));

package/cbb/worktrees/skills/cbb-worktree-init/scripts/create-worktrees.js

@@ -4,7 +4,7 @@ require('./silence-popup');
  * cbb-worktree-init 创建 Worktree（自愈清理仅限元数据 prune）
  *
  * 用法：node create-worktrees.js <ws_root> <branch>
- *   （apps 由脚本内部从 <ws_root>/workspace-config.json 读取）
+ *   （apps 由脚本内部从 <ws_root>/CBB-WORKSPACE.json 读取）
  *
  * 行为：
  *   1. 自愈清理：仅 git worktree prune（元数据），**绝不删除任何物理目录**
@@ -41,7 +41,7 @@ if (appsFlagIdx >= 0) {
 }
 
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) return null;
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
@@ -51,7 +51,7 @@ function loadAppsFromConfig() {
 
 const allApps = loadAppsFromConfig();
 if (!allApps) {
-  console.error('❌ workspace-config.json 缺失或 apps 为空');
+  console.error('❌ CBB-WORKSPACE.json 缺失或 apps 为空');
   process.exit(1);
 }
 
@@ -62,7 +62,7 @@ const apps = appFilter
 if (appFilter) {
   const unknown = [...appFilter].filter(n => !allApps.some(a => a.name === n));
   if (unknown.length > 0) {
-    console.error('❌ --apps 中的应用不在 workspace-config.json：' + unknown.join(', '));
+    console.error('❌ --apps 中的应用不在 CBB-WORKSPACE.json：' + unknown.join(', '));
     process.exit(1);
   }
   console.log('ℹ️  应用子集（' + apps.length + '/' + allApps.length + '）：' + apps.map(a => a.name).join(', '));
@@ -109,12 +109,13 @@ if (fs.existsSync(wtDir)) {
   console.log('✅ workspace worktree 已创建：' + wtDir);
 }
 
-// 3. apps worktree 创建（物理嵌套）
+// 3. apps worktree 创建（物理嵌套于 workspace worktree 的 .codespace/ 容器内，镜像主布局，ADR 0003）
 console.log('=== 创建 App Worktrees ===');
 const results = [];
 for (const app of apps) {
   const appPath = path.join(wsRoot, '.codespace', app.name);
-  const nestedWt = path.join(wtDir, app.name);
+  const nestedWt = path.join(wtDir, '.codespace', app.name);
+  const legacyWt = path.join(wtDir, app.name);
 
   if (fs.existsSync(nestedWt) && fs.existsSync(path.join(nestedWt, '.git'))) {
     console.log('⏭️  ' + app.name + ': 嵌套 worktree 已存在，复用');
@@ -122,8 +123,23 @@ for (const app of apps) {
     continue;
   }
 
-  // 防御性兜底：父目录不存在则创建
+  // 防御性兜底：容器目录不存在则创建
   fs.mkdirSync(path.dirname(nestedWt), { recursive: true });
+
+  // 存量迁移：≤beta.23 旧平铺布局 → .codespace/ 容器（worktree 平移，分支与提交随身带走）
+  if (fs.existsSync(legacyWt) && fs.existsSync(path.join(legacyWt, '.git'))) {
+    const moved = run('git worktree move "' + legacyWt + '" "' + nestedWt + '"', appPath);
+    if (moved.ok) {
+      console.log('🔁 ' + app.name + ': 旧平铺 worktree 已迁移到 .codespace/ 容器');
+      results.push({ name: app.name, status: 'migrated' });
+      continue;
+    }
+    console.error('❌ ' + app.name + ': 旧平铺 worktree 迁移失败（常见原因：目录被 IDE 等进程占用）：' + moved.err);
+    console.error('   请关闭占用 ' + legacyWt + ' 的程序后重跑本技能；或先执行 cbb-worktree-close 再重建');
+    results.push({ name: app.name, status: 'failed', error: moved.err });
+    continue;
+  }
+
   const created = run('git worktree add "' + nestedWt + '" "' + branch + '"', appPath);
   if (created.ok) {
     console.log('✅ ' + app.name + ': 嵌套 worktree 创建成功');

package/cbb/worktrees/skills/cbb-worktree-init/scripts/find-workspace-root.js

@@ -5,8 +5,8 @@ require('./silence-popup');
  * 唯一真源：cbb/worktrees/_shared/scripts/find-workspace-root.js
  * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
  *
- * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 workspace-config.json 副本干扰）
- * 兜底：当前目录含 workspace-config.json
+ * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 CBB-WORKSPACE.json 副本干扰）
+ * 兜底：当前目录含 CBB-WORKSPACE.json
  *
  * 退出码：
  *   0 - 定位成功，输出 WS_ROOT 绝对路径
@@ -44,19 +44,19 @@ if (worktreeList.ok) {
   }
 }
 
-// 兜底：当前目录含 workspace-config.json
+// 兜底：当前目录含 CBB-WORKSPACE.json
 if (!wsRoot) {
   const cwd = process.cwd();
-  if (fs.existsSync(path.join(cwd, 'workspace-config.json'))) {
+  if (fs.existsSync(path.join(cwd, 'CBB-WORKSPACE.json'))) {
     wsRoot = cwd;
   }
 }
 
 // 校验
-if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'workspace-config.json'))) {
+if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'CBB-WORKSPACE.json'))) {
   console.error('❌ 未找到工作空间根目录');
-  console.error('   原因：git worktree list 失败且当前目录无 workspace-config.json');
-  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 workspace-config.json）下执行本技能');
+  console.error('   原因：git worktree list 失败且当前目录无 CBB-WORKSPACE.json');
+  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 CBB-WORKSPACE.json）下执行本技能');
   process.exit(1);
 }
 

package/cbb/worktrees/skills/cbb-worktree-init/scripts/install-git-hook.js

@@ -20,7 +20,7 @@ const HOOK_FILE = 'pre-commit';
 const BACKUP_SUFFIX = '.cbb-backup';
 
 // 与 cbb/lib/utils/githook.js 的 buildPreCommitSource() 输出完全一致（构建时注入）
-const PRE_COMMIT_SOURCE = "#!/usr/bin/env node\n// managed-by-cbb v1 —— 分支感知提交防线（ADR 0002）\n// main 上：workspace 仓库只放行控制面白名单，应用仓库全拦；非 main 一律放行。\n// 绕过逃生口仅限用户显式 git commit --no-verify。\nconst { execSync } = require('child_process');\nconst fs = require('fs');\nfunction run(cmd) {\n  try { return execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim(); }\n  catch (e) { return null; }\n}\nconst branch = run('git branch --show-current') || '';\n// 主干名：优先远端 HEAD 指向；探测失败按本地 main/master 存在性回退\nlet main = null;\nconst remotes = run('git remote');\nif (remotes) {\n  const r = remotes.split(/\\r?\\n/)[0];\n  const sym = run('git symbolic-ref \"refs/remotes/' + r + '/HEAD\"');\n  if (sym) main = sym.replace('refs/remotes/' + r + '/', '');\n}\nif (!main) {\n  if (run('git rev-parse --verify --quiet refs/heads/main')) main = 'main';\n  else if (run('git rev-parse --verify --quiet refs/heads/master')) main = 'master';\n}\n// 非主干（含 detached / 探测失败）→ 放行\nif (!main || branch !== main) process.exit(0);\n\n// 主干上的提交：收集 staged 变更（空提交放行）\nconst staged = run('git diff --cached --name-only') || '';\nconst files = staged.split(/\\r?\\n/).filter(Boolean);\nif (files.length === 0) process.exit(0);\n\n// 仓库类型：workspace 仓库 = 检出含 workspace-config.json\nconst isWorkspace = fs.existsSync('workspace-config.json');\n\nfunction deny(bad) {\n  console.error('[cbb-guard] 主干上拦截载荷提交（ADR 0002）：');\n  bad.forEach(f => console.error('  ' + f));\n  console.error('需求载荷须在需求分支上提交：本地模式先 git checkout -b <需求名>；worktree 模式在 .worktrees/ 工作树内提交。');\n  console.error('控制面白名单：workspace-config.json / .gitignore / AGENTS.md / openspec/config.yaml / openspec/schemas/** / .cbb/**');\n  console.error('如确需在主干提交，须由用户显式 git commit --no-verify。');\n  process.exit(1);\n}\n\nif (isWorkspace) {\n  const EXACT = new Set(['workspace-config.json', '.gitignore', 'AGENTS.md', 'openspec/config.yaml']);\n  const PREFIXES = ['openspec/schemas/', '.cbb/'];\n  const bad = files.filter(f => !EXACT.has(f) && !PREFIXES.some(p => f.indexOf(p) === 0));\n  if (bad.length) deny(bad);\n} else {\n  deny(files);\n}\nprocess.exit(0);\n";
+const PRE_COMMIT_SOURCE = "#!/usr/bin/env node\n// managed-by-cbb v1 —— 分支感知提交防线（ADR 0002）\n// main 上：workspace 仓库只放行控制面白名单，应用仓库全拦；非 main 一律放行。\n// 绕过逃生口仅限用户显式 git commit --no-verify。\nconst { execSync } = require('child_process');\nconst fs = require('fs');\nfunction run(cmd) {\n  try { return execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim(); }\n  catch (e) { return null; }\n}\nconst branch = run('git branch --show-current') || '';\n// 主干名：优先远端 HEAD 指向；探测失败按本地 main/master 存在性回退\nlet main = null;\nconst remotes = run('git remote');\nif (remotes) {\n  const r = remotes.split(/\\r?\\n/)[0];\n  const sym = run('git symbolic-ref \"refs/remotes/' + r + '/HEAD\"');\n  if (sym) main = sym.replace('refs/remotes/' + r + '/', '');\n}\nif (!main) {\n  if (run('git rev-parse --verify --quiet refs/heads/main')) main = 'main';\n  else if (run('git rev-parse --verify --quiet refs/heads/master')) main = 'master';\n}\n// 非主干（含 detached / 探测失败）→ 放行\nif (!main || branch !== main) process.exit(0);\n\n// 主干上的提交：收集 staged 变更（空提交放行）\nconst staged = run('git diff --cached --name-only') || '';\nconst files = staged.split(/\\r?\\n/).filter(Boolean);\nif (files.length === 0) process.exit(0);\n\n// 仓库类型：workspace 仓库 = 检出含 CBB-WORKSPACE.json（或旧名，改名过渡期识别）\nconst isWorkspace = fs.existsSync('CBB-WORKSPACE.json') || fs.existsSync('workspace-config.json');\n\nfunction deny(bad) {\n  console.error('[cbb-guard] 主干上拦截载荷提交（ADR 0002）：');\n  bad.forEach(f => console.error('  ' + f));\n  console.error('需求载荷须在需求分支上提交：本地模式先 git checkout -b <需求名>；worktree 模式在 .worktrees/ 工作树内提交。');\n  console.error('控制面白名单：CBB-WORKSPACE.json / .gitignore / AGENTS.md / openspec/config.yaml / openspec/schemas/** / .cbb/**');\n  console.error('如确需在主干提交，须由用户显式 git commit --no-verify。');\n  process.exit(1);\n}\n\nif (isWorkspace) {\n  // 旧名仅放行删除条目：更名迁移提交（git mv）会产生旧名删除 + 新名新增两条\n  const EXACT = new Set(['CBB-WORKSPACE.json', 'workspace-config.json', '.gitignore', 'AGENTS.md', 'openspec/config.yaml']);\n  const PREFIXES = ['openspec/schemas/', '.cbb/'];\n  const bad = files.filter(f => !EXACT.has(f) && !PREFIXES.some(p => f.indexOf(p) === 0));\n  if (bad.length) deny(bad);\n} else {\n  deny(files);\n}\nprocess.exit(0);\n";
 
 function isCbbHookContent(content) {
   return typeof content === 'string' && content.includes(HOOK_MARKER);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/parse-config.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * cbb-worktree-init 读取并校验 workspace-config.json
+ * cbb-worktree-init 读取并校验 CBB-WORKSPACE.json
  *
  * 退出码：
  *   0 - 成功，输出应用列表 JSON
@@ -15,10 +15,10 @@ require('./silence-popup');
 const fs = require('fs');
 const path = require('path');
 
-const configPath = path.join(process.cwd(), 'workspace-config.json');
+const configPath = path.join(process.cwd(), 'CBB-WORKSPACE.json');
 
 if (!fs.existsSync(configPath)) {
-  console.error('❌ workspace-config.json 不存在');
+  console.error('❌ CBB-WORKSPACE.json 不存在');
   console.error('   请先在 cbb setup 阶段创建，或手动配置');
   console.error('---');
   console.error('CONFIG_MISSING');
@@ -29,7 +29,7 @@ let config;
 try {
   config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
 } catch (e) {
-  console.error('❌ workspace-config.json 解析失败：', e.message);
+  console.error('❌ CBB-WORKSPACE.json 解析失败：', e.message);
   console.error('   请检查 JSON 格式');
   console.error('---');
   console.error('CONFIG_INVALID');
@@ -38,8 +38,8 @@ try {
 
 const apps = config.apps || [];
 if (apps.length === 0) {
-  console.error('❌ workspace-config.json 中 apps 为空');
-  console.error('   请编辑 workspace-config.json 配置关联应用');
+  console.error('❌ CBB-WORKSPACE.json 中 apps 为空');
+  console.error('   请编辑 CBB-WORKSPACE.json 配置关联应用');
   console.error('---');
   console.error('CONFIG_EMPTY');
   process.exit(2);
@@ -61,7 +61,7 @@ for (const app of apps) {
   }
 }
 
-console.log('✅ workspace-config.json 有效（' + apps.length + ' 个应用）');
+console.log('✅ CBB-WORKSPACE.json 有效（' + apps.length + ' 个应用）');
 console.log('---');
 console.log('CONFIG_OK', JSON.stringify(apps));
 process.exit(0);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/push-branches.js

@@ -20,7 +20,7 @@ const fs = require('fs');
 const path = require('path');
 
 function loadAppsFromConfig(wsRoot) {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) return null;
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
@@ -40,7 +40,7 @@ function executePush(opts) {
   const branch = opts.branch;
   const apps = opts.apps != null ? opts.apps : loadAppsFromConfig(wsRoot);
   if (apps == null) {
-    throw new Error('workspace-config.json missing or apps empty');
+    throw new Error('CBB-WORKSPACE.json missing or apps empty');
   }
 
   const results = [];
@@ -68,7 +68,7 @@ function main() {
 
   const apps = loadAppsFromConfig(wsRoot);
   if (apps == null) {
-    console.error('❌ workspace-config.json 缺失或 apps 为空');
+    console.error('❌ CBB-WORKSPACE.json 缺失或 apps 为空');
     process.exit(1);
   }
 

package/cbb/worktrees/skills/cbb-worktree-init/scripts/sync-repos.js

@@ -4,7 +4,7 @@ require('./silence-popup');
  * cbb-worktree-init 同步 .codespace/ 仓库
  *
  * 用法：node sync-repos.js <ws_root>
- *   - ws_root: 工作空间根绝对路径（apps 从 <ws_root>/workspace-config.json 读取）
+ *   - ws_root: 工作空间根绝对路径（apps 从 <ws_root>/CBB-WORKSPACE.json 读取）
  *
  * 对每个 app：
  *   - .codespace/<name>/.git 存在 → fetch --all
@@ -29,23 +29,23 @@ if (!wsRoot) {
 }
 
 /**
- * 从 workspace-config.json 读取 apps（避免 shell 字符串传递中的转义问题）
+ * 从 CBB-WORKSPACE.json 读取 apps（避免 shell 字符串传递中的转义问题）
  */
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) {
-    console.error('❌ workspace-config.json 不存在：' + configPath);
+    console.error('❌ CBB-WORKSPACE.json 不存在：' + configPath);
     return null;
   }
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
     if (!config.apps || !Array.isArray(config.apps) || config.apps.length === 0) {
-      console.error('❌ workspace-config.json 中 apps 为空');
+      console.error('❌ CBB-WORKSPACE.json 中 apps 为空');
       return null;
     }
     return config.apps;
   } catch (e) {
-    console.error('❌ workspace-config.json 解析失败：' + e.message);
+    console.error('❌ CBB-WORKSPACE.json 解析失败：' + e.message);
     return null;
   }
 }

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

@@ -36,7 +36,7 @@ node "<skill_dir>/scripts/<name>.js" <参数>
 ```
 
 > - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
-> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `workspace-config.json` 与 git 仓库
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `CBB-WORKSPACE.json` 与 git 仓库
 > - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
 
 脚本输出：
@@ -54,9 +54,9 @@ node "<skill_dir>/scripts/<name>.js" <参数>
 
 | 场景 | 判据 | 策略 |
 |------|------|------|
-| **A. cbb 工作空间根** | cwd（或其 git 顶层）含 `workspace-config.json`；`find-workspace-root.js` 退出码 0 | 走 **Step 1 → 6** 的跨 worktree 批量流程 |
+| **A. cbb 工作空间根** | cwd（或其 git 顶层）含 `CBB-WORKSPACE.json`；`find-workspace-root.js` 退出码 0 | 走 **Step 1 → 6** 的跨 worktree 批量流程 |
 | **B. worktree 内** | cwd 命中 `<ws_root>/.worktrees/worktree-<需求名>/` | 用 cwd 反推 `<需求名>`，走 **Step 1 → 6** 批量流程 |
-| **C. 普通 git 仓库** | 在 git 仓库内，但无 `workspace-config.json`（`find-workspace-root.js` 退出码 1） | **降级为单仓库提交推送**：不调 worktree 脚本，按常规 `git add -u` → 向用户询问 commit 信息 → `git commit` → `git push`（保留本 skill 的"必问 commit 信息"约束） |
+| **C. 普通 git 仓库** | 在 git 仓库内，但无 `CBB-WORKSPACE.json`（`find-workspace-root.js` 退出码 1） | **降级为单仓库提交推送**：不调 worktree 脚本，按常规 `git add -u` → 向用户询问 commit 信息 → `git commit` → `git push`（保留本 skill 的"必问 commit 信息"约束） |
 | **D. 非 git 目录** | `git rev-parse --is-inside-work-tree` 失败 | 说明"当前目录不是 git 仓库"，终止，不做任何操作 |
 
 **判场景与定位（A/B 场景）：**
@@ -80,7 +80,7 @@ node "<skill_dir>/scripts/find-workspace-root.js"
 5. `git push`（无 upstream 时先询问用户是否 `-u`）
 6. 汇报结果；**不要**提及 worktree 批量流程
 
-> 场景 C 是兜底：让"提交代码"在普通仓库里也能正常完成，而不是因找不到 `workspace-config.json` 报错。
+> 场景 C 是兜底：让"提交代码"在普通仓库里也能正常完成，而不是因找不到 `CBB-WORKSPACE.json` 报错。
 
 ---
 
@@ -123,7 +123,7 @@ AI agent 在执行真实 commit 前**必须**在对话中向用户确认 commit
 
 ```
 检测到以下 worktree 仓库有未提交改动：
-  - workspace: 5 个文件（workspace-config.json, openspec/changes/foo/...）
+  - workspace: 5 个文件（CBB-WORKSPACE.json, openspec/changes/foo/...）
   - ep-foo-app: 12 个文件
   - ep-bar-app: 3 个文件
 
@@ -284,7 +284,7 @@ node "<skill_dir>/scripts/make-mr-urls.js" "<ws_root>" "<branch>" "<target>" --o
 | **任何触发** | **先做 Step 0 场景识别**，再决定策略 |
 | 场景 A：cwd 在 cbb 工作空间根 | find-workspace-root 成功 → 多个 worktree 时让用户选 |
 | 场景 B：cwd 在 worktree 内 | 自动用 cwd 反推分支，扫描后进入询问 commit 信息 |
-| 场景 C：cwd 在普通 git 仓库（无 workspace-config.json） | **降级为单仓库提交推送**，不调用 worktree 脚本 |
+| 场景 C：cwd 在普通 git 仓库（无 CBB-WORKSPACE.json） | **降级为单仓库提交推送**，不调用 worktree 脚本 |
 | 场景 D：cwd 非 git 目录 | 说明情况并终止，不做任何操作 |
 | commit 信息缺失 | 必须询问用户；禁止自动生成（可基于 apply task 上下文给建议） |
 | 多仓库需不同 commit 信息 | 用 `--per-repo "ep-foo:m1;ep-bar:m2"`，必须由用户逐条提供 |
@@ -330,7 +330,7 @@ node "<skill_dir>/scripts/make-mr-urls.js" "<ws_root>" "<branch>" "<target>" --o
 
 ### 多仓库用同一条 commit 信息
 
-- **问题：** workspace 改了 workspace-config.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
+- **问题：** workspace 改了 CBB-WORKSPACE.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
 - **修复：** 用 `--per-repo` 模式，让用户逐仓库提供
 
 ### push 失败时跳过失败仓库直接继续