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

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) {}
 

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

@@ -16,9 +16,9 @@ description: "为一个需求在 workspace 与各关联应用仓库同步创建
 - 所有仓库使用统一的分支名（不加前缀）；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 [...]` → 全部成功
@@ -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
@@ -354,7 +358,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 
 | 场景 | 重跑行为 |
 |------|----------|
-| 空间新增了应用（编辑 `workspace-config.json` 后） | Step 1 拉取新应用代码 → Step 3.3 为新应用建分支 → Step 3.5 在 `.codespace/` 容器内创建缺失的 app 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 +389,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 仓库执行完整五项检查
 
@@ -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 前切分支
 
@@ -468,8 +472,8 @@ 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 定位）
-- Step 4 交接必须声明"开发会话开在 `<wt_path>`、根会话保留作控制面"
+- 所有脚本调用以 `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 = 新开会话）、空间根路径在案作控制面"
 
 ---
 
@@ -478,7 +482,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(', '));

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 失败时跳过失败仓库直接继续

package/cbb/worktrees/skills/cbb-worktree-push/scripts/commit-worktrees.js

@@ -97,10 +97,10 @@ function isGitRepo(p) {
   return fs.existsSync(path.join(p, '.git'));
 }
 
-/** 读取 workspace-config.json 的 app 名列表（旧布局兼容判定用；缺失返回 []） */
+/** 读取 CBB-WORKSPACE.json 的 app 名列表（旧布局兼容判定用；缺失返回 []） */
 function loadAppNames(wsRoot) {
   try {
-    const cfg = JSON.parse(fs.readFileSync(path.join(wsRoot, 'workspace-config.json'), 'utf-8'));
+    const cfg = JSON.parse(fs.readFileSync(path.join(wsRoot, 'CBB-WORKSPACE.json'), 'utf-8'));
     return Array.isArray(cfg.apps) ? cfg.apps.map(a => a.name).filter(Boolean) : [];
   } catch (e) {
     return [];

package/cbb/worktrees/skills/cbb-worktree-push/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-push/scripts/push-worktrees.js

@@ -59,10 +59,10 @@ function isGitRepo(p) {
   }
 }
 
-/** 读取 workspace-config.json 的 app 名列表（旧布局兼容判定用；缺失返回 []） */
+/** 读取 CBB-WORKSPACE.json 的 app 名列表（旧布局兼容判定用；缺失返回 []） */
 function loadAppNames(wsRoot) {
   try {
-    const cfg = JSON.parse(fs.readFileSync(path.join(wsRoot, 'workspace-config.json'), 'utf-8'));
+    const cfg = JSON.parse(fs.readFileSync(path.join(wsRoot, 'CBB-WORKSPACE.json'), 'utf-8'));
     return Array.isArray(cfg.apps) ? cfg.apps.map(a => a.name).filter(Boolean) : [];
   } catch (e) {
     return [];

package/config/{workspace-config.sample.json → CBB-WORKSPACE.sample.json}

@@ -1,5 +1,5 @@
 {
-    "_comment": "AI 开发工作空间配置样例（请勿修改本文件，复制为工作空间根目录的 workspace-config.json 后编辑使用）。apps 数组中每个对象需包含：name（应用名，同时作为 .codespace/ 子目录名）、repo（Git 仓库地址，支持 SSH 或 HTTPS）、side（仓库类型，'front' 表示前端工程，'back' 表示后端工程，'mixed' 表示前后端混合工程）；可选 desc（该应用的职责描述，便于人与 AI 理解应用分工）。",
+    "_comment": "AI 开发工作空间配置样例（请勿修改本文件，复制为工作空间根目录的 CBB-WORKSPACE.json 后编辑使用）。apps 数组中每个对象需包含：name（应用名，同时作为 .codespace/ 子目录名）、repo（Git 仓库地址，支持 SSH 或 HTTPS）、side（仓库类型，'front' 表示前端工程，'back' 表示后端工程，'mixed' 表示前后端混合工程）；可选 desc（该应用的职责描述，便于人与 AI 理解应用分工）。",
     "apps":
     [
         {