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

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

@@ -28,7 +28,7 @@ metadata:
 
 ## 调用脚本的统一方式
 
-**重要**：所有脚本必须用**绝对路径**调用。`./scripts/...` 相对路径在 Qoder 沙箱中不适用（AI agent 的 cwd 不一定是技能目录）。
+**重要**：所有脚本必须用**绝对路径**调用。`./scripts/...` 相对路径在 Agent 运行环境中不适用（AI agent 的 cwd 不一定是技能目录）。
 
 调用方式（推荐用绝对路径）：
 ```
@@ -59,12 +59,12 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/check-env.j
 
 **解读输出**：
 - 退出码 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"
@@ -76,8 +76,6 @@ 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
@@ -298,7 +296,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/create-work
 3. **app worktree 创建**（物理嵌套在 workspace worktree 内）
 
 **解读输出**：
-- 退出码 0 + 末行 `WT_PATH <绝对路径>` → 全部成功，AI 解析出 worktree 绝对路径供后续 Step 4/5 使用
+- 退出码 0 + 末行 `WT_PATH <绝对路径>` → 全部成功，AI 解析出 worktree 绝对路径供后续 Step 4 使用
 - 退出码 2 → workspace worktree 创建失败（分支已检出/权限不足），**终止流程**
 - 退出码 3 → 部分 app worktree 创建失败，**报告已创建/失败详情，用户需手动清理**
 
@@ -313,52 +311,31 @@ 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 配置（必要步骤）
+## Step 4：收尾与交接（必要步骤）
 
-workspace 主分支的 `.claude/` `.qoder/` `.cbb/` 通常为 gitignore'd，创建 worktree 时不会自动带入。
-**本步骤在 worktree 内执行 `cbbm init --yes` 是必要步骤**——缺失 AI 配置会导致后续
-openspec-propose/apply/verify/ff 等技能全部不可用，worktree 将处于"半残"状态。
+不执行脚本。AI agent 向用户输出最终报告（格式见「最终报告」），并完成以下交接声明：
 
-> 与 push-branches（Step 3.4）一致：**本步骤失败将阻塞 init-worktree**，用户必须手动恢复后重跑。
-
-```bash
-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` → cbbm init 执行失败，**init-worktree 中断**，
-  按错误提示手动执行 `cd "<wt_path>" && cbbm init --yes` 后重跑
-
-> `-y` 表示非交互模式：默认选中所有适配器、前置依赖未安装时自动继续，适合 skill 自动化执行。
+1. **继续在当前会话开发**：本技能不打开新窗口；需求工作目录为 `<wt_path>`
+2. **目录纪律**：本会话后续所有产生写操作的命令（git commit / openspec / 构建 / 测试等）必须以 `<wt_path>`（或其应用子目录）为工作目录（显式 `cd` 或绝对路径）；**禁止在空间根（主分支）执行任何写操作**
+3. 不自动安装依赖：各仓库技术栈不一（Maven 依赖本机 `~/.m2` 全局共享、无需初始化；Node/Python 等由你进入 worktree 后执行正确的命令，如 `npm ci` / `pnpm`）
 
 ---
 
-## 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>
+   关联应用：<应用名 → 嵌套路径> 列表
+📌 继续在当前会话开发：后续写操作命令一律以上述目录为工作目录
 ```
 
-**解读末行**：
-- `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），报告必须列出已创建/失败详情与回滚清理命令。
 
 ---
 
@@ -381,14 +358,14 @@ 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） |
@@ -462,10 +439,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,11 +456,11 @@ 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>` 或其应用子目录）
 
 **必须执行**
 
@@ -507,7 +484,5 @@ node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-init/scripts/auto-open.j
 | `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（已一致则 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-push/SKILL.md

@@ -30,7 +30,7 @@ metadata:
 
 ## 调用脚本的统一方式
 
-**所有脚本必须用绝对路径调用**（Qoder 沙箱中 AI agent 的 cwd 不一定是技能目录）。
+**所有脚本必须用绝对路径调用**（Agent 运行环境中 AI agent 的 cwd 不一定是技能目录）。
 
 ```
 node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/<name>.js" <参数>
@@ -282,7 +282,7 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 - push 失败后跳过失败仓库直接继续
 - 远程分支已存在时脚本自动 set-upstream-to
 - AI 询问关联选项前不输出 commit 元信息
-- 沙箱内 node 不可用时强行继续 → 改为 fail-fast 提示用户
+- 运行环境 node 不可用时强行继续 → 改为 fail-fast 提示用户
 
 **必须执行**
 

package/config/workspace-agents.sample.md

@@ -1,37 +1,39 @@
-# 业务空间使用说明（AI Agent 导航）
-
-本目录是由 `@jspg-ai/coding-bb` 初始化的**多仓库联动开发业务空间**。
-进入本目录工作时，请先按本文件理解目录职责与协作约定，再动手。
-
-## 核心约定
-
-1. **本目录不做需求开发**。本目录（业务空间主分支）只负责组织与调度；所有需求开发都在 `.worktrees/worktree-<需求名>/` 隔离目录内进行。
-2. **接到新需求先建 worktree**：在本目录执行 `/cbb:worktree-init <需求名>`（opencode 写法：`/cbb-worktree-init`）。它会为 `workspace-config.json` 中的全量关联应用同步创建同名 worktree，并自动安装沙箱内的编码规范与 OpenSpec 工作流。
-3. **开发动作全部在 worktree 内**：需求提案 / 实现 / 验证 / 归档（`/opsx:propose` → `/opsx:apply` → `/opsx:verify` → `/opsx:archive`）在 worktree 沙箱内执行；跨仓库提交推送用 `/cbb:worktree-push`，需求收尾用 `/cbb:worktree-close`。
-4. **关联应用增减只改配置**：编辑 `workspace-config.json` 的 `apps` 数组（`name` / `repo` / `side` / `desc`），然后用同一需求名重跑 worktree 初始化即幂等补齐；不要手工 `git clone` 应用仓库。
-5. **不要绕过 worktree 直接修改 `.codespace/` 或本目录的代码**。`.codespace/` 是工具维护的基准代码，不是开发区。
-
-## 目录结构与职责
-
-| 路径 | 职责 | 维护方式 |
-|------|------|----------|
-| `workspace-config.json` | 关联应用清单，所有应用联动的唯一数据源 | 人工编辑 |
-| `.codespace/` | 各关联应用的基准代码（每个应用一个子目录） | `cbb setup` 与 worktree 流程自动 clone / fetch；**勿手动编辑**；已 gitignore，不提交 |
-| `.worktrees/` | 需求隔离开发区（每个需求一个 `worktree-<需求名>/` 目录） | worktree 命令自动创建 / 清理；不提交（首次执行 worktree 流程时自动加入 .gitignore） |
-| `openspec/` | OpenSpec 工作流配置（`config.yaml` + `schemas/`） | 由 cbb 安装；需求变更产物（`openspec/changes/` 等）在 worktree 内生成，随需求分支提交 |
-| `.claude/` `.qoder/` `.opencode/` | AI 工具适配目录：worktree 管理技能与命令；**故意不含**编码规范（防止在空间根直接开发） | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
-| `.cbb/` | cbb 安装清单，记录本包管理的全部路径 | 由 cbb 管理；**勿手动编辑** |
-
-## 典型流程
-
-```
-本目录：/cbb:worktree-init <需求名>
-  → .worktrees/worktree-<需求名>/ 内开发（/opsx:propose → /opsx:apply → /opsx:verify → /opsx:archive）
-  → /cbb:worktree-push 推送 → 合并后 /cbb:worktree-close 关闭
-```
-
-> 命令写法因 AI 工具而异：Claude Code / Qoder 为 `/cbb:worktree-init`，opencode 为 `/cbb-worktree-init`；`/opsx:*` 同理（opencode 为 `/opsx-*`）。
-
----
-
-本文件由 `@jspg-ai/coding-bb` 生成（仅缺失时写入，之后不会覆盖或删除，可自由增补团队约定）。
+# 业务空间使用说明（AI Agent 导航）
+
+本目录是由 `@jspg-ai/coding-bb` 初始化的**多仓库联动开发业务空间**。
+进入本目录工作时，请先按本文件理解目录职责与协作约定，再动手。
+
+## 核心约定
+
+1. **本目录不做需求开发**。本目录（业务空间主分支）只负责组织与调度；所有需求开发都在 `.worktrees/worktree-<需求名>/` 隔离目录内进行。
+2. **AI 配置安装在空间根**：编码规范、OpenSpec 命令、worktree 管理技能都装在本目录（`cbb setup` / `cbb update` 安装）；worktree 内**不安装** AI 配置，AI 会话始终以空间根为基础。
+3. **接到新需求先建 worktree**：在本目录执行 `/cbb:worktree-init <需求名>`（opencode 写法：`/cbb-worktree-init`）。它会为 `workspace-config.json` 中的全量关联应用同步创建同名 worktree。
+4. **开发命令在本会话执行，写操作指向 worktree**：需求提案 / 实现 / 验证 / 归档（`/opsx:propose` → `/opsx:apply` → `/opsx:verify` → `/opsx:archive`）在空间根会话执行；但所有产生写操作的命令（git commit / openspec / 构建 / 测试 / 文件修改）必须以 `.worktrees/worktree-<需求名>/`（或其应用子目录）为工作目录（显式 `cd` 或绝对路径）；**禁止在空间根（主分支）执行写操作**。
+5. **关联应用增减只改配置**：编辑 `workspace-config.json` 的 `apps` 数组（`name` / `repo` / `side` / `desc`），然后用同一需求名重跑 worktree 初始化即幂等补齐；不要手工 `git clone` 应用仓库。
+6. **不要绕过 worktree 直接修改 `.codespace/` 或本目录的代码**。`.codespace/` 是工具维护的基准代码，不是开发区。
+
+## 目录结构与职责
+
+| 路径 | 职责 | 维护方式 |
+|------|----------|----------|
+| `workspace-config.json` | 关联应用清单，所有应用联动的唯一数据源 | 人工编辑 |
+| `.codespace/` | 各关联应用的基准代码（每个应用一个子目录） | `cbb setup` 与 worktree 流程自动 clone / fetch；**勿手动编辑**；已 gitignore，不提交 |
+| `.worktrees/` | 需求隔离开发区（每个需求一个 `worktree-<需求名>/` 目录） | worktree 命令自动创建 / 清理；不提交（首次执行 worktree 流程时自动加入 .gitignore） |
+| `openspec/` | OpenSpec 工作流配置（`config.yaml` + `schemas/`） | 由 cbb 安装；需求变更产物（`openspec/changes/` 等）在**需求工作树内**生成，随需求分支提交 |
+| `.claude/` `.qoder/` `.opencode/` | AI 工具适配目录：编码规范规则、OpenSpec 命令、worktree 管理技能与命令 | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
+| `.cbb/` | cbb 安装清单，记录本包管理的全部路径 | 由 cbb 管理；**勿手动编辑** |
+
+## 典型流程
+
+```
+本目录：/cbb:worktree-init <需求名>
+  → 继续在当前会话开发：写操作命令以 .worktrees/worktree-<需求名>/ 为工作目录
+    （/opsx:propose → /opsx:apply → /opsx:verify → /opsx:archive）
+  → /cbb:worktree-push 推送 → 合并后 /cbb:worktree-close 关闭
+```
+
+> 命令写法因 AI 工具而异：Claude Code / Qoder 为 `/cbb:worktree-init`，opencode 为 `/cbb-worktree-init`；`/opsx:*` 同理（opencode 为 `/opsx-*`）。
+
+---
+
+本文件由 `@jspg-ai/coding-bb` 生成（仅缺失时写入，之后不会覆盖或删除，可自由增补团队约定）。

package/config/workspaces.json

@@ -15,6 +15,11 @@
       "name": "数据标注平台-AI开发工作空间",
       "repo": "http://git.portjs.cn/jspg-ai/ai-workspace/jspg-data-labeling-aiws.git",
       "businessLine": "yzg-ai"
+    },
+    {
+      "name": "集团EDI一体化-AI开发工作空间",
+      "repo": "http://git.portjs.cn/jspg-ai/ai-workspace/jspg-edi-yth-aiws.git",
+      "businessLine": "yth"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.2-beta.29",
+  "version": "0.0.3-beta.2",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {
@@ -19,7 +19,7 @@
   "scripts": {
     "sync:shared": "node scripts/sync-shared.js",
     "pretest": "node scripts/sync-shared.js --check",
-    "test": "node test/lib/install/cleanup.test.js && node test/lib/utils/settings.test.js && node test/lib/utils/gitignore.test.js && node test/lib/utils/version.test.js && node test/lib/install/workspaces.test.js && node test/lib/utils/checkbox.test.js && node test/lib/utils/output.test.js && node test/lib/install/cli-help.test.js && node test/lib/wiki/wiki-publish.test.js && node test/lib/wiki/wiki-parse-args.test.js && node test/lib/wiki/wiki-split.test.js && node test/lib/superpowers/superpowers.test.js && node test/worktrees/push-branches.test.js && node test/worktrees/commit-worktrees.test.js && node test/worktrees/push-worktrees.test.js && node test/worktrees/install-ai.test.js && node test/worktrees/check-env-deep.test.js && node test/lib/openspec/openspec-render.test.js"
+    "test": "node test/lib/install/cleanup.test.js && node test/lib/utils/settings.test.js && node test/lib/utils/gitignore.test.js && node test/lib/utils/version.test.js && node test/lib/install/workspaces.test.js && node test/lib/utils/checkbox.test.js && node test/lib/utils/output.test.js && node test/lib/install/cli-help.test.js && node test/lib/wiki/wiki-publish.test.js && node test/lib/wiki/wiki-parse-args.test.js && node test/lib/wiki/wiki-split.test.js && node test/lib/superpowers/superpowers.test.js && node test/worktrees/push-branches.test.js && node test/worktrees/commit-worktrees.test.js && node test/worktrees/push-worktrees.test.js && node test/worktrees/check-env-deep.test.js && node test/lib/openspec/openspec-render.test.js"
   },
   "keywords": [
     "cbb",

package/cbb/worktrees/skills/cbb-worktree-init/scripts/auto-open.js

@@ -1,136 +0,0 @@
-#!/usr/bin/env node
-require('./silence-popup');
-/**
- * cbb-worktree-init 环境感知 + 自动打开 IDE/CLI
- *
- * 用法：node auto-open.js <wt_path>
- *
- * 检测当前运行环境并自动在新窗口打开 worktree：
- *   - Qoder GUI → qoder --new-window
- *   - Cursor GUI → cursor --new-window
- *   - VS Code GUI → code --new-window
- *   - JetBrains → 通过 Windows 注册表 / macOS open -a / Linux command -v 查找（launcher 默认开新窗口）
- *   - CLI 模式 → 仅切换 cwd，输出 ENV=CLI
- *
- * 输出末行：
- *   ENV=QODER_GUI / CURSOR_GUI / VSCODE_GUI / JETBRAINS_GUI / CLI
- *   或 OPEN_FAILED
- *
- * 退出码：始终 0（失败也返回，由末行判断）
- */
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const wtPath = process.argv[2];
-
-if (!wtPath) {
-  console.error('❌ 用法：node auto-open.js <wt_path>');
-  process.error = 'USAGE_ERROR';
-  process.exit(0);
-}
-
-if (!fs.existsSync(wtPath)) {
-  console.error('❌ worktree 路径不存在：' + wtPath);
-  console.log('---');
-  console.log('OPEN_FAILED');
-  process.exit(0);
-}
-
-function run(cmd, opts) {
-  try {
-    return { ok: true, out: execSync(cmd, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], ...opts }).trim() };
-  } catch (e) {
-    return { ok: false };
-  }
-}
-
-const qoderAgent = process.env.QODER_AGENT === 'true';
-const vscodePid = process.env.VSCODE_PID;
-const vscodeBrand = process.env.VSCODE_BRAND;
-const termEmu = process.env.TERMINAL_EMULATOR || '';
-
-// Qoder GUI
-if (qoderAgent && vscodePid) {
-  const r = run('qoder --new-window "' + wtPath + '"');
-  if (r.ok) {
-    console.log('ENV=QODER_GUI');
-  } else {
-    console.log('OPEN_FAILED');
-  }
-  process.exit(0);
-}
-
-// Cursor GUI
-if (vscodePid && vscodeBrand === 'Cursor') {
-  const r = run('cursor --new-window "' + wtPath + '"');
-  if (r.ok) {
-    console.log('ENV=CURSOR_GUI');
-  } else {
-    console.log('OPEN_FAILED');
-  }
-  process.exit(0);
-}
-
-// 其他 VS Code 分支
-if (vscodePid) {
-  const r = run('code --new-window "' + wtPath + '"');
-  if (r.ok) {
-    console.log('ENV=VSCODE_GUI');
-  } else {
-    console.log('OPEN_FAILED');
-  }
-  process.exit(0);
-}
-
-// JetBrains
-if (/jetbrains/i.test(termEmu)) {
-  const platform = os.platform();
-  let launcher = '';
-
-  if (platform === 'win32') {
-    // Windows：通过 PowerShell 查注册表
-    const psCmd = 'powershell -NoProfile -Command "Get-ItemProperty \'HKLM:\\Software\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\*\',\'HKLM:\\Software\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\*\',\'HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\*\' -ErrorAction SilentlyContinue | Where-Object { $_.DisplayName -match \'IntelliJ|WebStorm|PyCharm|GoLand|PhpStorm|Rider|CLion|RubyMine|DataGrip\' } | Select-Object -First 1 -ExpandProperty DisplayIcon"';
-    const r = run(psCmd);
-    if (r.ok && r.out) launcher = r.out;
-  } else if (platform === 'darwin') {
-    // macOS：通过 open -Ra 查找
-    const apps = ['IntelliJ IDEA', 'WebStorm', 'PyCharm', 'GoLand', 'PhpStorm', 'Rider', 'CLion', 'RubyMine', 'DataGrip'];
-    for (const app of apps) {
-      const check = run('open -Ra "' + app + '"');
-      if (check.ok) {
-        const open = run('open -a "' + app + '" "' + wtPath + '"');
-        if (open.ok) {
-          console.log('ENV=JETBRAINS_GUI');
-          process.exit(0);
-        }
-      }
-    }
-  } else {
-    // Linux：通过 command -v 查找
-    const cmds = ['idea64', 'idea', 'webstorm64', 'webstorm', 'pycharm64', 'pycharm', 'goland64', 'goland'];
-    for (const c of cmds) {
-      const which = run('command -v "' + c + '"');
-      if (which.ok && which.out) {
-        launcher = which.out;
-        break;
-      }
-    }
-  }
-
-  if (launcher) {
-    const r = run('"' + launcher + '" "' + wtPath + '"');
-    if (r.ok) {
-      console.log('ENV=JETBRAINS_GUI');
-      process.exit(0);
-    }
-  }
-  console.log('ENV=CLI');
-  process.exit(0);
-}
-
-// CLI 模式
-console.log('ENV=CLI');
-process.exit(0);