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

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

@@ -101,7 +101,7 @@ trigger: always_on
 
 ## 8. 业务空间开发模式（双模式，用户选择制）
 
-**仅当工作目录是业务空间根（存在 `workspace-config.json` 且 `.git` 为目录）时生效。空间支持两种开发模式，能力对称（都能修改 workspace 内容与应用代码、都强制分支隔离、交付都走 MR），由用户显式选择，agent 只给推荐不代决。**
+**仅当工作目录是业务空间根（存在 `CBB-WORKSPACE.json` 且 `.git` 为目录）时生效。空间支持两种开发模式，能力对称（都能修改 workspace 内容与应用代码、都强制分支隔离、交付都走 MR），由用户显式选择，agent 只给推荐不代决。**
 
 **模式一 · 本地模式（单线程快改，当前会话就地干）：**
 
@@ -117,7 +117,7 @@ trigger: always_on
 **基准与防线（两模式共同，ADR 0002）：**
 
 - **基准 = `origin/main`（唯一真相源）；`.codespace/<app>/` 的检出 = 视图**——本地模式可暂态被需求分支占用，收尾恢复
-- **严禁直接在任何 main 检出上提交载荷**：分支感知 pre-commit hook 机械拦截（workspace 仓库仅放行控制面白名单：`workspace-config.json` / `.gitignore` / `AGENTS.md` / `openspec/config.yaml` / `openspec/schemas/**`；应用仓库 main 全拦）——**被拦是防线生效，不是故障**；`--no-verify` 绕过仅限用户显式要求
+- **严禁直接在任何 main 检出上提交载荷**：分支感知 pre-commit hook 机械拦截（workspace 仓库仅放行控制面白名单：`CBB-WORKSPACE.json` / `.gitignore` / `AGENTS.md` / `openspec/config.yaml` / `openspec/schemas/**`；应用仓库 main 全拦）——**被拦是防线生效，不是故障**；`--no-verify` 绕过仅限用户显式要求
 - 远端推送唯一出口 = `cbb-worktree-push`（init 创建流程零远端操作，lazy push；空分支尸体不存在）
 - **模式误判零代价**：本地模式中途要并行/隔离 → 重跑 `cbb-worktree-init`（分支已存在自动复用，提交随身带走）
 

package/cbb/lib/install/init.js

@@ -152,13 +152,15 @@ function detectExistingInstall() {
 }
 
 /**
- * 判定目标目录是否为业务空间根：workspace-config.json 存在且 .git 是目录。
- * 需求工作树内也有 workspace-config.json（tracked 副本），但其 .git 是文件（gitdir 指针），
+ * 判定目标目录是否为业务空间根：CBB-WORKSPACE.json（或旧名 workspace-config.json）存在且 .git 是目录。
+ * 需求工作树内也有该文件（tracked 副本），但其 .git 是文件（gitdir 指针），
  * 必须以 .git 形态排除——避免「在 worktree 里误跑 cbb update」被当作空间根
  * （误装 worktree 管理入口、在错误位置报旧导航提示）。
+ * 双名识别用于改名过渡期：存量空间（旧名）跑 update 时仍能识别并装上新版 hook。
  */
 function detectWorkspaceRoot() {
-  if (!fs.existsSync(path.join(TARGET_DIR, 'workspace-config.json'))) return false;
+  if (!fs.existsSync(path.join(TARGET_DIR, 'CBB-WORKSPACE.json'))
+    && !fs.existsSync(path.join(TARGET_DIR, 'workspace-config.json'))) return false;
   const gitPath = path.join(TARGET_DIR, '.git');
   return fs.existsSync(gitPath) && fs.statSync(gitPath).isDirectory();
 }
@@ -1332,12 +1334,12 @@ function decideUpgradeIfInstalled(targetDir, selectedAdapters) {
 }
 
 /**
- * 检查业务空间根目录下是否有 workspace-config.json（init-worktree 技能依赖）。
- * 不存在时，将包内样例文件复制为 workspace-config.json。
+ * 检查业务空间根目录下是否有 CBB-WORKSPACE.json（init-worktree 技能依赖）。
+ * 不存在时，将包内样例文件复制为 CBB-WORKSPACE.json。
  * 返回 'exists' | 'created'（不打印，由调用方汇总输出）。
  */
 function ensureWorkspaceConfig(targetDir) {
-  const configPath = path.join(targetDir, 'workspace-config.json');
+  const configPath = path.join(targetDir, 'CBB-WORKSPACE.json');
   if (fs.existsSync(configPath)) return 'exists';
 
   const samplePath = path.join(SHARED_STANDARDS_DIR, workspaces.SAMPLE_CONFIG);
@@ -1346,12 +1348,12 @@ function ensureWorkspaceConfig(targetDir) {
 }
 
 /**
- * 读取 workspace-config.json 中的应用列表，将关联应用代码 clone/fetch 到 .codespace/ 目录。
+ * 读取 CBB-WORKSPACE.json 中的应用列表，将关联应用代码 clone/fetch 到 .codespace/ 目录。
  * 首次 clone（耗时较长），后续 fetch --all（秒级更新）。
  * 这是基准代码，init-worktree 技能后续只做轻量 fetch 检查。
  */
 /**
- * 读取 workspace-config.json，将关联应用代码 clone/fetch 到 .codespace/ 目录。
+ * 读取 CBB-WORKSPACE.json，将关联应用代码 clone/fetch 到 .codespace/ 目录。
  * 不打印逐条日志，返回汇总对象由调用方渲染：
  *   { ok, fail, updated[], cloned[], fetchFailed[], sampleApps[], invalid[] }
  * 长耗时（首次 clone），通过 onProgress 回调实时提示当前正在处理哪个应用。
@@ -1360,7 +1362,7 @@ function ensureWorkspaceConfig(targetDir) {
  */
 async function syncAppRepos(targetDir, onProgress = () => {}) {
   const summary = { ok: 0, fail: 0, updated: [], cloned: [], fetchFailed: [], sampleApps: [], invalid: [] };
-  const configPath = path.join(targetDir, 'workspace-config.json');
+  const configPath = path.join(targetDir, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) return summary;
 
   let config;
@@ -1514,7 +1516,7 @@ async function syncWorkspaceRepo(targetDir, onProgress = () => {}) {
 }
 
 /**
- * 处理单个业务空间：计算子目录 → 检测/克隆 → workspace-config.json → 拉取应用代码 → 升级询问 → 安装 AI 配置。
+ * 处理单个业务空间：计算子目录 → 检测/克隆 → CBB-WORKSPACE.json → 拉取应用代码 → 升级询问 → 安装 AI 配置。
  * 输出为紧凑步进行（✓ 标签 值），失败时不抛出也不退出，返回结果对象供调用方汇总。
  * @param {object} [opts] - { selectedAdapters } cbb setup 上层选定的适配器（透传给空间级安装）
  * @returns {Promise<{ok: boolean, error?: string, message?: string, subdir?: string, skipped?: boolean}>}
@@ -1576,28 +1578,28 @@ async function initSingleWorkspace(w, opts = {}) {
     step('✓', '仓库', `已克隆 ${subdirName}/`);
   }
 
-  // 3. workspace-config.json：缺失则从样例生成，随后校验格式
+  // 3. CBB-WORKSPACE.json：缺失则从样例生成，随后校验格式
   const cfgState = ensureWorkspaceConfig(targetDir);
-  const configPath = path.join(targetDir, 'workspace-config.json');
+  const configPath = path.join(targetDir, 'CBB-WORKSPACE.json');
   const configValidation = workspaces.validateWorkspaceConfig(configPath);
   if (!configValidation.valid) {
-    step('✗', '配置', `workspace-config.json 校验失败：${configValidation.message}`,
+    step('✗', '配置', `CBB-WORKSPACE.json 校验失败：${configValidation.message}`,
       { iconColor: 'red', labelColor: 'red', valueColor: 'red' });
-    // 撤销本次克隆，使工作空间回到初始状态，用户配好 workspace-config.json 后可重新执行
+    // 撤销本次克隆，使工作空间回到初始状态，用户配好 CBB-WORKSPACE.json 后可重新执行
     if (wasCloned && fs.existsSync(targetDir)) {
       removePath(targetDir);
-      log(`已撤销本次克隆（${subdirName}/），请配好 workspace-config.json 后重新执行 cbb setup`, 'warn');
+      log(`已撤销本次克隆（${subdirName}/），请配好 CBB-WORKSPACE.json 后重新执行 cbb setup`, 'warn');
     } else {
-      log('请修正 workspace-config.json 后重新执行 cbb setup', 'warn');
+      log('请修正 CBB-WORKSPACE.json 后重新执行 cbb setup', 'warn');
     }
     log(`参考格式：${path.join(SHARED_STANDARDS_DIR, workspaces.SAMPLE_CONFIG)}`, 'info');
     return { ok: false, error: 'CONFIG_INVALID', message: configValidation.message };
   }
   if (cfgState === 'created') {
-    step('!', '配置', 'workspace-config.json 已从样例生成，请编辑 apps 后重跑 cbb setup',
+    step('!', '配置', 'CBB-WORKSPACE.json 已从样例生成，请编辑 apps 后重跑 cbb setup',
       { iconColor: 'yellow', valueColor: 'yellow' });
   } else {
-    step('✓', '配置', `workspace-config.json（${configValidation.config.apps.length} 个应用）`);
+    step('✓', '配置', `CBB-WORKSPACE.json（${configValidation.config.apps.length} 个应用）`);
   }
 
   // 4. 拉取关联应用代码到 .codespace/（基准代码，首次 clone 较慢，实时提示当前应用）
@@ -1615,7 +1617,7 @@ async function initSingleWorkspace(w, opts = {}) {
   step(appWarn ? '!' : '✓', '应用', appParts.join(' · '), { iconColor: appWarn ? 'yellow' : 'green' });
   if (apps.sampleApps.length > 0) {
     const names = apps.sampleApps.map(a => a.name).join('、');
-    console.log(`      ${c('gray', `${names} → 编辑 workspace-config.json 填入真实仓库地址`)}`);
+    console.log(`      ${c('gray', `${names} → 编辑 CBB-WORKSPACE.json 填入真实仓库地址`)}`);
   }
 
   // 5. 若已安装：版本一致且无新增工具才跳过；否则继续安装/升级（setup 已整体确认过，不再二次询问）
@@ -1641,7 +1643,7 @@ function describeBatchError(r) {
     case 'DIR_MISMATCH':    return '子目录已存在但不是该业务空间的仓库';
     case 'CLONE_FAILED':    return `git clone 失败：${r.message || ''}`.trim();
     case 'PULL_FAILED':     return `工作空间仓库同步失败：${r.message || ''}`.trim();
-    case 'CONFIG_INVALID':  return `workspace-config.json 不合法：${r.message || ''}`.trim();
+    case 'CONFIG_INVALID':  return `CBB-WORKSPACE.json 不合法：${r.message || ''}`.trim();
     case 'INIT_FAILED':     return `初始化失败：${r.message || ''}`.trim();
     default:                return r.error || '未知错误';
   }
@@ -1839,7 +1841,7 @@ async function setupUserLevelComponents(targetAdapters = adapters) {
 /**
  * cbb update：就地升级当前目录内容 + 用户级组件。
  *
- * 单层安装：统一安装器按空间根判定（workspace-config.json + .git 目录）补齐
+ * 单层安装：统一安装器按空间根判定（CBB-WORKSPACE.json + .git 目录）补齐
  * worktree 管理入口与空间导航；旧子集清单升级时由清单差集机制自动补齐全量内容。
  */
 async function updateInstalled() {

package/cbb/lib/install/workspaces.js

@@ -16,7 +16,7 @@ const path = require('path');
 const { execSync } = require('child_process');
 
 const DEFAULT_CONFIG = 'config/workspaces.json';
-const SAMPLE_CONFIG  = 'config/workspace-config.sample.json';
+const SAMPLE_CONFIG  = 'config/CBB-WORKSPACE.sample.json';
 const SAMPLE_AGENTS_MD = 'config/workspace-agents.sample.md';
 
 /**
@@ -104,7 +104,7 @@ function loadWorkspaces(configPath = DEFAULT_CONFIG) {
 }
 
 /**
- * 校验业务工作空间 workspace-config.json 的格式是否合法。
+ * 校验业务工作空间 CBB-WORKSPACE.json 的格式是否合法。
  *
  * 校验项：
  *  - 文件存在且为合法 JSON
@@ -113,31 +113,31 @@ function loadWorkspaces(configPath = DEFAULT_CONFIG) {
  *  - name、repo 为非空字符串；side 必须为 'front'、'back' 或 'mixed'
  *  - desc 为可选字段；一旦出现必须是非空字符串（应用职责描述）
  *
- * @param {string} configPath workspace-config.json 的绝对路径
+ * @param {string} configPath CBB-WORKSPACE.json 的绝对路径
  * @returns {{ valid: boolean, message?: string, config?: object }}
  */
 function validateWorkspaceConfig(configPath) {
   if (!fs.existsSync(configPath)) {
-    return { valid: false, message: `workspace-config.json 不存在：${configPath}` };
+    return { valid: false, message: `CBB-WORKSPACE.json 不存在：${configPath}` };
   }
 
   let raw;
   try {
     raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
   } catch (e) {
-    return { valid: false, message: `workspace-config.json 不是合法 JSON：${e.message}` };
+    return { valid: false, message: `CBB-WORKSPACE.json 不是合法 JSON：${e.message}` };
   }
 
   if (!raw || typeof raw !== 'object') {
-    return { valid: false, message: 'workspace-config.json 内容应为 JSON 对象' };
+    return { valid: false, message: 'CBB-WORKSPACE.json 内容应为 JSON 对象' };
   }
 
   if (!Array.isArray(raw.apps)) {
-    return { valid: false, message: 'workspace-config.json 缺少 apps 数组' };
+    return { valid: false, message: 'CBB-WORKSPACE.json 缺少 apps 数组' };
   }
 
   if (raw.apps.length === 0) {
-    return { valid: false, message: 'workspace-config.json 中 apps 数组为空，请至少配置一个关联应用' };
+    return { valid: false, message: 'CBB-WORKSPACE.json 中 apps 数组为空，请至少配置一个关联应用' };
   }
 
   const VALID_SIDES = ['front', 'back', 'mixed'];
@@ -146,22 +146,22 @@ function validateWorkspaceConfig(configPath) {
     const label = `第 ${i + 1} 项`;
 
     if (!app || typeof app !== 'object') {
-      return { valid: false, message: `workspace-config.json ${label}不是对象` };
+      return { valid: false, message: `CBB-WORKSPACE.json ${label}不是对象` };
     }
     if (typeof app.name !== 'string' || !app.name.trim()) {
-      return { valid: false, message: `workspace-config.json ${label}缺少 name（应用名）` };
+      return { valid: false, message: `CBB-WORKSPACE.json ${label}缺少 name（应用名）` };
     }
     if (typeof app.repo !== 'string' || !app.repo.trim()) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 缺少 repo（Git 仓库地址）` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 缺少 repo（Git 仓库地址）` };
     }
     if (typeof app.side !== 'string' || !app.side.trim()) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 缺少 side（仓库类型，可选值：front / back / mixed）` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 缺少 side（仓库类型，可选值：front / back / mixed）` };
     }
     if (!VALID_SIDES.includes(app.side.trim())) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 的 side 字段值无效："${app.side}"（可选值：front / back / mixed）` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 的 side 字段值无效："${app.side}"（可选值：front / back / mixed）` };
     }
     if (app.desc !== undefined && (typeof app.desc !== 'string' || !app.desc.trim())) {
-      return { valid: false, message: `workspace-config.json "${app.name}" 的 desc 字段应为非空字符串（该应用的职责描述），不需要可整条删除` };
+      return { valid: false, message: `CBB-WORKSPACE.json "${app.name}" 的 desc 字段应为非空字符串（该应用的职责描述），不需要可整条删除` };
     }
   }
 
@@ -272,7 +272,7 @@ function extractRepoBasename(url) {
 
 /**
  * 判断 repo 是否为样例占位地址（RFC 2606 保留域名）。
- * 样例 workspace-config.json 的 repo 用 example.com 等占位，clone 必然失败；
+ * 样例 CBB-WORKSPACE.json 的 repo 用 example.com 等占位，clone 必然失败；
  * setup 据此逐条跳过空跑并给出明确编辑提示。
  * 支持 SSH（git@host:path）与 URL（ssh://、https://、git://）两种形式的 host 提取。
  *

package/cbb/lib/utils/githook.js

@@ -5,9 +5,10 @@
  *
  * 策略（对当前仓库生效，worktree 与主仓库共享 .git/hooks 故一并覆盖）：
  *   - 当前分支非主干（含 detached HEAD）→ 一律放行（两模式开发态都在需求分支上）
- *   - workspace 仓库（检出含 workspace-config.json）在主干上 → 只放行控制面白名单路径：
- *     workspace-config.json / .gitignore / AGENTS.md / openspec/config.yaml /
- *     openspec/schemas/** / .cbb/**（配置变更与 cbb update 部署物，直改即推）
+ *   - workspace 仓库（检出含 CBB-WORKSPACE.json）在主干上 → 只放行控制面白名单路径：
+ *     CBB-WORKSPACE.json / .gitignore / AGENTS.md / openspec/config.yaml /
+ *     openspec/schemas/** / .cbb/**（配置变更与 cbb update 部署物，直改即推）；
+ *     另放行旧名 workspace-config.json 的删除条目（仅用于一次性更名迁移）
  *   - 应用仓库在主干上 → 全拦（交付只走 MR）
  *   - 逃生口：用户显式 git commit --no-verify（AI 侧纪律禁止自动绕过）
  *
@@ -60,20 +61,21 @@ const PRE_COMMIT_SOURCE = [
   "const files = staged.split(/\\r?\\n/).filter(Boolean);",
   'if (files.length === 0) process.exit(0);',
   '',
-  '// 仓库类型：workspace 仓库 = 检出含 workspace-config.json',
-  "const isWorkspace = fs.existsSync('workspace-config.json');",
+  '// 仓库类型：workspace 仓库 = 检出含 CBB-WORKSPACE.json（或旧名，改名过渡期识别）',
+  "const isWorkspace = fs.existsSync('CBB-WORKSPACE.json') || fs.existsSync('workspace-config.json');",
   '',
   'function deny(bad) {',
   "  console.error('[cbb-guard] 主干上拦截载荷提交（ADR 0002）：');",
   "  bad.forEach(f => console.error('  ' + f));",
   "  console.error('需求载荷须在需求分支上提交：本地模式先 git checkout -b <需求名>；worktree 模式在 .worktrees/ 工作树内提交。');",
-  "  console.error('控制面白名单：workspace-config.json / .gitignore / AGENTS.md / openspec/config.yaml / openspec/schemas/** / .cbb/**');",
+  "  console.error('控制面白名单：CBB-WORKSPACE.json / .gitignore / AGENTS.md / openspec/config.yaml / openspec/schemas/** / .cbb/**');",
   "  console.error('如确需在主干提交，须由用户显式 git commit --no-verify。');",
   '  process.exit(1);',
   '}',
   '',
   'if (isWorkspace) {',
-  "  const EXACT = new Set(['workspace-config.json', '.gitignore', 'AGENTS.md', 'openspec/config.yaml']);",
+  '  // 旧名仅放行删除条目：更名迁移提交（git mv）会产生旧名删除 + 新名新增两条',
+  "  const EXACT = new Set(['CBB-WORKSPACE.json', 'workspace-config.json', '.gitignore', 'AGENTS.md', 'openspec/config.yaml']);",
   "  const PREFIXES = ['openspec/schemas/', '.cbb/'];",
   '  const bad = files.filter(f => !EXACT.has(f) && !PREFIXES.some(p => f.indexOf(p) === 0));',
   '  if (bad.length) deny(bad);',

package/cbb/worktrees/_shared/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/_shared/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/_shared/scripts/start-local.js

@@ -9,7 +9,7 @@
  *      退出码 2（agent 应升级为用户决策：继续 / 收尾 / 升级 / 丢弃，不在本脚本内处理）
  *   2. 参与仓库 = workspace + 应用子集：
  *      - --apps a,b  → 指定应用（本地模式推荐：从需求语境提取涉及应用）
- *      - --all-apps  → workspace-config.json 全量应用
+ *      - --all-apps  → CBB-WORKSPACE.json 全量应用
  *      - 缺省       → 仅 workspace（后续重跑幂等补齐，与 worktree-init 增补语义一致）
  *   3. 每个仓库：
  *      - 当前已在 <branch> → reused
@@ -108,10 +108,10 @@ if (argApps >= 0) {
   appNames = raw.split(',').map(s => s.trim()).filter(Boolean);
 } else if (argAll) {
   try {
-    const config = JSON.parse(fs.readFileSync(path.join(wsRoot, 'workspace-config.json'), 'utf-8'));
+    const config = JSON.parse(fs.readFileSync(path.join(wsRoot, 'CBB-WORKSPACE.json'), 'utf-8'));
     appNames = (config.apps || []).map(a => a.name);
   } catch (e) {
-    console.error('❌ 读取 workspace-config.json 失败：' + e.message);
+    console.error('❌ 读取 CBB-WORKSPACE.json 失败：' + e.message);
     process.exit(2);
   }
 }
@@ -120,7 +120,7 @@ const targets = [{ name: 'workspace', dir: wsRoot }];
 for (const name of appNames) {
   const appDir = path.join(wsRoot, '.codespace', name);
   if (!fs.existsSync(path.join(appDir, '.git'))) {
-    console.error('❌ 应用仓库不存在：.codespace/' + name + '（请检查 workspace-config.json 或先跑 cbb setup）');
+    console.error('❌ 应用仓库不存在：.codespace/' + name + '（请检查 CBB-WORKSPACE.json 或先跑 cbb setup）');
     process.exit(2);
   }
   targets.push({ name, dir: appDir });

package/cbb/worktrees/skills/cbb-local-mode/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-local-mode/scripts/start-local.js

@@ -9,7 +9,7 @@
  *      退出码 2（agent 应升级为用户决策：继续 / 收尾 / 升级 / 丢弃，不在本脚本内处理）
  *   2. 参与仓库 = workspace + 应用子集：
  *      - --apps a,b  → 指定应用（本地模式推荐：从需求语境提取涉及应用）
- *      - --all-apps  → workspace-config.json 全量应用
+ *      - --all-apps  → CBB-WORKSPACE.json 全量应用
  *      - 缺省       → 仅 workspace（后续重跑幂等补齐，与 worktree-init 增补语义一致）
  *   3. 每个仓库：
  *      - 当前已在 <branch> → reused
@@ -108,10 +108,10 @@ if (argApps >= 0) {
   appNames = raw.split(',').map(s => s.trim()).filter(Boolean);
 } else if (argAll) {
   try {
-    const config = JSON.parse(fs.readFileSync(path.join(wsRoot, 'workspace-config.json'), 'utf-8'));
+    const config = JSON.parse(fs.readFileSync(path.join(wsRoot, 'CBB-WORKSPACE.json'), 'utf-8'));
     appNames = (config.apps || []).map(a => a.name);
   } catch (e) {
-    console.error('❌ 读取 workspace-config.json 失败：' + e.message);
+    console.error('❌ 读取 CBB-WORKSPACE.json 失败：' + e.message);
     process.exit(2);
   }
 }
@@ -120,7 +120,7 @@ const targets = [{ name: 'workspace', dir: wsRoot }];
 for (const name of appNames) {
   const appDir = path.join(wsRoot, '.codespace', name);
   if (!fs.existsSync(path.join(appDir, '.git'))) {
-    console.error('❌ 应用仓库不存在：.codespace/' + name + '（请检查 workspace-config.json 或先跑 cbb setup）');
+    console.error('❌ 应用仓库不存在：.codespace/' + name + '（请检查 CBB-WORKSPACE.json 或先跑 cbb setup）');
     process.exit(2);
   }
   targets.push({ name, dir: appDir });

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

@@ -12,10 +12,10 @@ description: "关闭/清理/删除需求工作空间的 worktree 和分支。触
 ## 核心原则
 
 - 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**
-- 本技能是 `cbb-worktree-init` 的逆操作：共用 `workspace-config.json`、共用 `.worktrees/worktree-<需求名>/` 物理直聚命名、共用统一的分支名（不加前缀）
+- 本技能是 `cbb-worktree-init` 的逆操作：共用 `CBB-WORKSPACE.json`、共用 `.worktrees/worktree-<需求名>/` 物理直聚命名、共用统一的分支名（不加前缀）
 - App worktree **物理嵌套**在 workspace worktree 的 `.codespace/` 容器内（`.worktrees/worktree-<需求名>/.codespace/<应用名>/`，镜像空间根布局，ADR 0003），但 git 上属于各自仓库的独立 worktree
 - 只操作 `.worktrees/worktree-<需求名>` 这一类精确路径，**绝不碰其它 worktree**（如 IDE/工具自动创建的 `~/.qoder/worktree/...` 会话 worktree）
-- 通过检查 `.worktrees/worktree-<需求名>/.codespace/<应用名>/` **是否实际存在**来确定关联应用——创建时用户可能只关联了 `workspace-config.json` 中的部分应用，不能假设全部应用都关联
+- 通过检查 `.worktrees/worktree-<需求名>/.codespace/<应用名>/` **是否实际存在**来确定关联应用——创建时用户可能只关联了 `CBB-WORKSPACE.json` 中的部分应用，不能假设全部应用都关联
 - **顺序硬约束：先移除所有 worktree，再删除分支。** 目标分支当前正检出于 worktree 中，先删分支会报 `error: Cannot delete branch '<分支>' checked out at '<worktree 路径>'`
 - **破坏性操作必须先报告、经用户确认才执行**：未提交修改、未合并/未推送的提交，绝不静默 `--force` 或 `-D` 丢弃
 - 软性检查失败时报告详情，询问用户是否继续
@@ -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 不是技能目录，会解析失败）
 
 ---
@@ -62,9 +62,9 @@ node "<skill_dir>/scripts/find-workspace-root.js"
 - 退出码 0 + 末行（纯路径） → WS_ROOT 绝对路径
 - 退出码 1 → 未找到工作空间根目录，**终止流程**
 
-> ⓘ **为什么不用 workspace-config.json 存在性判断**：init-worktree 会把 workspace-config.json 提交到主分支，`git worktree add` 会自动 checkout 副本到 worktree 目录中。若用 workspace-config.json 存在性判断，在 worktree 内执行时会错误地把 worktree 目录当作 WS_ROOT。使用 `git worktree list` 的第一行（git 契约上始终为主仓库绝对路径）则不受该问题影响。
+> ⓘ **为什么不用 CBB-WORKSPACE.json 存在性判断**：init-worktree 会把 CBB-WORKSPACE.json 提交到主分支，`git worktree add` 会自动 checkout 副本到 worktree 目录中。若用 CBB-WORKSPACE.json 存在性判断，在 worktree 内执行时会错误地把 worktree 目录当作 WS_ROOT。使用 `git worktree list` 的第一行（git 契约上始终为主仓库绝对路径）则不受该问题影响。
 
-> close-worktree 是 init-worktree 的逆操作，但本步骤的 WS_ROOT 定位逻辑与 init-worktree 不同：init-worktree 强制根目录执行（不需要处理 worktree 场景），close-worktree 支持 worktree 内执行（需要绕开 workspace-config.json 副本陷阱）。
+> close-worktree 是 init-worktree 的逆操作，但本步骤的 WS_ROOT 定位逻辑与 init-worktree 不同：init-worktree 强制根目录执行（不需要处理 worktree 场景），close-worktree 支持 worktree 内执行（需要绕开 CBB-WORKSPACE.json 副本陷阱）。
 
 ---
 
@@ -97,7 +97,7 @@ node "<skill_dir>/scripts/find-target-worktree.js "<ws_root>"
 node "<skill_dir>/scripts/discover-apps.js "<ws_root>" "<branch>"
 ```
 
-脚本自动从 `workspace-config.json` 读取应用列表，扫描 `.worktrees/worktree-<branch>/.codespace/<应用名>/`（兼容 ≤beta.23 旧平铺 `<应用名>/`）实际存在的子目录。
+脚本自动从 `CBB-WORKSPACE.json` 读取应用列表，扫描 `.worktrees/worktree-<branch>/.codespace/<应用名>/`（兼容 ≤beta.23 旧平铺 `<应用名>/`）实际存在的子目录。
 
 **解读末行 `DISCOVER_RESULT`**：
 - `workspace` 字段：workspace worktree 绝对路径（AI agent 记录供后续命令使用）
@@ -430,7 +430,7 @@ git -C "<ws_root>" worktree list
 
 ### 必须执行
 
-- 读 `workspace-config.json` 取应用名列表；以 `.worktrees/worktree-<需求名>/.codespace/<应用名>/` 实际存在性确定关联清单
+- 读 `CBB-WORKSPACE.json` 取应用名列表；以 `.worktrees/worktree-<需求名>/.codespace/<应用名>/` 实际存在性确定关联清单
 - 移除/删除前执行安全评估（未提交修改 / 是否合并 / 是否推远程）并报告
 - 严格按 Step 4.2（移除 worktree）→ Step 4.4（删分支）顺序
 - 移除 workspace worktree 前先把会话移出（`cd "<WS_ROOT>" &&` 或 `git -C` 绝对路径）

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

@@ -3,14 +3,14 @@ require('./silence-popup');
 /**
  * cbb-worktree-close 环境健康探活
  *
- * close-worktree 必须在工作空间根目录或 worktree 内执行，且需找到 workspace-config.json。
- * 与 init/extend 探活同构，但额外校验 workspace-config.json 存在性。
+ * close-worktree 必须在工作空间根目录或 worktree 内执行，且需找到 CBB-WORKSPACE.json。
+ * 与 init/extend 探活同构，但额外校验 CBB-WORKSPACE.json 存在性。
  *
  * 退出码：
  *   0 - 探活通过
  *   1 - 致命错误（git 不可用）
  *   2 - 当前不在 git 仓库
- *   3 - 未找到 workspace-config.json
+ *   3 - 未找到 CBB-WORKSPACE.json
  */
 
 const { execSync } = require('child_process');

package/cbb/worktrees/skills/cbb-worktree-close/scripts/delete-branches.js

@@ -116,7 +116,7 @@ function deleteBranch(repoPath, name) {
   return true;
 }
 
-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) {}
 

package/cbb/worktrees/skills/cbb-worktree-close/scripts/discover-apps.js

@@ -5,7 +5,7 @@ require('./silence-popup');
  *
  * 用法：node discover-apps.js <ws_root> <branch>
  *
- * 从 workspace-config.json 读取应用列表，扫描 .worktrees/worktree-<branch>/ 实际存在的子目录。
+ * 从 CBB-WORKSPACE.json 读取应用列表，扫描 .worktrees/worktree-<branch>/ 实际存在的子目录。
  *
  * 输出末行：DISCOVER_RESULT { workspace: <wt_path>, apps: [{name, repo, side, wt_path}] }
  *
@@ -26,9 +26,9 @@ if (!wsRoot || !branch) {
   process.exit(1);
 }
 
-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);
   process.exit(1);
 }
 
@@ -36,7 +36,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);
   process.exit(1);
 }
 

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,7 +83,7 @@ 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) {}
 

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

@@ -152,7 +152,7 @@ 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) {}