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

package/cbb/worktrees/commands/extend.md

@@ -1,65 +0,0 @@
----
-name: "OPSX: Extend"
-description: 为已存在的 worktree（init-worktree 创建的工作空间）补加关联应用，添加嵌套 worktree，不影响现有开发
-category: Workflow
-tags: [worktree, extend, worktree, git-worktree, add-app]
----
-
-# OPSX: Extend - 补加应用到现有 Worktree
-
-## 重要：第一步必须用 Read 工具直接打开 SKILL.md
-
-**禁止**用 `ls` / `find` / `cat` / `head` / `grep` 等 bash 命令搜索 SKILL.md。这些命令在 Qoder Windows PowerShell 沙箱中经常失败。
-
-**直接路径**：
-- Qoder 适配器：`.qoder/skills/openspec-extend-worktree/SKILL.md`
-- Claude Code 适配器：`.claude/skills/openspec-extend-worktree/SKILL.md`
-
-**第一步**：
-1. 用 Read 工具直接打开 SKILL.md
-2. 按 SKILL.md 的 Step 0 → 1 → 2 → 3 → 4 → 5 顺序执行
-3. 每次调用 Node.js 脚本时使用**绝对路径**
-
-## Input
-
-无必需参数。
-
-- 未指定时自动识别目标 worktree：cwd 在 worktree 内则反推需求名；唯一 worktree 时自动选用；多个时按 SKILL.md Step 0.2 在对话中提问
-- 也可在斜杠命令后直接传 `<需求名>`（kebab-case），与已有 worktree 匹配则使用
-
-**Steps 概述**（完整流程见 SKILL.md）
-
-1. Step 0：前置校验（向上查找 CONFIG.json + cwd 反推需求名 + 校验目标 worktree 存在）
-2. Step 1：选择要补加的应用（CONFIG.json 减去已关联 → AskUserQuestion multiSelect）
-3. Step 2：状态检查（仅对新增应用，workspace 跳过）
-4. Step 3：创建分支 + 嵌套 worktree（仅对新增应用，分支已存在则复用）
-5. Step 4：在新增 worktree 中执行 `cbb init -y`（`.cbb/.managed-by-cbb` 判重）
-6. Step 5：报告扩展前后对比（**不切 IDE 窗口**，用户留在原 worktree）
-
-**Output**
-
-```
-✅ worktree 已扩展
-  目标 worktree:  <需求名>
-  工作空间根:    <WS_ROOT>
-  当前目录:      <cwd>
-  补加应用:
-    - ep-user-info-server  → .worktrees/<需求名>/ep-user-info-server
-    - ep-user-web          → .worktrees/<需求名>/ep-user-web
-  AI 配置:       ✅ 已安装（新建）/ 跳过（已存在）
-  已存在的关联应用（本次未变）：
-    - ep-user-auth-app
-```
-
-详细输出格式与失败回滚命令，见 SKILL.md「最终报告」与「常见错误」段。
-
-**Guardrails**
-
-- **目标 worktree 必须已存在**（`.worktrees/<需求名>/` 必须存在），否则提示用 init-worktree
-- **不重建、修改、删除任何已存在的 worktree**——只增量添加
-- 嵌套 worktree 路径与 init-worktree 完全一致：`.worktrees/<需求名>/<应用名>/`
-- 分支名与 init-worktree 一致：`<需求名>`（不加前缀）
-- 仅对待补加应用执行状态检查、clone/fetch、创建分支、worktree add
-- **不切 IDE 窗口**——用户在原 worktree 继续开发，扩展的工作是嵌套子目录
-- 自由文本输入（需求名、应用 URL）禁止使用 `AskUserQuestion`，仅在固定选项场景（应用多选）使用
-- 必须单次 Bash 调用合并 `cd "..." && ...`，不依赖跨调用的 cwd

package/cbb/worktrees/skills/openspec-close-worktree/scripts/find-target-worktree.js

@@ -1,96 +0,0 @@
-require('./silence-popup');
-/**
- * openspec-shared 目标需求名识别
- *
- * 唯一真源：cbb/worktrees/_shared/scripts/find-target-worktree.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（extend / close / push）。
- *
- * 用法：node find-target-worktree.js <ws_root>
- *
- * 优先级：
- *   1. cwd 在 .worktrees/worktree-xxx/ 内 → 自动从路径反推
- *   2. .worktrees/ 下只有一个 worktree → 自动选用
- *   3. 多个 worktree → 按 mtime 倒序，第一个为推荐
- *
- * 输出：
- *   末行输出需求名（用于 AI agent 解析）
- *   多个时按 [1] xxx ⭐ / [2] yyy 列出
- *
- * 退出码：
- *   0 - 唯一识别（自动或唯一）
- *   1 - 多个 worktree，需用户输入
- *   2 - 无 worktree
- */
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const wsRoot = process.argv[2];
-
-if (!wsRoot) {
-  console.error('❌ 用法：node find-target-worktree.js <ws_root>');
-  process.exit(1);
-}
-
-// 优先级 1：cwd 反推
-const cwd = process.cwd();
-const cwdMatch = cwd.match(/\.worktrees[\\\/]worktree-([^\\\/]+)/);
-if (cwdMatch) {
-  const branch = cwdMatch[1];
-  console.log('✅ 从 cwd 反推需求名：' + branch);
-  console.log('---');
-  console.log(branch);
-  process.exit(0);
-}
-
-const worktreesDir = path.join(wsRoot, '.worktrees');
-if (!fs.existsSync(worktreesDir)) {
-  console.error('❌ .worktrees 目录不存在：' + worktreesDir);
-  console.error('   请先执行 openspec-init-worktree 创建 worktree');
-  console.log('---');
-  console.log('NO_WORKTREE');
-  process.exit(2);
-}
-
-// 列出所有 worktree-xxx 目录
-const entries = fs.readdirSync(worktreesDir, { withFileTypes: true })
-  .filter(e => e.isDirectory() && e.name.startsWith('worktree-'))
-  .map(e => ({
-    name: e.name.substring('worktree-'.length),
-    fullName: e.name,
-    path: path.join(worktreesDir, e.name),
-    mtime: fs.statSync(path.join(worktreesDir, e.name)).mtime.getTime(),
-  }));
-
-if (entries.length === 0) {
-  console.error('❌ 未找到任何 worktree');
-  console.error('   请先执行 openspec-init-worktree 创建 worktree');
-  console.log('---');
-  console.log('NO_WORKTREE');
-  process.exit(2);
-}
-
-// 优先级 2：唯一
-if (entries.length === 1) {
-  console.log('✅ 自动选用唯一 worktree：' + entries[0].name);
-  console.log('---');
-  console.log(entries[0].name);
-  process.exit(0);
-}
-
-// 优先级 3：多个 → 按 mtime 倒序
-entries.sort((a, b) => b.mtime - a.mtime);
-
-console.log('⚠️  检测到 ' + entries.length + ' 个 worktree（按最近修改排序）：');
-entries.forEach((e, i) => {
-  if (i === 0) {
-    console.log('  [' + (i + 1) + '] ' + e.name + '  ⭐ (推荐：最近修改)');
-  } else {
-    console.log('  [' + (i + 1) + '] ' + e.name);
-  }
-});
-console.log('请在对话中输入序号(1/2/3)或完整分支名：');
-console.log('---');
-console.log('MULTIPLE_WORKTREEES');
-process.exit(1);

package/cbb/worktrees/skills/openspec-extend-worktree/SKILL.md

@@ -1,390 +0,0 @@
----
-name: openspec-extend-worktree
-description: "为已有 worktree 补加关联应用：创建新分支、嵌套 worktree，不重建已有 worktree。触发：用户明确说补加应用/漏选了/加新应用。禁止在 openspec-init-worktree 执行后自动调用——只有用户主动要求补加时才触发。"
-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
----
-
-# Extend Worktree（跨平台脚本化版本 v2.0）
-
-为已存在的 worktree（由 `openspec-init-worktree` 创建）补加关联应用：在工作空间根目录和各 app 仓库中创建/复用同名需求分支，在 `.worktrees/worktree-<需求名>/` 下添加嵌套 worktree，并安装 AI 配置。当你已经在某个 worktree 内开发中途发现漏选了某个应用、或者想引入一个之前未关联的依赖应用时，本技能**不重建已有 worktree**，只增量添加。
-
-**启动时声明：** "我正在使用 openspec-extend-worktree 技能来补加应用到已有的多仓库联动 worktree。"
-
-## 核心原则
-
-- 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**
-- **本技能不会重建、修改、删除任何已存在的 worktree**——只增量添加新 worktree，已开发的工作不受影响
-- 使用 `git worktree add` 创建新 worktree，物理位置与 init-worktree 完全一致（`.worktrees/worktree-<需求名>/<应用名>/`）
-- 所有仓库使用统一的分支名（不加前缀）；worktree 目录名自动加 `worktree-` 前缀
-- **目标 worktree 必须已存在**（即 `.worktrees/worktree-<需求名>/` 必须已存在）；不存在则终止并提示用 init-worktree
-- 输入约定：**自由文本**（需求名、应用仓库 URL 等）直接在对话中提问并等待回复，禁止使用 `AskUserQuestion`；**固定列表多选**（如应用选择）使用 `AskUserQuestion`（`multiSelect: true`），按 side 分组排列选项
-
----
-
-## Step 0：前置校验与执行位置确认
-
-本技能支持**两层执行位置**（与 `openspec-close-worktree` 对称）：
-
-| 执行位置 | cwd 形态 | 需求名识别方式 |
-|---|---|---|
-| 工作空间根目录 | `WS_ROOT/` | 列 `.worktrees/` 下所有 worktree，唯一时自动选用，多个时按 mtime 倒序并提示 |
-| worktree 内部 | `WS_ROOT/.worktrees/worktree-<需求名>/` 或其子目录 | **自动从 cwd 路径反推** |
-
-### 0.1 环境健康探活
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/check-env.js
-"
-```
-
-**解读输出**：
-- 退出码 0 + 末行 `ENV_OK {...}` → 探活通过，继续
-- 退出码 1 → git 不可用，**终止流程**
-- 退出码 2 → 当前不在 git 仓库，**终止流程**
-
-### 0.2 定位工作空间根目录
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/find-workspace-root.js
-"
-```
-
-**解读输出**：
-- 退出码 0 + 末行（纯路径） → WS_ROOT 绝对路径，AI agent 解析后用于后续命令的 `<ws_root>` 占位符
-- 退出码 1 → 未找到工作空间根目录，**终止流程**
-
-> ⓘ **为什么不用 CONFIG.json 存在性判断**：init-worktree 会把 CONFIG.json 提交到主分支，`git worktree add` 会自动 checkout 副本到 worktree 目录中。使用 `git worktree list` 的第一行（git 契约上始终为主仓库绝对路径）则不受该问题影响。
-
-### 0.3 目标需求名识别
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/find-target-worktree.js "<ws_root>"
-```
-
-**优先级**：
-1. cwd 在 worktree 内 → 自动从路径反推需求名
-2. `.worktrees/` 下只有一个 worktree → 自动选用
-3. 多个 worktree → 按 mtime 倒序输出列表，AI agent 在对话中让用户输入
-
-**解读输出**：
-- 退出码 0 + 末行（纯需求名） → 唯一识别，AI agent 解析后用于 `<branch>` 占位符
-- 退出码 1 + 末行 `MULTIPLE_WORKTREEES` → 多个 worktree，AI agent 列出上面的 `[1] xxx ⭐ / [2] yyy` 让用户输入序号或完整分支名
-- 退出码 2 + 末行 `NO_WORKTREE` → 无 worktree，提示用户用 init-worktree
-
-**情况 B：任一仓库已存在该分支 → 复用**
-- 脚本自动跳过已存在分支（`status: 'reused'`），不阻塞流程
-- 不再提供「复用/修改/中断」选项（脚本自动处理）
-
-> 续：在对话中纯文本提问用户，等待回复后重新执行 find-target-worktree.js。
-
-### 0.4 校验 CONFIG.json 与 Git 仓库
-
-> 注：find-workspace-root.js 已隐式校验 CONFIG.json 存在；本步骤额外校验 apps 非空。
-
-```bash
-# 复用 init-worktree 的 parse-config.js
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-init-worktree/scripts/parse-config.js"
-```
-
-**解读输出**：
-- 退出码 0 + 末行 `CONFIG_OK [...]` → 继续
-- 其他 → 终止流程
-
----
-
-## Step 1：选择要补加的应用
-
-### 1.1 计算"未关联"应用清单
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/list-available-apps.js "<ws_root>" "<branch>"
-```
-
-**解读输出**：
-- 退出码 0 + 末行 `LIST_RESULT {available: [...], already: [...]}` → 有可用应用
-- 退出码 2 → 所有应用都已关联，**终止流程**（无需扩展）
-
-### 1.2 多选补加应用
-
-1. **从 Step 1.1 输出中提取待补加应用名列表**（`LIST_RESULT` 中 `available` 数组的 `name` 值）。
-
-2. **运行 `generate-app-options.js` 脚本**，用 `--filter` 只生成未关联应用的 options：
-
-   ```bash
-   node ".qoder/skills/openspec-init-worktree/scripts/generate-app-options.js" --filter=app1,app2,...
-   ```
-
-   > ⓘ `--filter` 值取 Step 1.1 `available[].name`，逗号分隔。脚本根据 CONFIG.json 中对应的 `side` + `name` 硬编码生成 label，绝不翻译。
-
-   **解读输出**：
-   - 退出码 0 + 末行 `APP_OPTIONS [{...}]` → 解析 JSON，得到 options 数组
-   - 退出码 1/2 → 出错，**终止流程**
-
-3. **使用 `AskUserQuestion`（`multiSelect: true`）让用户勾选**：将脚本输出的 options 数组**原样传入**，不增、不减、不改任何字段：
-
-   ```
-   AskUserQuestion({
-     questions: [{
-       header: "补加应用",
-       multiSelect: true,
-       options: <脚本输出的 options 数组，不做任何修改>
-     }]
-   })
-   ```
-
-**用户未选任何项** → 终止流程（用户主动取消）。
-
-**解析选择结果**：从 `AskUserQuestion` 返回的选中项中提取 `name` 字段（脚本输出的 options 中每个元素自带 `name`），得到待补加应用列表。
-
-### 1.3 同步待补加应用的 `.code/` 仓库
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/sync-repos.js "<ws_root>" '<app1,app2,...>'
-```
-
-**解读输出**：
-- 退出码 0 + 末行 `SYNC_RESULT [...]` → 全部成功
-- 退出码 2 → 部分 clone 失败，**终止流程**
-
-> ⓘ **关于 `.code/` 共享**：`.code/<应用名>/` 是该 app 仓库的本地基线（`origin/main` 等远程引用就绪即可），跨所有 worktree / worktree 共享。extend-worktree 不复制代码、不影响其他 worktree 的基线。
-
-### 1.4 最终输出
-
-```text
-确认补加应用：
-  [1] ep-user-info-server → .code/ep-user-info-server
-  [2] ep-user-web → .code/ep-user-web
-目标 worktree: <需求名>（.worktrees/worktree-<需求名>/）
-```
-
----
-
-## Step 2：状态检查（仅对新增应用）
-
-对每个待补加应用执行**轻量状态检查**（与 init-worktree 对 app 仓库的检查一致）：
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/check-repos.js "<ws_root>" '<app1,app2,...>'
-```
-
-**解读输出**：
-- 退出码 0 + 末行 `CHECK_RESULT ALL_OK` → 全部通过，继续 Step 3
-- 退出码 2 + 末行 `CHECK_RESULT HAS_FAILURES` → 部分失败，**终止流程**
-
-> **注意：workspace 仓库不在本步骤检查**（extend 不修改 workspace 状态，`.gitignore` 在 init-worktree 阶段已处理完毕）。
-
----
-
-## Step 3：创建分支 + 嵌套 Worktree
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/create-branches-and-worktrees.js "<ws_root>" "<branch>" '<app1,app2,...>'
-```
-
-脚本内部自动完成：
-1. 对每个 app：检测分支是否已存在，已存在则复用
-2. 不存在则从 `origin/<main>` 创建
-3. 创建嵌套 worktree（物理路径：`.worktrees/worktree-<branch>/<app>`）
-
-> 注：脚本使用 Node.js + execSync 串行执行（Node.js 单线程无法真正并行 execSync）。
-> 沙箱内/沙箱外行为一致，避免并发 DLL 冲突。
-
-**解读输出**：
-- 退出码 0 + 末行 `BRANCH_WT_RESULT [...]` → 全部成功
-- 退出码 2 → 部分失败，**报告详情**
-
-**报告格式：**
-```
-✅ ep-user-info-server: 分支 feature-login 创建成功（从 origin/main）
-✅ ep-user-info-server: 嵌套 worktree 创建成功
-⏭️ ep-user-web: 分支已存在，复用
-✅ ep-user-web: 嵌套 worktree 创建成功
-```
-
-**复用机制**：
-- 分支已存在 → 跳过创建（用户可能已通过其他方式创建）
-- 嵌套 worktree 已存在 → 跳过创建（兜底）
-- 两种复用都不会影响现有 worktree 内容
-
-**失败回滚**：某个 app 失败时，已成功的 worktree 仍保留（用户可手动决定是否清理），报告失败详情。
-
----
-
-### 3.5 推送新分支建立 upstream（必要步骤）
-
-extend-worktree 在 init-worktree 基础上补加应用，必须为本次**新建**的分支建立 upstream，否则后续 agent 在新 worktree 中 `git push` 会报 `fatal: The current branch <branch> has no upstream branch`。
-
-**自动行为**：[`create-branches-and-worktrees.js`](file:///d:/workspace/va-ai/coding-bb/cbb/worktrees/skills/openspec-extend-worktree/scripts/create-branches-and-worktrees.js) 内部对 `status='created'`（即本次新建分支 + 新建 worktree 的应用）自动调 `push-core.pushSingle` 推送，复用分支（init-worktree 已推过）跳过。
-
-**解读末行 `BRANCH_WT_RESULT`** 每项的 `push_status` 字段：
-- `pushed` → 已推送 `origin/<branch>`
-- `skipped` → 复用分支，init-worktree 已推送过
-- `failed` → 推送失败，AI 阻塞并按错误码处理（ssh/https/network/branch-protected 等）
-- `remote-exists` → 远程分支已存在，AI 展示 commit 元信息后由用户决策
-
-**错误处理**：与 init-worktree Step 3.4 一致——失败时阻塞流程，AI 必须询问用户三选项（修复后重试/跳过失败应用/完全终止），远程分支已存在时必须输出 commit 元信息再询问两选项（关联/终止+重新创建）。
-
-> ⓘ **为什么只推新建分支**：复用分支（`status='branch-reused-wt-created'` 或 `status='reused'`）在 init-worktree 阶段已建立过 upstream，重复 push 可能触发 `already exists` 错误并要求用户额外决策。
-
----
-
-## Step 4：确保 workspace worktree AI 配置完整（必要步骤）
-
-workspace 主分支的 `.claude/` `.qoder/` `.cbb/` 通常为 gitignore'd，extend-worktree 创建的嵌套 worktree 不会自动带入。
-**开发约束只在 workspace worktree 中生效**——各应用 worktree 不需要安装 AI 配置。
-
-> 本步骤只对 workspace worktree 跑一次 `cbb init --yes`。用 `.cbb/.managed-by-cbb` 判重，
-> 若 init-worktree 已经 init 过则直接跳过；失败则 exit 2 阻塞（与 init-worktree 语义一致）。
-
-```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/install-ai.js "<ws_root>" "<branch>"
-```
-
-**解读输出**：
-- 退出码 0 + 末行 `AI_INIT_OK` → 成功 / 跳过（workspace 已 init 过）
-- 退出码 1 → 参数错误（脚本 bug 或调用错误）
-- 退出码 2 + 末行 `AI_INIT_FAILED` → cbb init 执行失败，**extend-worktree 中断**，
-  按错误提示手动执行 `cd "<ws_root>/.worktrees/worktree-<branch>" && cbb init --yes` 后重跑
-
-> ⓘ **关于 `.cbb/.managed-by-cbb`**：cbb 初始化时会创建该清单文件，作为"已初始化"的标志，避免重复安装。
-
-> ⓘ **为什么不各应用 worktree 都装？** 开发约束（编码规范、OpenSpec 技能）只在 workspace worktree 里使用，
-> 各应用 worktree（Java 后端项目）不直接依赖 cbb，无需安装。
-
----
-
-## Step 5：报告
-
-AI agent 根据以上 Step 的输出汇总报告：
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  ✅ worktree 已扩展
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  目标 worktree:  <branch>
-  工作空间根:    <ws_root>
-  补加应用:
-    - <app1> → .worktrees/worktree-<branch>/<app1>
-    - <app2> → .worktrees/worktree-<branch>/<app2>
-  AI 配置:       ✅ 已安装（新建）/ 跳过（已存在）
-
-  close-worktree 时会自动识别并清理所有已存在的 worktree
-  继续在当前目录开发即可
-```
-
-> ⓘ **本技能不切换 IDE 窗口**：与 init-worktree 创建后切到新 worktree、close-worktree 切回 WS_ROOT 不同，extend-worktree **不切 IDE 窗口**——用户在原 worktree 窗口继续开发，新增 worktree 是嵌套子目录，通过 IDE 的文件树/终端面板即可访问。
-
----
-
-## Step 6：后置扩展（预留）
-
-当前为预留步骤，不执行具体逻辑。后续可扩展为执行后置脚本、上报数据等。
-
-报告：*"Step 6：后置扩展点（预留，当前无操作）"*
-
----
-
-## 快速参考
-
-| 场景 | 处理方式 |
-|---|---|
-| `CONFIG.json` 缺失或 apps 为空 | 终止并提示用户先配置 CONFIG.json |
-| 目标 worktree 不存在（`.worktrees/worktree-<需求名>/` 不存在） | 终止并提示用 init-worktree |
-| 所有应用已关联 | 终止并提示无需扩展 |
-| `.code/<应用名>/` 不存在 | 自动 clone（从 CONFIG.json 读 repo） |
-| 已在 worktree 中的 worktree 内执行 | cwd 自动反推需求名（Step 0.3 优先级 1） |
-| 多个 worktree 共存 | 按 mtime 倒序列出，AI 提示用户输入序号或分支名 |
-| 分支已存在 | 复用（脚本自动跳过） |
-| 嵌套 worktree 已存在 | 复用（防御性兜底） |
-| cbb 未全局安装 | 脚本自动安装；失败则提示手动 |
-| 新建 worktree 的 AI 配置 | `cbb init -y`（用 `.cbb/.managed-by-cbb` 判重） |
-| 已存在 worktree 的 AI 配置 | 跳过（不重复安装） |
-| close-worktree 清理 | 自动识别所有已存在的 worktree |
-| 沙箱内 node 不可用 | 脚本 fail-fast 并提示用户到系统终端重试 |
-
----
-
-## 常见错误
-
-### 跳过 worktree 存在性校验直接创建 worktree
-
-- **问题：** 目标 worktree 目录不存在时强行 `git worktree add`，会导致嵌套路径不正确
-- **修复：** Step 0.3 必须先校验 `.worktrees/worktree-<需求名>/` 存在
-
-### 用 checkout -b 创建分支后再创建 worktree
-
-- **问题：** `git checkout -b <branch>` 将主目录切到新分支，随后 `git worktree add` 报 `fatal: '<branch>' is already checked out`
-- **修复：** Step 3 只用 `git branch` 创建分支，不切换；分支检出由 worktree 完成
-
-### 把"未关联"应用判定为"全部应用"
-
-- **问题：** 误把所有 CONFIG.json 中的应用都补加到 worktree，导致重复创建 worktree
-- **修复：** Step 1.1 必须基于 `.worktrees/worktree-<需求名>/<应用名>/` 实际存在性过滤，已关联的应用必须跳过
-
-### label 被 AI 翻译或丢失（已从根本上解决）
-
-- **问题：** 历史版本中 Step 1.2 要求 AI 手动拼接 label 字符串，导致 `app.name` 被翻译或完全丢失。
-- **修复：** 改为调用 `generate-app-options.js` 脚本（`--filter` 只生成未关联应用），AI 只需将脚本输出的 options 数组原样传入 `AskUserQuestion`，不允许手动修改任何字段。
-
-### 用 AskUserQuestion 收集自由文本输入
-
-- **问题：** 需求名、APP 仓库 URL 需要用户自由输入文本，却用了 AskUserQuestion 工具
-- **修复：** 自由文本输入场景一律直接在对话中提问并等待用户文本回复
-
-### 把 .code/ 当作"每个 worktree 独占"
-
-- **问题：** 误以为 `.code/<应用名>/` 是 worktree 私有目录，尝试在 worktree 内 clone
-- **修复：** `.code/` 是 app 仓库的本地基线，跨所有 worktree 共享
-
-### 完成后续切 IDE 窗口
-
-- **问题：** 模仿 init-worktree 的 Step 6 / close-worktree 的 Step 5.8，强制切 IDE 窗口
-- **修复：** extend-worktree **故意不切 IDE 窗口**——用户在原 worktree 继续开发，扩展的工作是嵌套子目录，不应打断当前工作流
-
----
-
-## 红线规则
-
-以下为硬性红线，违反任一会导致工作树状态不一致或扩展失败。
-
-**绝不允许**
-
-- 跳过 Step 0.3 目标 worktree 存在性校验
-- 跳过 Step 1.1 已关联应用过滤（避免重复创建 worktree）
-- 用 `git checkout -b` 切分支后再建 worktree（分支检出冲突）
-- 用 `AskUserQuestion` 收集自由文本（需求名 / 应用 URL 等）
-- 在已存在的嵌套 worktree 中再次执行 `git worktree add`（导致 "already exists" 错误）
-- 修改 workspace 的 `.gitignore`（已由 init-worktree 在创建时处理，extend 不应触碰）
-- 切换 IDE 窗口（extend 故意不切，保持用户在原 worktree 内继续开发）
-- **Step 1.2 手动构造 AskUserQuestion options（禁止）**——必须调用 `generate-app-options.js` 脚本生成 options，将输出原样传入 `AskUserQuestion`，不得手动拼接 label。详见 [Step 1.2](#12-多选补加应用)
-- 沙箱内 node 不可用时强行继续 → 改为 fail-fast 提示用户
-
-**必须执行**
-
-- 严格按 Step 0 → Step 1 → Step 2 → Step 3 → Step 4 → Step 5 顺序执行
-- 所有脚本调用以 `node "D:/workspace/<ws_root>/.qoder/skills/openspec-extend-worktree/scripts/<name>.js "<绝对路径>" '<json>' "<branch>"` 形式发起
-- 嵌套 worktree 路径与 init-worktree 一致：`.worktrees/worktree-<需求名>/<应用名>/`
-- 分支名与 init-worktree 一致：`<需求名>`（不加前缀）
-- 仅对待补加应用执行状态检查、clone/fetch、创建分支、worktree add
-- 已存在的 worktree 不重复执行 `cbb init -y`（用 `.cbb/.managed-by-cbb` 判重）
-- **Step 1.2 调用 `AskUserQuestion` 前必须由脚本生成 options**：执行 `node ".qoder/skills/openspec-init-worktree/scripts/generate-app-options.js" --filter=<names>`，将 `APP_OPTIONS` 输出的 JSON 数组原样传入 `AskUserQuestion` options，禁止手动修改。
-
----
-
-## 附录：脚本清单
-
-| 脚本 | 功能 | 参数 | 退出码 |
-|------|------|------|--------|
-| `check-env.js` | 环境探活 | 无 | 0/1/2 |
-| `find-workspace-root.js` | 定位工作空间根目录（共享脚本，源仓库真源在 `_shared/scripts/`） | 无 | 0/1 |
-| `find-target-worktree.js` | 目标需求名识别（共享脚本，源仓库真源在 `_shared/scripts/`） | ws_root | 0/1/2 |
-| `list-available-apps.js` | 计算"未关联"应用清单 | ws_root, branch | 0/1/2 |
-| `sync-repos.js` | 同步待补加应用的 .code/ 仓库 | ws_root, apps_json | 0/1/2 |
-| `check-repos.js` | app 轻量状态检查 | ws_root, apps_json | 0/1/2 |
-| `create-branches-and-worktrees.js` | 创建分支 + 嵌套 worktree | ws_root, branch, apps_json | 0/1/2 |
-| `install-ai.js` | 确保 workspace worktree AI 配置完整（**必要步骤**） | ws_root, branch | 0/1/2 |

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

@@ -1,95 +0,0 @@
-#!/usr/bin/env node
-require('./silence-popup');
-/**
- * openspec-extend-worktree 环境健康探活
- *
- * 与 init-worktree 同构，但额外检测「是否在 worktree 内」（extend 支持双层执行位置）。
- *
- * 退出码：
- *   0 - 探活通过
- *   1 - 致命错误（git 不可用）
- *   2 - 当前不在 git 仓库
- */
-
-const { execSync } = require('child_process');
-
-function tryExec(cmd, opts = {}) {
-  try {
-    const out = execSync(cmd, {
-      encoding: 'utf-8',
-      stdio: ['ignore', 'pipe', 'pipe'],
-      ...opts,
-    });
-    return { ok: true, out: out.trim() };
-  } catch (e) {
-    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
-  }
-}
-
-const checks = {};
-
-// ── 必检：git ─────────────────────────────────────────
-checks.git = tryExec('git --version');
-if (!checks.git.ok) {
-  console.error('❌ git 启动失败（可能是 Qoder 沙箱 DLL 问题 0xc0000142）');
-  console.error('   解决方案：到系统终端（非 Qoder AI 终端）重新执行本技能');
-  process.exit(1);
-}
-console.log('✅ git OK:', checks.git.out);
-
-// ── 必检：当前目录是 git 仓库 ─────────────────────────
-const insideRepo = tryExec('git rev-parse --is-inside-work-tree');
-if (!insideRepo.ok || insideRepo.out !== 'true') {
-  console.error('❌ 当前目录不是 Git 仓库');
-  console.error('   extend-worktree 必须在工作空间根目录或 worktree 内执行');
-  process.exit(2);
-}
-console.log('✅ 当前目录是 git 仓库');
-
-// ── 必检：定位 worktree（git worktree list） ─────────
-const worktreeList = tryExec('git worktree list');
-if (worktreeList.ok) {
-  const lines = worktreeList.out.split('\n').filter(Boolean);
-  console.log(`✅ git worktree list 返回 ${lines.length} 行`);
-  // 第一行总是主仓库
-  if (lines.length > 0) {
-    console.log('   主仓库:', lines[0].split(/\s+/)[0]);
-  }
-} else {
-  console.log('⚠️  git worktree list 失败');
-}
-
-// ── 选检：node.js（脚本运行时，所有 .js 脚本依赖） ──
-checks.node = tryExec('node --version');
-if (!checks.node.ok) {
-  console.log('⚠️  node 不可用（脚本将无法执行，建议安装 Node.js >= 16.7.0）');
-} else {
-  console.log('✅ node OK:', checks.node.out);
-}
-
-// ── 选检：cbb ────────────────────────────────────
-checks.cbbInfo = tryExec('cbb --version');
-if (!checks.cbbInfo.ok) {
-  console.log('ℹ️  cbb 未全局安装（Step 4 会兜底自动安装）');
-} else {
-  console.log('✅ cbb OK:', checks.cbbInfo.out);
-}
-
-// ── 沙箱检测 ─────────────────────────────────────────
-const inWorktree = !!(process.env.QODER_AGENT || process.env.QODER_WORKTREE);
-if (inWorktree) {
-  console.log('🛡️  Qoder 沙箱环境：Step 3 将降级为串行执行（避免并发 DLL 冲突）');
-} else {
-  console.log('✅ 非沙箱环境：Step 3 可并发执行');
-}
-
-const summary = {
-  git: checks.git.ok,
-  node: checks.node.ok,
-  cbbInfo: checks.cbbInfo.ok,
-  inWorktree,
-  ok: true,
-};
-console.log('---');
-console.log('ENV_OK', JSON.stringify(summary));
-process.exit(0);