@jspg-ai/coding-bb 0.0.2-beta.29 → 0.0.3-beta.12

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

@@ -1,12 +1,6 @@
 ---
 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:
-  author: Contributors
-  version: "2.0"
-  generatedBy: coding-bb
 ---
 
 # Init Worktree（跨平台脚本化版本 v2.0）
@@ -28,13 +22,18 @@ metadata:
 
 ## 调用脚本的统一方式
 
-**重要**：所有脚本必须用**绝对路径**调用。`./scripts/...` 相对路径在 Qoder 沙箱中不适用（AI agent 的 cwd 不一定是技能目录）。
+**重要**：本技能的所有脚本位于**本 SKILL.md 所在目录的 `scripts/` 下**（skill 目录）。
 
-调用方式（推荐用绝对路径）：
-```
-node "D:\workspace\<用户工作空间>\.qoder\skills\cbb-worktree-init\scripts\<name>.js" <参数>
+调用时用**本技能目录的绝对路径**拼接脚本名（AI 读取本 SKILL.md 时即已知该目录），例如：
+
+```bash
+node "<skill_dir>/scripts/<name>.js" <参数>
 ```
 
+> - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `workspace-config.json` 与 git 仓库
+> - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
+
 脚本输出：
 - 人类可读报告（OK / FAIL / WARN）
 - 机器可读摘要（末行以 XXX_OK / XXX_FAILED / XXX_RESULT 开头）
@@ -54,20 +53,20 @@ node "D:\workspace\<用户工作空间>\.qoder\skills\cbb-worktree-init\scripts\
 ### 0.1 环境健康探活
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-env.js"
+node "<skill_dir>/scripts/check-env.js"
 ```
 
 **解读输出**：
 - 退出码 0 + 末行 `ENV_OK {...}` → 探活通过，继续
-- 退出码 1 → git 不可用（沙箱 DLL 问题），**终止流程，提示用户到系统终端重试**
+- 退出码 1 → git 不可用（运行环境 DLL 问题），**终止流程，提示用户到系统终端重试**
 - 退出码 2 → 当前不在 git 仓库，**终止流程，提示用户到工作空间根目录**
 
 ### 0.1.5 环境健康自检（check-env-deep）
 
-提前检测网络/权限/版本问题，把可能在 Step 3.4 push 或 Step 4 install-ai 暴露的失败前移到流程最开始：
+提前检测权限/版本问题，把可能在后续步骤暴露的失败前移到流程最开始：
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-env-deep.js"
+node "<skill_dir>/scripts/check-env-deep.js"
 ```
 
 **解读输出**：
@@ -76,14 +75,12 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-env-d
 
 **检测项**：
 - Node.js >= 16.7.0
-- npm 官方源可达（`https://registry.npmjs.org`）
-- cbb 是否已安装（未安装仅警告，由 Step 4 自动安装）
 - `.worktrees/` 目录可写
 
 ### 0.2 读取并校验 workspace-config.json
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/parse-config.js"
+node "<skill_dir>/scripts/parse-config.js"
 ```
 
 **解读输出**：
@@ -150,7 +147,7 @@ worktree 需要知道要关联哪些应用仓库。
 
 ```bash
 # ws_root 来自 AI agent 维护的状态
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/sync-repos.js" "<ws_root>"
+node "<skill_dir>/scripts/sync-repos.js" "<ws_root>"
 ```
 
 **用法**：
@@ -194,7 +191,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/sync-repos.
 | 当前在主分支上 | ✅ | ❌ |
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-repos.js" "<ws_root>"
+node "<skill_dir>/scripts/check-repos.js" "<ws_root>"
 ```
 
 **解读输出**：
@@ -222,21 +219,23 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-repos
 ### 3.2 安全更新 .gitignore（前置）
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/update-gitignore.js "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/update-gitignore.js" "<ws_root>" "<branch>"
 ```
 
-脚本内部自动完成：stash 保护 → 切分支 → 添加 `.worktrees/` 和 `.codespace/` → 提交 → 切回 → pop stash
+脚本内部自动完成：stash 保护 → 分支不存在则从 HEAD 创建 → 切分支 → 添加 `.worktrees/` 和 `.codespace/` → 提交 → 切回 → pop stash
 
 **解读输出**：
 - 退出码 0 + 末行 `GITIGNORE_OK` → 成功
 - 退出码 2 → 执行失败，**终止流程**
 
-> ⚠️ 必须在提交后切回主分支，否则 Step 3.4 的 `git worktree add` 会因分支已检出而失败（脚本已自动处理）。
+> ⓘ **分支自动创建**：本步骤先于 Step 3.3 执行，workspace 分支此时不存在，脚本会自动从 HEAD 创建（与 `create-branches.js` 对 workspace 的行为一致，Step 3.3 报 `reused`）。`.gitignore` 提交正好落在需求分支上，由 Step 3.4 push 一并推送。
+
+> ⚠️ 必须在提交后切回主分支，否则 Step 3.5 的 `git worktree add` 会因分支已检出而失败（脚本已自动处理）。
 
 ### 3.3 创建分支
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/create-branches.js" "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/create-branches.js" "<ws_root>" "<branch>"
 ```
 
 **解读输出**：
@@ -261,7 +260,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/create-bran
 ### 3.4 推送并建立 upstream
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/push-branches.js" "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/push-branches.js" "<ws_root>" "<branch>"
 ```
 
 脚本内部自动完成：
@@ -286,20 +285,20 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/push-branch
 
 **为什么 push 放在 worktree 之前：** 失败早暴露，无 worktree 损失；成功后再创建 worktree，分支天然有 upstream；独立脚本便于单测。
 
-### 3.5 创建 Worktree（含自愈清理）
+### 3.5 创建 Worktree
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/create-worktrees.js" "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/create-worktrees.js" "<ws_root>" "<branch>"
 ```
 
 脚本内部自动完成：
-1. **自愈清理**：`git worktree prune` + 物理目录清理（close 因 IDE 锁未能删除的物理目录）
+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 内）
 
 **解读输出**：
-- 退出码 0 + 末行 `WT_PATH <绝对路径>` → 全部成功，AI 解析出 worktree 绝对路径供后续 Step 4/5 使用
-- 退出码 2 → workspace worktree 创建失败（分支已检出/权限不足），**终止流程**
+- 退出码 0 + 末行 `WT_PATH <绝对路径>` → 全部成功，AI 解析出 worktree 绝对路径供后续 Step 4 使用
+- 退出码 2 → workspace worktree 创建失败（分支已检出/权限不足），或目标目录存在但非有效 worktree（上次 close 被 IDE 锁残留）——**终止流程**，按脚本提示引导用户跑 `cbb-worktree-close` 或手动删除该目录 + `git worktree prune` 后重跑
 - 退出码 3 → 部分 app worktree 创建失败，**报告已创建/失败详情，用户需手动清理**
 
 **报告示例**：
@@ -313,52 +312,38 @@ 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 内执行 `cbbm init -y` 安装 AI 配置，无需依赖用户手动配置。
+> ⓘ **AI 配置目录（.claude/、.qoder/、.opencode/ 等）**：统一安装在业务空间根（`cbb setup` / `cbb update`），**worktree 内不安装**；AI 会话始终以空间根为基础，开发动作指向本 worktree 路径。
 
 ---
 
-## Step 4：安装 AI 配置（必要步骤）
-
-workspace 主分支的 `.claude/` `.qoder/` `.cbb/` 通常为 gitignore'd，创建 worktree 时不会自动带入。
-**本步骤在 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/cbb-worktree-init/scripts/install-ai.js "<wt_path>"
-```
+## Step 4：收尾与交接（必要步骤）
 
-**解读输出**：
-- 退出码 0 + 末行 `AI_INIT_OK` → 成功，继续 Step 5
-- 退出码 1 → 参数错误（脚本 bug）
-- 退出码 2 + 末行 `AI_INIT_FAILED` → cbbm init 执行失败，**init-worktree 中断**，
-  按错误提示手动执行 `cd "<wt_path>" && cbbm init --yes` 后重跑
+不执行脚本。AI agent 向用户输出最终报告（格式见「最终报告」），并完成以下交接声明：
 
-> `-y` 表示非交互模式：默认选中所有适配器、前置依赖未安装时自动继续，适合 skill 自动化执行。
+1. **继续在当前会话开发**：本技能不打开新窗口；需求工作目录为 `<wt_path>`
+2. **目录纪律**：本会话后续所有产生写操作的命令（git commit / openspec / 构建 / 测试等）必须以 `<wt_path>`（或其应用子目录）为工作目录（显式 `cd` 或绝对路径）；**禁止在空间根（主分支）执行任何写操作**
+3. 不自动安装依赖：各仓库技术栈不一（Maven 依赖本机 `~/.m2` 全局共享、无需初始化；Node/Python 等由你进入 worktree 后执行正确的命令，如 `npm ci` / `pnpm`）
+4. **输出下一步建议**：最终报告必须包含「下一步建议」段（格式见「最终报告」），告知用户后续可走的流程；仅提示，不自动串联执行任何后续技能
 
 ---
 
-## Step 5：环境收尾
+## 最终报告
 
-所有步骤完成后，检测当前运行环境，**在新窗口打开 IDE** 并定位到 workspace worktree 目录。
+最终报告格式：
 
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.js "<wt_path>"
+```
+✅ worktree 已创建：<wt_path>
+   关联应用：<应用名 → 嵌套路径> 列表
+📌 继续在当前会话开发：后续写操作命令一律以上述目录为工作目录
+👉 下一步建议：
+   1. 开始需求开发（二选一）：
+      - 走 OpenSpec 工作流：/opsx:propose → /opsx:apply → /opsx:verify → /opsx:archive
+      - 或直接对话开发：把需求告诉我，在 <wt_path> 内实现
+   2. 开发中提交推送：说"提交并推送"（cbb-worktree-push）
+   3. 需求完成后：说"关闭工作空间"（cbb-worktree-close）
 ```
 
-**解读末行**：
-- `ENV=QODER_GUI` / `CURSOR_GUI` / `VSCODE_GUI` / `JETBRAINS_GUI` → GUI 模式（已在新窗口打开 IDE）
-- `ENV=CLI` → CLI 模式（AI agent 自行 cd 到 wt_path）
-- `OPEN_FAILED` → 自动打开失败，提示用户手动操作
-
----
-
-## 最终报告
-
-最终报告由 AI agent 根据 `auto-open.js` 的末行输出生成，格式同 v1（GUI / CLI / OPEN_FAILED 三种）。
-
-> 不自动安装依赖：各仓库技术栈不一（Maven 依赖本机 `~/.m2` 全局共享、无需初始化；Node/Python 等由你进入 worktree 后执行正确的命令，如 `npm ci` / `pnpm`）。猜测安装命令易出错，故不在本步骤处理。
+> 若 Step 3.5 为部分失败（退出码 3），报告必须列出已创建/失败详情与回滚清理命令。
 
 ---
 
@@ -370,7 +355,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.j
 |------|----------|
 | 空间新增了应用（编辑 `workspace-config.json` 后） | Step 1 拉取新应用代码 → Step 3.3 为新应用建分支 → Step 3.4 推送（已一致的分支 `skipped`，不一致则阻塞询问）→ Step 3.5 创建缺失的嵌套 worktree |
 | 上次 init 中途失败 | 已存在的分支 / worktree 自动复用，`.gitignore` 处理自动跳过，仅补齐缺失部分 |
-| 应用从 config 移除 | 已创建的分支 / worktree **不会**自动删除；如需清理用 `/cbb:worktree-close` 关闭后重建 |
+| 应用从 config 移除 | 已创建的分支 / worktree **不会**自动删除；如需清理用 `cbb-worktree-close` skill 关闭后重建 |
 
 > ⓘ 重跑**不会静默推送**开发中的本地提交：远程分支已存在但与本地不一致时，Step 3.4 走阻塞式 `remote-exists` 决策（展示 commit 元信息让用户选择）。
 
@@ -381,17 +366,17 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.j
 | 场景 | 处理方式 |
 |------|----------|
 | `.worktrees/` 或 `.codespace/` 未在 `.gitignore` | workspace 仓库自动添加并提交（在 Step 3.2） |
-| `git worktree add` 权限被拒 | 沙箱降级，中断并告知用户 |
+| `git worktree add` 权限被拒 | 运行环境降级，中断并告知用户 |
 | 状态检查任一失败 | 终止并报告所有问题 |
 | 部分应用 worktree 创建失败 | 提示已创建的回滚清理命令 |
 | workspace 主分支 tracked 内容（openspec/、cbb/ 等） | 自动 checkout 到工作树，无需额外动作（cp/clone 都是多余的） |
-| AI 配置目录（.claude/、.qoder/ 等） | gitignore'd，不在仓库中；**Step 4 是必要步骤**，执行 `cbbm init --yes` 自动安装（失败会阻塞 init-worktree） |
+| AI 配置目录（.claude/、.qoder/、.opencode/ 等） | 统一安装在空间根（`cbb setup` / `cbb update`）；worktree 内不安装、也不需要 |
 | 需求名（同时作分支名和工作树目录名） | 用户在对话中纯文本输入，参考 Step 3.1 命名规则（kebab-case，禁 `..`、路径分隔符、空格） |
 | 关联应用范围 | 固定为 `workspace-config.json` 全量 apps（无勾选）；增减应用后重跑本技能（幂等） |
-| 沙箱内 node 不可用 | 脚本 fail-fast 并提示用户到系统终端重试 |
+| 运行环境 node 不可用 | 脚本 fail-fast 并提示用户到系统终端重试 |
 | push 失败（SSH/HTTPS/网络/保护） | push-branches.js 退出码 2，AI 阻塞并询问用户三选项（修复后重试/跳过失败仓库/完全终止） |
 | 远程分支已存在 | push-branches.js 输出 metadata，AI 展示 commit 元信息后询问两选项（关联/终止+重新创建） |
-| 开发过程中推送所有 worktree | Step 3.4 仅覆盖创建时的空 commit；开发过程中产生的提交必须调 `/cbb:worktree-push` 或 `cbb-worktree-push` skill 推送（详见该 skill） |
+| 开发过程中推送所有 worktree | Step 3.4 仅覆盖创建时的空 commit；开发过程中产生的提交必须调 `cbb-worktree-push` skill 推送（详见该 skill） |
 
 ---
 
@@ -462,10 +447,10 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.j
 - **问题：** 试图在 Bash 调用中嵌套 Node 脚本与 shell 变量，导致变量解析失败
 - **修复：** 所有脚本参数（`<ws_root>`、`<branch>`）由 AI agent 在对话上下文中维护，**作为字符串参数传入脚本**，不要在 Bash 命令中拼 shell 变量
 
-### 把 install-ai 当作可失败步骤
+### 在空间根执行写操作命令
 
-- **问题：** 以为 worktree 创建成功就能继续工作，忽略了 Step 4 失败，导致后续 openspec-* 技能全部报"找不到 skill"
-- **修复：** Step 4 失败必须手动 `cd <wt_path> && cbbm init --yes`，然后重跑 init-worktree（脚本会自动跳过已初始化的部分）
+- **问题：** worktree 创建成功后，会话仍在空间根运行 git commit / openspec / 构建命令，污染主分支或把变更产物生成在主分支上
+- **修复：** Step 4 交接已声明需求工作目录 `<wt_path>`；所有写操作命令必须显式 `cd` 或用绝对路径指向 worktree
 
 ---
 
@@ -479,18 +464,18 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.j
 - workspace 仓库创建工作树前不验证 `.worktrees/` 和 `.codespace/` 在 `.gitignore`
 - 用 `git checkout -b` 切分支后再建 worktree（分支检出冲突）
 - 用 `AskUserQuestion` 收集自由文本（需求名 / 分支选项等）
-- 沙箱内 node 不可用时强行继续 → 改为 fail-fast 提示用户
+- 运行环境 node 不可用时强行继续 → 改为 fail-fast 提示用户
 - **Step 3.4 推送失败后跳过失败仓库直接继续** → 必须阻塞并询问用户决策
 - **远程分支已存在时脚本自动 set-upstream-to** → 必须由用户决策，避免关联到他人的同名分支
 - **AI 询问关联选项前不输出 commit 元信息** → 必须先在 AskUserQuestion 之前输出远程 hash/author/date/message + 本地 hash
-- **Step 4 install-ai 失败时强行继续** → 必须阻塞并按错误提示恢复，AI 不得绕过退出码 2 继续执行
+- **在空间根执行 git/openspec/构建等写操作命令** → 必须显式指定需求工作树路径（`<wt_path>` 或其应用子目录）
 
 **必须执行**
 
 - 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\cbb-worktree-init\scripts\<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 由脚本内部从 workspace-config.json 读取），**不依赖跨调用的 cwd**
+- 所有脚本调用以 `node "<skill_dir>/scripts/<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 由脚本内部从 workspace-config.json 读取）；**执行时 cwd 保持在工作空间根**（`check-env.js` / `parse-config.js` 按 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 中手动提交并调 `cbb-worktree-push` 推送；不允许依赖 Step 3.4 之后的自动推送（不存在）
 
@@ -506,8 +491,6 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.j
 | `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 |
+| `create-worktrees.js` | 创建 worktree（仅 prune 元数据，不删物理目录） | ws_root, branch | 0/1/2/3 |
 | `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（始终） |
+| `check-env-deep.js` | 环境健康自检（Node 版本 / 权限） | 无 | 0/2 |

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

@@ -7,26 +7,15 @@ require('./silence-popup');
  *
  * 检测项：
  *   1. Node.js 版本（>= 16.7.0）
- *   2. npm 官方源可达性（https://registry.npmjs.org）
- *   3. cbb 是否已安装（未安装视为软警告，由 Step 4 自动安装）
- *   4. .worktrees/ 目录可写性
+ *   2. .worktrees/ 目录可写性
  *
  * 退出码：
  *   0 - 全部通过（DOCTOR_OK）
- *   2 - 致命问题（Node 版本 / npm 源 / 权限），必须修复后重试
+ *   2 - 致命问题（Node 版本 / 权限），必须修复后重试
  */
-const { execSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
-function run(cmd) {
-  try {
-    return { ok: true, out: execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim() };
-  } catch (e) {
-    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
-  }
-}
-
 let hasFatal = false;
 
 // ── 1. Node.js 版本 ──
@@ -40,26 +29,7 @@ if (nodeMajor < 16 || (nodeMajor === 16 && parseInt(nodeVersion.split('.')[1], 1
   console.log('✅ Node.js: ' + nodeVersion);
 }
 
-// ── 2. npm 内部源可达性 ──
-const npmPing = run('npm ping --registry=https://registry.npmjs.org');
-if (!npmPing.ok) {
-  console.error('❌ npm 内部源不可达：' + npmPing.err);
-  console.error('   → 检查代理设置：npm config get registry');
-  console.error('   → 检查网络是否能访问 https://registry.npmjs.org');
-  hasFatal = true;
-} else {
-  console.log('✅ npm 官方源可达（https://registry.npmjs.org）');
-}
-
-// ── 3. cbbm 检测（软警告） ──
-const cbbInfo = run('cbbm --version');
-if (cbbInfo.ok) {
-  console.log('✅ cbbm 已安装：' + cbbInfo.out);
-} else {
-  console.log('⚠️  cbbm 未安装（Step 4 install-ai 会自动安装，软警告不阻塞）');
-}
-
-// ── 4. .worktrees 目录可写性 ──
+// ── 2. .worktrees 目录可写性 ──
 const wsRoot = process.cwd();
 const wtDir = path.join(wsRoot, '.worktrees');
 try {

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

@@ -3,7 +3,7 @@ require('./silence-popup');
 /**
  * cbb-worktree-init 环境健康探活
  *
- * 提前发现 Qoder 沙箱 DLL 问题（0xc0000142）以及其他子进程启动失败。
+ * 提前发现 Agent 运行环境 DLL 问题（0xc0000142）以及其他子进程启动失败。
  * 失败时输出明确错误信息并以非零退出码终止，AI agent 据此决定是否继续。
  *
  * 跨平台：
@@ -38,7 +38,7 @@ const checks = {};
 checks.git = tryExec('git --version');
 if (!checks.git.ok) {
   console.error('❌ git 启动失败');
-  console.error('   可能是 Qoder 沙箱 DLL 问题（0xc0000142）');
+   console.error('   可能是 Agent 运行环境 DLL 问题（0xc0000142）');
   console.error('   解决方案：到系统终端（非 Qoder AI 终端）重新执行本技能');
   process.exit(1);
 }
@@ -61,27 +61,18 @@ if (!checks.node.ok) {
   console.log('✅ node OK:', checks.node.out);
 }
 
-// ── 选检：cbbm（Step 5 才需要） ────────────────────
-checks.cbbInfo = tryExec('cbbm --version');
-if (!checks.cbbInfo.ok) {
-  console.log('ℹ️  cbbm 未全局安装（Step 5 会兜底自动安装）');
-} else {
-  console.log('✅ cbbm OK:', checks.cbbInfo.out);
-}
-
-// ── 沙箱检测 ─────────────────────────────────────────
+// ── 运行环境检测 ───────────────────────────────────────
 const inWorktree = !!(process.env.QODER_AGENT || process.env.QODER_WORKTREE);
 if (inWorktree) {
-  console.log('🛡️  Qoder 沙箱环境：若后续 node/git DLL 错误，请到系统终端重试');
+  console.log('🛡️  Qoder Agent 运行环境：若后续 node/git DLL 错误，请到系统终端重试');
 } else {
-  console.log('✅ 非沙箱环境：所有子进程以默认 PATH 运行');
+  console.log('✅ 系统终端环境：所有子进程以默认 PATH 运行');
 }
 
 // 输出机器可读摘要（AI agent 可解析）
 const summary = {
   git: checks.git.ok,
   node: checks.node.ok,
-  cbbInfo: checks.cbbInfo.ok,
   inWorktree,
   ok: true,
 };

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

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * cbb-worktree-init 创建 Worktree（含自愈清理）
+ * cbb-worktree-init 创建 Worktree（自愈清理仅限元数据 prune）
  *
  * 用法：node create-worktrees.js <ws_root> <branch>
  *   （apps 由脚本内部从 <ws_root>/workspace-config.json 读取）
  *
  * 行为：
- *   1. 自愈清理：prune + 物理目录清理
+ *   1. 自愈清理：仅 git worktree prune（元数据），**绝不删除任何物理目录**
+ *      （0.0.3-beta.11 事故修复：旧版按"不在 worktree list"负向推断递归删残留目录，
+ *        Windows 下 git 输出正斜杠路径与 realpathSync 反斜杠永不匹配，误删活跃 worktree）
  *   2. workspace worktree 创建（.worktrees/worktree-<branch>）
  *   3. 各 app worktree 创建（物理嵌套在 workspace worktree 内）
  *   4. 失败时输出回滚提示
@@ -15,7 +17,7 @@ require('./silence-popup');
  * 退出码：
  *   0 - 全部成功
  *   1 - 参数错误
- *   2 - workspace worktree 创建失败
+ *   2 - workspace worktree 创建失败（含目标目录存在但非有效 worktree 的残留场景）
  *   3 - 部分 app worktree 创建失败
  */
 
@@ -54,52 +56,28 @@ function run(cmd, cwd) {
   }
 }
 
-// 1. 自愈清理
-console.log('=== 自愈清理 ===');
+// 1. 自愈清理（仅元数据：prune 只清理"目录已缺失/失效"的 worktree 注册项，不碰物理目录）
+console.log('=== 自愈清理（仅 prune 元数据，不删物理目录）===');
 
-// 1.1 prune 所有仓库
 const allRepos = [wsRoot, ...apps.map(a => path.join(wsRoot, '.codespace', a.name))];
 for (const repo of allRepos) {
   if (fs.existsSync(repo)) {
     run('git worktree prune', repo);
   }
 }
-console.log('✅ 已 prune 所有仓库的 worktree 元数据');
-
-// 1.2 清理 .worktrees/ 下无元数据的物理目录
-const worktreesDir = path.join(wsRoot, '.worktrees');
-if (fs.existsSync(worktreesDir)) {
-  const validWts = run('git worktree list --porcelain', wsRoot);
-  const validPaths = new Set();
-  if (validWts.ok) {
-    validWts.out.split('\n').forEach(line => {
-      if (line.startsWith('worktree ')) {
-        validPaths.add(line.substring(9).trim());
-      }
-    });
-  }
-
-  const entries = fs.readdirSync(worktreesDir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const dir = path.join(worktreesDir, entry.name);
-    let absDir;
-    try { absDir = fs.realpathSync(dir); } catch { continue; }
-    if (!validPaths.has(absDir)) {
-      try {
-        fs.rmSync(dir, { recursive: true, force: true });
-        console.log('🧹 已清理残留目录：' + entry.name);
-      } catch (e) {
-        console.log('⏳ 残留目录仍被占用，跳过：' + entry.name);
-      }
-    }
-  }
-}
+console.log('✅ 已 prune 所有仓库的 worktree 元数据（物理目录一律保留）');
 
 // 2. workspace worktree 创建
 console.log('=== 创建 Workspace Worktree ===');
 const wtDir = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
 if (fs.existsSync(wtDir)) {
+  if (!fs.existsSync(path.join(wtDir, '.git'))) {
+    console.error('❌ 目标目录已存在但不是有效 worktree（缺 .git 指针）：' + wtDir);
+    console.error('   可能是上次 close / init 中断的残留。本脚本不会自动删除任何目录，请二选一后重跑：');
+    console.error('   1) 执行 cbb-worktree-close 技能清理该需求');
+    console.error('   2) 手动删除上述目录后执行：git -C "' + wsRoot + '" worktree prune');
+    process.exit(2);
+  }
   console.log('⏭️  workspace worktree 已存在，复用：' + wtDir);
 } else {
   const created = run('git worktree add ".worktrees/worktree-' + branch + '" "' + branch + '"', wsRoot);

package/cbb/worktrees/skills/cbb-worktree-init/scripts/update-gitignore.js

@@ -6,13 +6,13 @@ require('./silence-popup');
  * 用法：node update-gitignore.js <ws_root> <branch>
  *
  * 行为：
- *   1. stash 当前未提交修改
- *   2. 切换到目标分支
- *   3. 检查 .worktrees/ 和 .codespace/ 是否在 .gitignore
- *   4. 添加缺失条目
- *   5. 提交 .gitignore
- *   6. 切回原分支
- *   7. pop stash（如有）
+ *   1. stash 当前未提交修改（仅 untracked 时不产生 stash）
+ *   2. 目标分支不存在则从 HEAD 创建（首跑时分支尚未由 create-branches.js 建立，
+ *      顺序无关自愈；create-branches.js 后续会报 reused）
+ *   3. 切换到目标分支
+ *   4. 检查 .worktrees/ 和 .codespace/ 是否在 .gitignore，缺失则添加并提交
+ *   5. 切回原分支
+ *   6. pop stash（如有）
  *
  * 幂等：目标分支已在某个 worktree 中检出（init-worktree 重跑场景，上次已处理过
  * .gitignore）时，跳过全部操作直接输出 GITIGNORE_OK——避免 checkout 与 worktree 检出冲突。
@@ -67,8 +67,12 @@ const status = run('git status --porcelain', wsRoot);
 if (status.ok && status.out) {
   const stash = run('git stash push -m "init-worktree-temp"', wsRoot);
   if (stash.ok) {
-    stashed = true;
-    console.log('✅ 已 stash 未提交修改');
+    if (/No local changes to save/.test(stash.out)) {
+      console.log('ℹ️  仅 untracked 文件，无需 stash');
+    } else {
+      stashed = true;
+      console.log('✅ 已 stash 未提交修改');
+    }
   } else {
     console.error('❌ git stash 失败：' + stash.err);
     process.exit(2);
@@ -77,6 +81,18 @@ if (status.ok && status.out) {
   console.log('ℹ️  无未提交修改，跳过 stash');
 }
 
+// 2.1 目标分支不存在则从 HEAD 创建（Step 3.2 先于 Step 3.3 执行时分支尚未建立）
+const branchList = run('git branch --list "' + branch + '"', wsRoot);
+if (branchList.ok && !branchList.out) {
+  const create = run('git branch "' + branch + '"', wsRoot);
+  if (!create.ok) {
+    console.error('❌ 创建分支 ' + branch + ' 失败：' + create.err);
+    if (stashed) run('git stash pop', wsRoot);
+    process.exit(2);
+  }
+  console.log('✅ 分支 ' + branch + ' 不存在，已从 HEAD 创建');
+}
+
 // 3. 切换到目标分支
 const checkout = run('git checkout "' + branch + '"', wsRoot);
 if (!checkout.ok) {