@jspg-ai/coding-bb 0.0.1 → 0.0.2-beta.22

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: openspec-init-worktree
-description: "为一个需求在 workspace 与各关联应用仓库同步创建同名物理 git worktree，直聚在 `.worktrees/worktree-<需求名>/` 下。触发：用户明确要求创建需求工作空间/开发隔离环境。禁止自动串联 openspec-extend-worktree 或 openspec-close-worktree——除非用户明确说了要补加应用或关闭。"
+name: cbb-worktree-init
+description: "为一个需求在 workspace 与各关联应用仓库（= workspace-config.json 全量 apps）同步创建同名物理 git worktree，直聚在 `.worktrees/worktree-<需求名>/` 下。触发：用户明确要求创建需求工作空间/开发隔离环境，或为已有需求补齐新增应用（重跑本技能即幂等）。禁止自动串联 cbb-worktree-close——除非用户明确说了要关闭。"
 license: MIT
 compatibility: Requires git (>=2.30) and Node.js (>=16.7.0). All commands are pure Node.js scripts under `scripts/`, fully cross-platform (Windows / macOS / Linux, bash / PowerShell / Git Bash).
 metadata:
@@ -13,15 +13,16 @@ metadata:
 
 为一个需求在 workspace 与各关联应用仓库同步创建同名 git worktree，物理直聚在 `.worktrees/worktree-<需求名>/` 目录下。当你需要跨多个微服务仓库并行开发某个需求时，本技能一次性完成工作空间和所有关联应用仓库的 worktree 创建。
 
-**启动时声明：** "我正在使用 openspec-init-worktree 技能来创建多仓库联动的隔离 worktree 环境。"
+**启动时声明：** "我正在使用 cbb-worktree-init 技能来创建多仓库联动的隔离 worktree 环境。"
 
 ## 核心原则
 
 - 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**（Windows PowerShell / macOS bash / Linux bash / Git Bash 均无需适配）
 - 物理位置与 `init-worktree` 兼容：`.worktrees/worktree-<需求名>/<应用名>/`
 - 所有仓库使用统一的分支名（不加前缀）；worktree 目录名自动加 `worktree-` 前缀
-- **本技能必须在业务工作空间根目录执行**（即由 `cbb setup` 初始化、包含 `CONFIG.json` 的目录）
-- 输入约定：**自由文本**（需求名、应用仓库 URL 等）直接在对话中提问并等待回复，禁止使用 `AskUserQuestion`；**固定列表多选**（如应用选择）使用 `AskUserQuestion`（`multiSelect: true`），按 side 分组排列选项
+- **本技能必须在业务工作空间根目录执行**（即由 `cbb setup` 初始化、包含 `workspace-config.json` 的目录）
+- 输入约定：**自由文本**（需求名等）直接在对话中提问并等待回复，禁止使用 `AskUserQuestion`；`AskUserQuestion` 仅用于固定选项决策场景（如 push 失败处理、远程分支已存在时的二选一）
+- 关联应用固定为 `workspace-config.json` 的**全量 apps**（无勾选选择）；需要增减应用时编辑该文件并重跑本技能（幂等）
 
 ---
 
@@ -31,7 +32,7 @@ metadata:
 
 调用方式（推荐用绝对路径）：
 ```
-node "D:\workspace\<用户工作空间>\.qoder\skills\openspec-init-worktree\scripts\<name>.js" <参数>
+node "D:\workspace\<用户工作空间>\.qoder\skills\cbb-worktree-init\scripts\<name>.js" <参数>
 ```
 
 脚本输出：
@@ -44,7 +45,7 @@ node "D:\workspace\<用户工作空间>\.qoder\skills\openspec-init-worktree\scr
 - `<branch>`：需求名字符串
 - `<wt_path>`：worktree 绝对路径
 
-所有脚本读 CONFIG.json：app 列表从 `<ws_root>/CONFIG.json` 读取，不需要传 JSON 参数。
+所有脚本读 workspace-config.json：app 列表从 `<ws_root>/workspace-config.json` 读取，不需要传 JSON 参数。
 
 ---
 
@@ -53,7 +54,7 @@ node "D:\workspace\<用户工作空间>\.qoder\skills\openspec-init-worktree\scr
 ### 0.1 环境健康探活
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/check-env.js"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-env.js"
 ```
 
 **解读输出**：
@@ -66,7 +67,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/check-
 提前检测网络/权限/版本问题，把可能在 Step 3.4 push 或 Step 4 install-ai 暴露的失败前移到流程最开始：
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/check-env-deep.js"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-env-deep.js"
 ```
 
 **解读输出**：
@@ -79,10 +80,10 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/check-
 - cbb 是否已安装（未安装仅警告，由 Step 4 自动安装）
 - `.worktrees/` 目录可写
 
-### 0.2 读取并校验 CONFIG.json
+### 0.2 读取并校验 workspace-config.json
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/parse-config.js"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/parse-config.js"
 ```
 
 **解读输出**：
@@ -92,23 +93,23 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/parse-
 
 ### 0.3 配置引导
 
-当 `CONFIG.json` 缺失、`apps` 为空或格式错误时，向用户说明情况并给出两个选项：
+当 `workspace-config.json` 缺失、`apps` 为空或格式错误时，向用户说明情况并给出两个选项：
 
 ```
-⚠️ 当前工作空间尚未配置关联应用（CONFIG.json 缺失或 apps 为空）。
+⚠️ 当前工作空间尚未配置关联应用（workspace-config.json 缺失或 apps 为空）。
 worktree 需要知道要关联哪些应用仓库。
 
 请选择：
-  [1] 我自行配置 CONFIG.json，配好后告诉你继续
-  [2] 提供应用仓库地址，我帮你写入 CONFIG.json
+  [1] 我自行配置 workspace-config.json，配好后告诉你继续
+  [2] 提供应用仓库地址，我帮你写入 workspace-config.json
 ```
 
 **选项 1：用户自行配置**
 - 停止当前技能流程
-- 提示用户：*"请编辑 CONFIG.json 后回复'继续'，或重新执行 init-worktree。"*
+- 提示用户：*"请编辑 workspace-config.json 后回复'继续'，或重新执行 init-worktree。"*
 - 用户回复"继续"后，重新从 Step 0 开始校验
 
-**选项 2：帮用户写入 CONFIG.json**
+**选项 2：帮用户写入 workspace-config.json**
 - 直接在对话中请用户提供应用信息，格式示例：
   ```
   应用名: ep-user-auth-app
@@ -119,7 +120,7 @@ worktree 需要知道要关联哪些应用仓库。
   仓库地址: git@code.example.com:team/ep-user-info-server.git
   类型: back（后端）
   ```
-- 解析后写入 `CONFIG.json`：
+- 解析后写入 `workspace-config.json`：
   ```json
   {
     "apps": [
@@ -130,85 +131,51 @@ worktree 需要知道要关联哪些应用仓库。
   ```
 - 写入成功后提交到当前分支（确保 Step 2 状态检查通过）：
   ```bash
-  git add CONFIG.json
-  git commit -m "chore: add CONFIG.json"
+  git add workspace-config.json
+  git commit -m "chore: add workspace-config.json"
   ```
   > 若当前不在主分支上，提示用户切回主分支后再提交；若已在主分支上则直接提交。
 - 提交后重新从 Step 0 校验，通过后继续 Step 1
 
-> ⚠️ **禁止**：在 CONFIG.json 无效时跳过本步骤直接创建 worktree，否则无法确定关联应用。
+> ⚠️ **禁止**：在 workspace-config.json 无效时跳过本步骤直接创建 worktree，否则无法确定关联应用。
 
 ---
 
-## Step 1：应用选择与代码同步
+## Step 1：关联应用与代码同步
 
-> 🚨 **label 由脚本硬生成，不由 AI 拼接**：调用 `generate-app-options.js` 获取 options，禁止手动构造 label。
+> ⓘ **关联应用 = `workspace-config.json` 的全量 apps，无勾选选择**。所有脚本自行从 `<ws_root>/workspace-config.json` 读取应用列表，无需 AI 传递应用参数。
+> 需要增减应用时，编辑 `workspace-config.json` 后**重跑本技能**即可（幂等，已存在的分支/worktree 自动复用，详见「幂等重跑」章节）。
 
-### 1.1 读取配置并选择应用
-
->  **绝对禁止**：不要从 Step 0.2 `parse-config.js` 的输出中自行解析 JSON 来构造 options。`parse-config.js` 仅用于校验 CONFIG.json 是否有效，其输出**不包含**格式化后的 label。必须通过下方脚本获取 options。
-
-1. **必须运行 `generate-app-options.js` 脚本**获取 options。这是获取应用选项的**唯一合法途径**。脚本内部用 `JSON.parse` 读取 CONFIG.json，用硬编码公式 `【sideLabel】 - app.name` 逐条生成 label——`app.name` 逐字符原样复制，绝不会被翻译或替换。
-
-   ```bash
-   node ".qoder/skills/openspec-init-worktree/scripts/generate-app-options.js"
-   ```
-
-   **解读输出**：
-   - 退出码 0 + 末行 `APP_OPTIONS [{...}]` → 提取该行 JSON 数组，即为 options
-   - 退出码 1/2 → 出错，**终止流程**
-
-   options 中每个元素含：
-   - `label`：直接用于 AskUserQuestion 的选项文本（已格式化，如 `【后端】 - ep-user-auth-app`）
-   - `name`：CONFIG.json 中 name 的原始值（用于后续步骤匹配）
-
-2. **初始消息已点名应用名**：逐个按 `name` 在 options 中匹配；不在配置中的询问用户手动输入 git URL，然后跳到 1.3。
-
-3. **否则使用 `AskUserQuestion`（`multiSelect: true`）让用户勾选**：将脚本输出的 options 数组**原样传入**，不增、不减、不改任何字段：
-
-   ```
-   AskUserQuestion({
-     questions: [{
-       header: "关联应用",
-       multiSelect: true,
-       options: <脚本输出的 options 数组，不做任何修改>
-     }]
-   })
-   ```
-
-4. **解析选择结果**：从 `AskUserQuestion` 返回的选中项中提取应用名（去掉 `【后端】 - ` / `【前端】 - ` 前缀），得到选中的应用列表。用户未选任何项时终止流程。
-
-### 1.2 同步 `.code/` 目录代码
+### 1.1 同步 `.codespace/` 目录代码
 
 ```bash
 # ws_root 来自 AI agent 维护的状态
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/sync-repos.js" "<ws_root>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/sync-repos.js" "<ws_root>"
 ```
 
 **用法**：
-- `<ws_root>`：工作空间根绝对路径
-- `<app1,app2,...>`：上一步选中的 apps 数组 JSON 字符串
+- `<ws_root>`：工作空间根绝对路径（apps 由脚本内部从 `<ws_root>/workspace-config.json` 读取）
 
 **解读输出**：
 - 退出码 0 + 末行 `SYNC_RESULT [...]` → 全部成功
 - 退出码 2 + 末行 `SYNC_RESULT [...]`（含 `clone-failed` 项）→ 部分 clone 失败，**终止流程**
 
-> ⓘ **`.code/` 目录**：所有应用代码统一存放在工作空间的 `.code/` 下。基准代码由 `cbb setup` 命令首次 clone，本脚本检查时如已存在则 fetch 更新（秒级），不存在则 clone 兜底。该目录在 Step 3.2 加入 `.gitignore`，不被 workspace 仓库跟踪。
+> ⓘ **`.codespace/` 目录**：所有应用代码统一存放在工作空间的 `.codespace/` 下。基准代码由 `cbb setup` 命令首次 clone，本脚本检查时如已存在则 fetch 更新（秒级），不存在则 clone 兜底。该目录在 Step 3.2 加入 `.gitignore`，不被 workspace 仓库跟踪。
 
-### 1.3 最终输出
+### 1.2 最终输出
 
-列出确认的关联应用及本地路径（保留序号便于复核），向用户展示并确认：
+列出本次关联的应用（`workspace-config.json` 全量）及本地路径（保留序号便于复核），向用户展示并确认：
 
 ```
-确认关联应用：
+确认关联应用（workspace-config.json 全量）：
   后端：
-    [1] ep-user-auth-app  → .code/ep-user-auth-app
-    [2] ep-user-info-server → .code/ep-user-info-server
+    [1] ep-user-auth-app  → .codespace/ep-user-auth-app
+    [2] ep-user-info-server → .codespace/ep-user-info-server
   前端：
-    [3] ep-user-web → .code/ep-user-web
+    [3] ep-user-web → .codespace/ep-user-web
 ```
 
-> 后续所有步骤中的 `APP_REPOS` 均指向 `$WS_ROOT/.code/<应用名>/`，不再依赖开发者手动配置本地路径。
+> 后续所有步骤中的 `APP_REPOS` 均指向 `$WS_ROOT/.codespace/<应用名>/`，不再依赖开发者手动配置本地路径。
 
 ---
 
@@ -227,7 +194,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/sync-r
 | 当前在主分支上 | ✅ | ❌ |
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/check-repos.js "<ws_root>" '<app1,app2,...>'
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-repos.js" "<ws_root>"
 ```
 
 **解读输出**：
@@ -255,10 +222,10 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/check-
 ### 3.2 安全更新 .gitignore（前置）
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/update-gitignore.js "<ws_root>" "<branch>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/update-gitignore.js "<ws_root>" "<branch>"
 ```
 
-脚本内部自动完成：stash 保护 → 切分支 → 添加 `.worktrees/` 和 `.code/` → 提交 → 切回 → pop stash
+脚本内部自动完成：stash 保护 → 切分支 → 添加 `.worktrees/` 和 `.codespace/` → 提交 → 切回 → pop stash
 
 **解读输出**：
 - 退出码 0 + 末行 `GITIGNORE_OK` → 成功
@@ -269,7 +236,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/update
 ### 3.3 创建分支
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/create-branches.js" "<ws_root>" "<branch>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/create-branches.js" "<ws_root>" "<branch>"
 ```
 
 **解读输出**：
@@ -294,7 +261,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/create
 ### 3.4 推送并建立 upstream
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/push-branches.js" "<ws_root>" "<branch>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/push-branches.js" "<ws_root>" "<branch>"
 ```
 
 脚本内部自动完成：
@@ -305,6 +272,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/push-b
 
 **解读输出：**
 - 退出码 0 + 末行 `PUSH_RESULT [...]` → 全部推送成功，继续 Step 3.5
+- 结果项 `skipped`（远程分支已存在且与本地一致）→ 幂等跳过，非失败
 - 退出码 2 + 末行 `PUSH_RESULT [...]`（含 `failed` 或 `remote-exists` 项）→ **阻塞流程，AI agent 必须询问用户决策**（见下方"失败处理"）
 
 **失败处理（AI agent 行为）：**
@@ -321,7 +289,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/push-b
 ### 3.5 创建 Worktree（含自愈清理）
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/create-worktrees.js" "<ws_root>" "<branch>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/create-worktrees.js" "<ws_root>" "<branch>"
 ```
 
 脚本内部自动完成：
@@ -345,27 +313,27 @@ WT_PATH d:\workspace\xxx\.worktrees\worktree-feature-login
 
 > ⓘ **tracked 内容自动 checkout**：workspace 主分支 tracked 的所有内容（openspec/、cbb/ 等）在 workspace 工作树创建时**自动从 git 对象库 checkout**——**不需要 `cp`、`git clone` 或任何“带过来”动作**。各应用 worktree 同理。
 
-> ⓘ **AI 配置目录（.claude/、.qoder/ 等）**：workspace 主分支中这些目录通常为 gitignore'd，不会自动出现在 worktree 中。本 skill 在 Step 4 统一在 worktree 内执行 `cbb init -y` 安装 AI 配置，无需依赖用户手动配置。
+> ⓘ **AI 配置目录（.claude/、.qoder/ 等）**：workspace 主分支中这些目录通常为 gitignore'd，不会自动出现在 worktree 中。本 skill 在 Step 4 统一在 worktree 内执行 `cbbm init -y` 安装 AI 配置，无需依赖用户手动配置。
 
 ---
 
 ## Step 4：安装 AI 配置（必要步骤）
 
 workspace 主分支的 `.claude/` `.qoder/` `.cbb/` 通常为 gitignore'd，创建 worktree 时不会自动带入。
-**本步骤在 worktree 内执行 `cbb init --yes` 是必要步骤**——缺失 AI 配置会导致后续
+**本步骤在 worktree 内执行 `cbbm init --yes` 是必要步骤**——缺失 AI 配置会导致后续
 openspec-propose/apply/verify/ff 等技能全部不可用，worktree 将处于"半残"状态。
 
 > 与 push-branches（Step 3.4）一致：**本步骤失败将阻塞 init-worktree**，用户必须手动恢复后重跑。
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/install-ai.js "<wt_path>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/install-ai.js "<wt_path>"
 ```
 
 **解读输出**：
 - 退出码 0 + 末行 `AI_INIT_OK` → 成功，继续 Step 5
 - 退出码 1 → 参数错误（脚本 bug）
-- 退出码 2 + 末行 `AI_INIT_FAILED` → cbb init 执行失败，**init-worktree 中断**，
-  按错误提示手动执行 `cd "<wt_path>" && cbb init --yes` 后重跑
+- 退出码 2 + 末行 `AI_INIT_FAILED` → cbbm init 执行失败，**init-worktree 中断**，
+  按错误提示手动执行 `cd "<wt_path>" && cbbm init --yes` 后重跑
 
 > `-y` 表示非交互模式：默认选中所有适配器、前置依赖未安装时自动继续，适合 skill 自动化执行。
 
@@ -376,7 +344,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/instal
 所有步骤完成后，检测当前运行环境，**在新窗口打开 IDE** 并定位到 workspace worktree 目录。
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-open.js "<wt_path>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.js "<wt_path>"
 ```
 
 **解读末行**：
@@ -394,31 +362,45 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 
 ---
 
+## 幂等重跑（增减应用 / 中断恢复）
+
+本技能可安全重跑：在业务工作空间根目录用**同一个需求名**再执行一次即可。
+
+| 场景 | 重跑行为 |
+|------|----------|
+| 空间新增了应用（编辑 `workspace-config.json` 后） | Step 1 拉取新应用代码 → Step 3.3 为新应用建分支 → Step 3.4 推送（已一致的分支 `skipped`，不一致则阻塞询问）→ Step 3.5 创建缺失的嵌套 worktree |
+| 上次 init 中途失败 | 已存在的分支 / worktree 自动复用，`.gitignore` 处理自动跳过，仅补齐缺失部分 |
+| 应用从 config 移除 | 已创建的分支 / worktree **不会**自动删除；如需清理用 `/cbb:worktree-close` 关闭后重建 |
+
+> ⓘ 重跑**不会静默推送**开发中的本地提交：远程分支已存在但与本地不一致时，Step 3.4 走阻塞式 `remote-exists` 决策（展示 commit 元信息让用户选择）。
+
+---
+
 ## 快速参考
 
 | 场景 | 处理方式 |
 |------|----------|
-| `.worktrees/` 或 `.code/` 未在 `.gitignore` | workspace 仓库自动添加并提交（在 Step 3.2） |
+| `.worktrees/` 或 `.codespace/` 未在 `.gitignore` | workspace 仓库自动添加并提交（在 Step 3.2） |
 | `git worktree add` 权限被拒 | 沙箱降级，中断并告知用户 |
 | 状态检查任一失败 | 终止并报告所有问题 |
 | 部分应用 worktree 创建失败 | 提示已创建的回滚清理命令 |
 | workspace 主分支 tracked 内容（openspec/、cbb/ 等） | 自动 checkout 到工作树，无需额外动作（cp/clone 都是多余的） |
-| AI 配置目录（.claude/、.qoder/ 等） | gitignore'd，不在仓库中；**Step 4 是必要步骤**，执行 `cbb init --yes` 自动安装（失败会阻塞 init-worktree） |
+| AI 配置目录（.claude/、.qoder/ 等） | gitignore'd，不在仓库中；**Step 4 是必要步骤**，执行 `cbbm init --yes` 自动安装（失败会阻塞 init-worktree） |
 | 需求名（同时作分支名和工作树目录名） | 用户在对话中纯文本输入，参考 Step 3.1 命名规则（kebab-case，禁 `..`、路径分隔符、空格） |
-| 应用选择 | 输入序号（`1,3` / `1-3` / `all`），按 `CONFIG.json` 数组顺序查行 |
+| 关联应用范围 | 固定为 `workspace-config.json` 全量 apps（无勾选）；增减应用后重跑本技能（幂等） |
 | 沙箱内 node 不可用 | 脚本 fail-fast 并提示用户到系统终端重试 |
 | push 失败（SSH/HTTPS/网络/保护） | push-branches.js 退出码 2，AI 阻塞并询问用户三选项（修复后重试/跳过失败仓库/完全终止） |
 | 远程分支已存在 | push-branches.js 输出 metadata，AI 展示 commit 元信息后询问两选项（关联/终止+重新创建） |
-| 开发过程中推送所有 worktree | Step 3.4 仅覆盖创建时的空 commit；开发过程中产生的提交必须调 `/opsx:push` 或 `openspec-push-worktrees` skill 推送（详见该 skill） |
+| 开发过程中推送所有 worktree | Step 3.4 仅覆盖创建时的空 commit；开发过程中产生的提交必须调 `/cbb:worktree-push` 或 `cbb-worktree-push` skill 推送（详见该 skill） |
 
 ---
 
 ## 常见错误
 
-### 跳过 CONFIG.json 直接硬编码仓库地址
+### 跳过 workspace-config.json 直接硬编码仓库地址
 
 - **问题：** 直接在代码中写死仓库 URL 或本地路径，不同团队的仓库地址不同
-- **修复：** 始终从 `CONFIG.json` 读取应用与远程仓库的映射，找不到配置文件时询问用户手动输入 git URL
+- **修复：** 始终从 `workspace-config.json` 读取应用与远程仓库的映射；配置缺失/为空时按 Step 0.3 配置引导处理，不支持在流程中临时指定配置外的仓库
 
 ### 状态检查对 app 仓库执行完整五项检查
 
@@ -432,7 +414,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 
 ### 忽略 .gitignore 安全验证
 
-- **问题：** `.worktrees/` 或 `.code/` 目录未被忽略，工作树或代码目录内容被 git 跟踪
+- **问题：** `.worktrees/` 或 `.codespace/` 目录未被忽略，工作树或代码目录内容被 git 跟踪
 - **修复：** 创建工作树前必须用 `git check-ignore` 验证两者均已忽略
 
 ### 未先创建分支就直接创建 worktree
@@ -450,14 +432,9 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 - **问题：** 模型误以为工作树是"凭空组装"出来的，写出 `cp`、`cp -r`、`git clone`、`ln -s` 等脚本"把主目录内容带过去"——这都是无用功
 - **修复：** workspace 主分支 tracked 的所有内容（openspec/、cbb/ 等）在 `git worktree add` 时**自动 checkout**；各应用 worktree 同理。如果准备写 cp/clone/symlink 来“带过来”代码，先停下来
 
-### label 被 AI 翻译或丢失（已从根本上解决）
-
-- **问题：** 历史版本中 Step 1.1 要求 AI 手动拼接 label 字符串，导致 `app.name` 被翻译（`ep-user-auth-app` → `智能客服Agent应用`）或完全丢失（只输出 `后端应用`）。
-- **修复：** 改为调用 `generate-app-options.js` 脚本生成 options——脚本用硬编码公式 `【sideLabel】 - app.name` 逐条生成，`app.name` 逐字符原样复制，AI 只需将脚本输出的 options 数组原样传入 `AskUserQuestion`，不允许手动修改任何字段。
-
 ### 用 AskUserQuestion 收集自由文本输入
 
-- **问题：** 需求名、应用名需要用户自由输入文本，却用了 `AskUserQuestion` 工具，被迫提供预设选项
+- **问题：** 需求名需要用户自由输入文本，却用了 `AskUserQuestion` 工具，被迫提供预设选项
 - **修复：** 自由文本输入场景一律**直接在对话中提问**并等待用户文本回复；`AskUserQuestion` 仅用于固定选项的选择场景
 
 ### 完成后未进入 worktree
@@ -473,7 +450,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 ### 远程分支已存在时自动 set-upstream
 
 - **问题：** 看到 origin/&lt;branch&gt; 已存在就直接 `git branch --set-upstream-to`，可能关联到他人的同名分支
-- **修复：** 脚本输出 metadata 后必须由用户决策（关联 vs 终止）；AI 在 AskUserQuestion 之前必须先输出 commit 元信息作为二次确认
+- **修复：** 与本地完全一致时脚本幂等跳过（`skipped`，非失败）；不一致时输出 metadata 由用户决策（关联 vs 终止）；AI 在 AskUserQuestion 之前必须先输出 commit 元信息作为二次确认
 
 ### 用 `git checkout -b` 在 push 后切分支
 
@@ -483,12 +460,12 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 ### 把脚本调用与 Shell 变量混用
 
 - **问题：** 试图在 Bash 调用中嵌套 Node 脚本与 shell 变量，导致变量解析失败
-- **修复：** 所有脚本参数（`<ws_root>`、`<app1,app2,...>`、`<branch>`）由 AI agent 在对话上下文中维护，**作为字符串参数传入脚本**，不要在 Bash 命令中拼 shell 变量
+- **修复：** 所有脚本参数（`<ws_root>`、`<branch>`）由 AI agent 在对话上下文中维护，**作为字符串参数传入脚本**，不要在 Bash 命令中拼 shell 变量
 
 ### 把 install-ai 当作可失败步骤
 
 - **问题：** 以为 worktree 创建成功就能继续工作，忽略了 Step 4 失败，导致后续 openspec-* 技能全部报"找不到 skill"
-- **修复：** Step 4 失败必须手动 `cd <wt_path> && cbb init --yes`，然后重跑 init-worktree（脚本会自动跳过已初始化的部分）
+- **修复：** Step 4 失败必须手动 `cd <wt_path> && cbbm init --yes`，然后重跑 init-worktree（脚本会自动跳过已初始化的部分）
 
 ---
 
@@ -499,10 +476,9 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 **绝不允许**
 
 - 跳过或绕过 Step 2 状态检查；状态检查失败后继续
-- workspace 仓库创建工作树前不验证 `.worktrees/` 和 `.code/` 在 `.gitignore`
+- workspace 仓库创建工作树前不验证 `.worktrees/` 和 `.codespace/` 在 `.gitignore`
 - 用 `git checkout -b` 切分支后再建 worktree（分支检出冲突）
 - 用 `AskUserQuestion` 收集自由文本（需求名 / 分支选项等）
-- **Step 1.1 手动构造 AskUserQuestion options（禁止）**——必须调用 `generate-app-options.js` 脚本生成 options，将输出原样传入 `AskUserQuestion`，不得手动拼接 label。详见 [Step 1.1](#11-读取配置并选择应用)
 - 沙箱内 node 不可用时强行继续 → 改为 fail-fast 提示用户
 - **Step 3.4 推送失败后跳过失败仓库直接继续** → 必须阻塞并询问用户决策
 - **远程分支已存在时脚本自动 set-upstream-to** → 必须由用户决策，避免关联到他人的同名分支
@@ -514,10 +490,9 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 - workspace 仓库标准检查（当前在主分支等），app 仓库轻量检查（fetch + `origin/main` 可用即可）
 - app 仓库分支从 `origin/main` 创建（`git branch <需求名> ${REMOTE}/${MAIN}`），不依赖本地主分支状态
 - 严格 Step 3.3 → Step 3.4 顺序（先统一创建分支，再统一创建 worktree；workspace 工作树先建，各应用按序补建）
-- 所有脚本调用以 `node "<WS_ROOT>\.qoder\skills\openspec-init-worktree\scripts\<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 由脚本内部从 CONFIG.json 读取），**不依赖跨调用的 cwd**
-- **Step 1.1 调用 `AskUserQuestion` 前必须由脚本生成 options**：执行 `node ".qoder/skills/openspec-init-worktree/scripts/generate-app-options.js"`，将 `APP_OPTIONS` 输出的 JSON 数组原样传入 `AskUserQuestion` options，禁止手动修改。
+- 所有脚本调用以 `node "<WS_ROOT>\.qoder\skills\cbb-worktree-init\scripts\<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 由脚本内部从 workspace-config.json 读取），**不依赖跨调用的 cwd**
 - **Step 3.4 push 步骤必须执行且插入在 create-branches.js (3.3) 之后、create-worktrees.js (3.5) 之前** — 失败时阻塞整个 init-worktree 流程
-- **Step 3.4 仅覆盖创建 worktree 时的空 commit** — 开发过程中产生的本地 commit（如 apply 任务实现）必须由用户在 worktree 中手动提交并调 `openspec-push-worktrees` 推送；不允许依赖 Step 3.4 之后的自动推送（不存在）
+- **Step 3.4 仅覆盖创建 worktree 时的空 commit** — 开发过程中产生的本地 commit（如 apply 任务实现）必须由用户在 worktree 中手动提交并调 `cbb-worktree-push` 推送；不允许依赖 Step 3.4 之后的自动推送（不存在）
 
 ---
 
@@ -526,14 +501,13 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/auto-o
 | 脚本 | 功能 | 参数 | 退出码 |
 |------|------|------|--------|
 | `check-env.js` | 环境探活 | 无 | 0/1/2 |
-| `parse-config.js` | 解析 CONFIG.json | 无 | 0/1/2 |
-| `generate-app-options.js` | 机械生成 AskUserQuestion options（杜绝翻译） | [--filter=name1,name2] | 0/1/2 |
-| `sync-repos.js` | 同步 .code/ 仓库 | ws_root, apps_json | 0/1/2 |
-| `check-repos.js` | 状态检查 | ws_root, apps_json | 0/1/2 |
+| `parse-config.js` | 解析 workspace-config.json | 无 | 0/1/2 |
+| `sync-repos.js` | 同步 .codespace/ 仓库 | ws_root | 0/1/2 |
+| `check-repos.js` | 状态检查 | ws_root | 0/1/2 |
 | `update-gitignore.js` | 安全更新 .gitignore | ws_root, branch | 0/1/2 |
 | `create-branches.js` | 创建分支 | ws_root, branch | 0/1/2 |
 | `create-worktrees.js` | 创建 worktree（含自愈清理） | ws_root, branch | 0/1/2/3 |
 | `install-ai.js` | 安装 AI 配置（**必要步骤**） | wt_path | 0/1/2 |
-| `push-branches.js` | 推送并建立 upstream（带错误归类 + 元信息采集） | ws_root, branch | 0/1/2 |
+| `push-branches.js` | 推送并建立 upstream（已一致则 skipped；带错误归类 + 元信息采集） | ws_root, branch | 0/1/2 |
 | `check-env-deep.js` | 环境健康自检（Node 版本 / npm 源 / 权限） | 无 | 0/2 |
 | `auto-open.js` | 环境感知自动打开（**新窗口**） | wt_path | 0（始终） |

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/scripts/auto-open.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 环境感知 + 自动打开 IDE/CLI
+ * cbb-worktree-init 环境感知 + 自动打开 IDE/CLI
  *
  * 用法：node auto-open.js <wt_path>
  *

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/scripts/check-env-deep.js

@@ -51,12 +51,12 @@ if (!npmPing.ok) {
   console.log('✅ npm 官方源可达（https://registry.npmjs.org）');
 }
 
-// ── 3. cbb 检测（软警告） ──
-const cbbInfo = run('cbb --version');
+// ── 3. cbbm 检测（软警告） ──
+const cbbInfo = run('cbbm --version');
 if (cbbInfo.ok) {
-  console.log('✅ cbb 已安装：' + cbbInfo.out);
+  console.log('✅ cbbm 已安装：' + cbbInfo.out);
 } else {
-  console.log('⚠️  cbb 未安装（Step 4 install-ai 会自动安装，软警告不阻塞）');
+  console.log('⚠️  cbbm 未安装（Step 4 install-ai 会自动安装，软警告不阻塞）');
 }
 
 // ── 4. .worktrees 目录可写性 ──

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/scripts/check-env.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 环境健康探活
+ * cbb-worktree-init 环境健康探活
  *
  * 提前发现 Qoder 沙箱 DLL 问题（0xc0000142）以及其他子进程启动失败。
  * 失败时输出明确错误信息并以非零退出码终止，AI agent 据此决定是否继续。
@@ -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 必须在工作空间根目录（包含 CONFIG.json）下执行');
+  console.error('   init-worktree 必须在工作空间根目录（包含 workspace-config.json）下执行');
   process.exit(2);
 }
 console.log('✅ 当前目录是 git 仓库');
@@ -61,12 +61,12 @@ if (!checks.node.ok) {
   console.log('✅ node OK:', checks.node.out);
 }
 
-// ── 选检：cbb（Step 5 才需要） ────────────────────
-checks.cbbInfo = tryExec('cbb --version');
+// ── 选检：cbbm（Step 5 才需要） ────────────────────
+checks.cbbInfo = tryExec('cbbm --version');
 if (!checks.cbbInfo.ok) {
-  console.log('ℹ️  cbb 未全局安装（Step 5 会兜底自动安装）');
+  console.log('ℹ️  cbbm 未全局安装（Step 5 会兜底自动安装）');
 } else {
-  console.log('✅ cbb OK:', checks.cbbInfo.out);
+  console.log('✅ cbbm OK:', checks.cbbInfo.out);
 }
 
 // ── 沙箱检测 ─────────────────────────────────────────

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/scripts/check-repos.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 状态检查
+ * cbb-worktree-init 状态检查
  *
  * 用法：node check-repos.js <ws_root>
  *
@@ -36,7 +36,7 @@ if (!wsRoot) {
 }
 
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, "CONFIG.json");
+  const configPath = path.join(wsRoot, "workspace-config.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("CONFIG.json missing or apps empty");
+  console.error("workspace-config.json missing or apps empty");
   process.exit(1);
 }
 
@@ -155,7 +155,7 @@ if (wsResult.ok) {
 
 // apps
 for (const app of apps) {
-  const appPath = path.join(wsRoot, ".code", app.name);
+  const appPath = path.join(wsRoot, ".codespace", app.name);
   const r = checkRepo(appPath, app.name, "app");
   results.push(r);
   if (r.ok) {

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/scripts/create-branches.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 分支创建
+ * cbb-worktree-init 分支创建
  *
  * Usage: node create-branches.js <ws_root> <branch>
  */
@@ -18,7 +18,7 @@ if (!wsRoot || !branch) {
 }
 
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, 'CONFIG.json');
+  const configPath = path.join(wsRoot, 'workspace-config.json');
   if (!fs.existsSync(configPath)) return null;
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
@@ -28,7 +28,7 @@ function loadAppsFromConfig() {
 
 const apps = loadAppsFromConfig();
 if (!apps) {
-  console.error('CONFIG.json missing or apps empty');
+  console.error('workspace-config.json missing or apps empty');
   process.exit(1);
 }
 
@@ -71,7 +71,7 @@ if (wsCheck.ok && wsCheck.out) {
 
 // apps: create from origin/main
 for (const app of apps) {
-  const appPath = path.join(wsRoot, '.code', app.name);
+  const appPath = path.join(wsRoot, '.codespace', app.name);
   const appCheck = tryExec('git branch --list "' + branch + '"', appPath);
   if (appCheck.ok && appCheck.out) {
     console.log('Skip ' + app.name + ': branch exists, reuse');