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

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

@@ -1,6 +1,6 @@
 ---
-name: openspec-close-worktree
-description: "关闭/清理/删除需求工作空间的 worktree 和分支。触发：用户明确说关闭/清理/删除 worktree、结束隔离开发、合并完要清理。禁止在 openspec-init-worktree 执行后自动调用——只有用户主动要求关闭时才触发。"
+name: cbb-worktree-close
+description: "关闭/清理/删除需求工作空间的 worktree 和分支。触发：用户明确说关闭/清理/删除 worktree、结束隔离开发、合并完要清理。禁止在 cbb-worktree-init 执行后自动调用——只有用户主动要求关闭时才触发。"
 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:
@@ -11,17 +11,17 @@ metadata:
 
 # Close Worktree（跨平台脚本化版本 v2.0）
 
-关闭一个由 `openspec-init-worktree` 创建的多仓库联动隔离环境：移除 workspace worktree 及所有关联应用 worktree，并默认保留特性分支（按需手动清理）。当你需要结束一次跨多仓库的隔离开发、把环境打扫干净时，本技能一次性完成 worktree 移除与会话收尾。
+关闭一个由 `cbb-worktree-init` 创建的多仓库联动隔离环境：移除 workspace worktree 及所有关联应用 worktree，并默认保留特性分支（按需手动清理）。当你需要结束一次跨多仓库的隔离开发、把环境打扫干净时，本技能一次性完成 worktree 移除与会话收尾。
 
-**启动时声明：** "我正在使用 openspec-close-worktree 技能来关闭多仓库联动的隔离 worktree 环境。"
+**启动时声明：** "我正在使用 cbb-worktree-close 技能来关闭多仓库联动的隔离 worktree 环境。"
 
 ## 核心原则
 
 - 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**
-- 本技能是 `openspec-init-worktree` 的逆操作：共用 `CONFIG.json`、共用 `.worktrees/worktree-<需求名>/` 物理直聚命名、共用统一的分支名（不加前缀）
+- 本技能是 `cbb-worktree-init` 的逆操作：共用 `workspace-config.json`、共用 `.worktrees/worktree-<需求名>/` 物理直聚命名、共用统一的分支名（不加前缀）
 - App worktree **物理嵌套**在 workspace worktree 内（`.worktrees/worktree-<需求名>/<应用名>/`），但 git 上属于各自仓库的独立 worktree
 - 只操作 `.worktrees/worktree-<需求名>` 这一类精确路径，**绝不碰其它 worktree**（如 IDE/工具自动创建的 `~/.qoder/worktree/...` 会话 worktree）
-- 通过检查 `.worktrees/worktree-<需求名>/<应用名>/` **是否实际存在**来确定关联应用——创建时用户可能只关联了 `CONFIG.json` 中的部分应用，不能假设全部应用都关联
+- 通过检查 `.worktrees/worktree-<需求名>/<应用名>/` **是否实际存在**来确定关联应用——创建时用户可能只关联了 `workspace-config.json` 中的部分应用，不能假设全部应用都关联
 - **顺序硬约束：先移除所有 worktree，再删除分支。** 目标分支当前正检出于 worktree 中，先删分支会报 `error: Cannot delete branch '<分支>' checked out at '<worktree 路径>'`
 - **破坏性操作必须先报告、经用户确认才执行**：未提交修改、未合并/未推送的提交，绝不静默 `--force` 或 `-D` 丢弃
 - 软性检查失败时报告详情，询问用户是否继续
@@ -34,7 +34,7 @@ metadata:
 ### 0.1 环境健康探活
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/check-env.js"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-close/scripts/check-env.js"
 ```
 
 **解读输出**：
@@ -45,16 +45,16 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/check
 ### 0.2 定位工作空间根目录
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/find-workspace-root.js"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-close/scripts/find-workspace-root.js"
 ```
 
 **解读输出**：
 - 退出码 0 + 末行（纯路径） → WS_ROOT 绝对路径
 - 退出码 1 → 未找到工作空间根目录，**终止流程**
 
-> ⓘ **为什么不用 CONFIG.json 存在性判断**：init-worktree 会把 CONFIG.json 提交到主分支，`git worktree add` 会自动 checkout 副本到 worktree 目录中。若用 CONFIG.json 存在性判断，在 worktree 内执行时会错误地把 worktree 目录当作 WS_ROOT。使用 `git worktree list` 的第一行（git 契约上始终为主仓库绝对路径）则不受该问题影响。
+> ⓘ **为什么不用 workspace-config.json 存在性判断**：init-worktree 会把 workspace-config.json 提交到主分支，`git worktree add` 会自动 checkout 副本到 worktree 目录中。若用 workspace-config.json 存在性判断，在 worktree 内执行时会错误地把 worktree 目录当作 WS_ROOT。使用 `git worktree list` 的第一行（git 契约上始终为主仓库绝对路径）则不受该问题影响。
 
-> close-worktree 是 init-worktree 的逆操作，但本步骤的 WS_ROOT 定位逻辑与 init-worktree 不同：init-worktree 强制根目录执行（不需要处理 worktree 场景），close-worktree 支持 worktree 内执行（需要绕开 CONFIG.json 副本陷阱）。
+> close-worktree 是 init-worktree 的逆操作，但本步骤的 WS_ROOT 定位逻辑与 init-worktree 不同：init-worktree 强制根目录执行（不需要处理 worktree 场景），close-worktree 支持 worktree 内执行（需要绕开 workspace-config.json 副本陷阱）。
 
 ---
 
@@ -69,7 +69,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/find-
 3. AI agent 列出 `.worktrees/` 下的所有 worktree：
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/find-target-worktree.js "<ws_root>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-close/scripts/find-target-worktree.js "<ws_root>"
 ```
 
 > 注：本技能支持工作空间根目录或 worktree 内执行，find-target-worktree 自动从 cwd 反推或列出。
@@ -84,10 +84,10 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/find-
 ### 1.2 发现关联应用 worktree
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/discover-apps.js "<ws_root>" "<branch>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-close/scripts/discover-apps.js "<ws_root>" "<branch>"
 ```
 
-脚本自动从 `CONFIG.json` 读取应用列表，扫描 `.worktrees/worktree-<branch>/<应用名>/` 实际存在的子目录。
+脚本自动从 `workspace-config.json` 读取应用列表，扫描 `.worktrees/worktree-<branch>/<应用名>/` 实际存在的子目录。
 
 **解读末行 `DISCOVER_RESULT`**：
 - `workspace` 字段：workspace worktree 绝对路径（AI agent 记录供后续命令使用）
@@ -98,7 +98,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/disco
 ### 1.3 检查未归档 change
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/check-unarchived.js "<ws_root>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-close/scripts/check-unarchived.js "<ws_root>"
 ```
 
 脚本扫描 `openspec/changes/` 目录，筛选出非 `archive/` 子目录的 change 名称列表。
@@ -117,7 +117,7 @@ node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/check
 对 workspace worktree 和每个关联应用 worktree，依次执行三项检查并汇总成安全状态表。**这是破坏性操作前的必经环节，结果将驱动 Step 3 的用户决策。**
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/safety-check.js "<ws_root>" "<branch>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-close/scripts/safety-check.js "<ws_root>" "<branch>"
 ```
 
 脚本内部对每个仓库自动执行：
@@ -243,7 +243,7 @@ node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
 ### 3.4 未推送 commit 处理（仅当 2.4 任一 worktree `unpushed_count > 0` 时出现）
 
 **场景**：
-- 用户在 worktree 中做了 commit，但**没有调** `openspec-push-worktrees` 推送
+- 用户在 worktree 中做了 commit，但**没有调** `cbb-worktree-push` 推送
 - 本地有 ahead 提交未推送到 origin
 - 一旦 close worktree + 后续走 `local` / `local_remote` 删分支，ahead 提交可能永久丢失（取决于上游 `delete-branches.js` 行为）
 
@@ -255,12 +255,12 @@ node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
   - ep-baz-app: 2 个 commit
 
 请选择处理方式：
-  [先推送]（推荐）调 openspec-push-worktrees 推送所有 ahead 提交
+  [先推送]（推荐）调 cbb-worktree-push 推送所有 ahead 提交
   [接受丢失] 继续关闭，ahead 提交在删分支后永久丢失
   [中止] 终止流程，我先手动处理
 ```
 
-- 用户选择「先推送」→ AI 引导用户执行 `openspec-push-worktrees`（或 `/opsx:push`），完成后**重新跑** Step 2 safety-check 确认 `unpushed_count = 0` 再回到本步骤
+- 用户选择「先推送」→ AI 引导用户执行 `cbb-worktree-push`（或 `/cbb:worktree-push`），完成后**重新跑** Step 2 safety-check 确认 `unpushed_count = 0` 再回到本步骤
 - 用户选择「接受丢失」→ 必须二次确认（ahead 提交真的会丢），确认后继续 Step 4
 - 用户选择「中止」→ 终止流程
 
@@ -289,7 +289,7 @@ node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
 **顺序：先移除各应用 worktree，再移除 workspace worktree**（逆序于创建；也为后续删分支扫清"分支仍被检出"的障碍）。
 
 ```bash
-node "D:/workspace/<ws_root>/.qoder/skills/openspec-close-worktree/scripts/remove-worktrees.js "<ws_root>" "<branch>" "<force>"
+node "D:/workspace/<ws_root>/.qoder/skills/cbb-worktree-close/scripts/remove-worktrees.js "<ws_root>" "<branch>" "<force>"
 ```
 
 **三层降级策略**：`git worktree remove` 实际包含两个动作——①清理 git 元数据（`.git/worktrees/`）②删除物理目录。当 IDE 占用目录时 ② 会被 Windows 文件锁阻塞，但 ① 永远不受影响。脚本将这两个动作解耦：
@@ -418,7 +418,7 @@ git -C "<ws_root>" worktree list
 
 ### 必须执行
 
-- 读 `CONFIG.json` 取应用名列表；以 `.worktrees/worktree-<需求名>/<应用名>/` 实际存在性确定关联清单
+- 读 `workspace-config.json` 取应用名列表；以 `.worktrees/worktree-<需求名>/<应用名>/` 实际存在性确定关联清单
 - 移除/删除前执行安全评估（未提交修改 / 是否合并 / 是否推远程）并报告
 - 严格按 Step 4.2（移除 worktree）→ Step 4.4（删分支）顺序
 - 移除 workspace worktree 前先把会话移出（`cd "<WS_ROOT>" &&` 或 `git -C` 绝对路径）

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

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-close-worktree 环境健康探活
+ * cbb-worktree-close 环境健康探活
  *
- * close-worktree 必须在工作空间根目录或 worktree 内执行，且需找到 CONFIG.json。
- * 与 init/extend 探活同构，但额外校验 CONFIG.json 存在性。
+ * close-worktree 必须在工作空间根目录或 worktree 内执行，且需找到 workspace-config.json。
+ * 与 init/extend 探活同构，但额外校验 workspace-config.json 存在性。
  *
  * 退出码：
  *   0 - 探活通过
  *   1 - 致命错误（git 不可用）
  *   2 - 当前不在 git 仓库
- *   3 - 未找到 CONFIG.json
+ *   3 - 未找到 workspace-config.json
  */
 
 const { execSync } = require('child_process');

package/cbb/worktrees/skills/{openspec-close-worktree → cbb-worktree-close}/scripts/check-unarchived.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-close-worktree 未归档 change 检查
+ * cbb-worktree-close 未归档 change 检查
  *
  * 用法：node check-unarchived.js <ws_root>
  *

package/cbb/worktrees/skills/{openspec-close-worktree → cbb-worktree-close}/scripts/delete-branches.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-close-worktree 删除分支 (按用户选择)
+ * cbb-worktree-close 删除分支 (按用户选择)
  */
 const { execSync } = require('child_process');
 const fs = require('fs');
@@ -116,7 +116,7 @@ function deleteBranch(repoPath, name) {
   return true;
 }
 
-const configPath = path.join(wsRoot, 'CONFIG.json');
+const configPath = path.join(wsRoot, 'workspace-config.json');
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
 
@@ -127,7 +127,7 @@ deleteBranch(wsRoot, 'workspace');
 
 console.log('=== Delete App Branches ===');
 for (const app of apps) {
-  const appPath = path.join(wsRoot, '.code', app.name);
+  const appPath = path.join(wsRoot, '.codespace', app.name);
   deleteBranch(appPath, app.name);
 }
 

package/cbb/worktrees/skills/{openspec-close-worktree → cbb-worktree-close}/scripts/discover-apps.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-close-worktree 发现关联应用 worktree
+ * cbb-worktree-close 发现关联应用 worktree
  *
  * 用法：node discover-apps.js <ws_root> <branch>
  *
- * 从 CONFIG.json 读取应用列表，扫描 .worktrees/worktree-<branch>/ 实际存在的子目录。
+ * 从 workspace-config.json 读取应用列表，扫描 .worktrees/worktree-<branch>/ 实际存在的子目录。
  *
  * 输出末行：DISCOVER_RESULT { workspace: <wt_path>, apps: [{name, repo, side, wt_path}] }
  *
@@ -26,9 +26,9 @@ if (!wsRoot || !branch) {
   process.exit(1);
 }
 
-const configPath = path.join(wsRoot, 'CONFIG.json');
+const configPath = path.join(wsRoot, 'workspace-config.json');
 if (!fs.existsSync(configPath)) {
-  console.error('❌ CONFIG.json 不存在：' + configPath);
+  console.error('❌ workspace-config.json 不存在：' + configPath);
   process.exit(1);
 }
 
@@ -36,7 +36,7 @@ let config;
 try {
   config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
 } catch (e) {
-  console.error('❌ CONFIG.json 解析失败：' + e.message);
+  console.error('❌ workspace-config.json 解析失败：' + e.message);
   process.exit(1);
 }
 
@@ -60,7 +60,7 @@ for (const app of apps) {
       repo: app.repo,
       side: app.side || 'back',
       wt_path: appWt,
-      app_path: path.join(wsRoot, '.code', app.name),
+      app_path: path.join(wsRoot, '.codespace', app.name),
     });
   } else {
     console.log('⏭️  ' + app.name + '：无关联 worktree，跳过');

package/cbb/worktrees/skills/{openspec-extend-worktree → cbb-worktree-close}/scripts/find-target-worktree.js

@@ -47,7 +47,7 @@ if (cwdMatch) {
 const worktreesDir = path.join(wsRoot, '.worktrees');
 if (!fs.existsSync(worktreesDir)) {
   console.error('❌ .worktrees 目录不存在：' + worktreesDir);
-  console.error('   请先执行 openspec-init-worktree 创建 worktree');
+  console.error('   请先执行 cbb-worktree-init 创建 worktree');
   console.log('---');
   console.log('NO_WORKTREE');
   process.exit(2);
@@ -65,7 +65,7 @@ const entries = fs.readdirSync(worktreesDir, { withFileTypes: true })
 
 if (entries.length === 0) {
   console.error('❌ 未找到任何 worktree');
-  console.error('   请先执行 openspec-init-worktree 创建 worktree');
+  console.error('   请先执行 cbb-worktree-init 创建 worktree');
   console.log('---');
   console.log('NO_WORKTREE');
   process.exit(2);

package/cbb/worktrees/skills/{openspec-push-worktrees → cbb-worktree-close}/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 内 CONFIG.json 副本干扰）
- * 兜底：当前目录含 CONFIG.json
+ * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 workspace-config.json 副本干扰）
+ * 兜底：当前目录含 workspace-config.json
  *
  * 退出码：
  *   0 - 定位成功，输出 WS_ROOT 绝对路径
@@ -44,19 +44,19 @@ if (worktreeList.ok) {
   }
 }
 
-// 兜底：当前目录含 CONFIG.json
+// 兜底：当前目录含 workspace-config.json
 if (!wsRoot) {
   const cwd = process.cwd();
-  if (fs.existsSync(path.join(cwd, 'CONFIG.json'))) {
+  if (fs.existsSync(path.join(cwd, 'workspace-config.json'))) {
     wsRoot = cwd;
   }
 }
 
 // 校验
-if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'CONFIG.json'))) {
+if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'workspace-config.json'))) {
   console.error('❌ 未找到工作空间根目录');
-  console.error('   原因：git worktree list 失败且当前目录无 CONFIG.json');
-  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 CONFIG.json）下执行本技能');
+  console.error('   原因：git worktree list 失败且当前目录无 workspace-config.json');
+  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 workspace-config.json）下执行本技能');
   process.exit(1);
 }
 

package/cbb/worktrees/skills/{openspec-close-worktree → cbb-worktree-close}/scripts/remove-worktrees.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-close-worktree 移除 Worktree（三层降级）
+ * cbb-worktree-close 移除 Worktree（三层降级）
  *
  * 用法：node remove-worktrees.js <ws_root> <branch> <force>
  *   force: "true" 启用 --force，"false" 不启用
@@ -83,7 +83,7 @@ function removeWt(repoPath, wtPath, name) {
 }
 
 // 1. 应用 worktrees
-const configPath = path.join(wsRoot, 'CONFIG.json');
+const configPath = path.join(wsRoot, 'workspace-config.json');
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
 
@@ -91,7 +91,7 @@ const apps = config.apps || [];
 console.log('=== 移除应用 Worktrees ===');
 for (const app of apps) {
   const appWt = path.join(wtDir, app.name);
-  const appPath = path.join(wsRoot, '.code', app.name);
+  const appPath = path.join(wsRoot, '.codespace', app.name);
   removeWt(appPath, appWt, app.name);
 }
 
@@ -101,7 +101,7 @@ removeWt(wsRoot, wtDir, 'workspace');
 
 // 3. 兜底：清理所有仓库的陈旧 worktree 元数据
 for (const app of apps) {
-  run('git worktree prune', path.join(wsRoot, '.code', app.name));
+  run('git worktree prune', path.join(wsRoot, '.codespace', app.name));
 }
 run('git worktree prune', wsRoot);
 

package/cbb/worktrees/skills/{openspec-close-worktree → cbb-worktree-close}/scripts/safety-check.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-close-worktree 安全检查 (合并判定 + 未提交修改 + 远程推送状态)
+ * cbb-worktree-close 安全检查 (合并判定 + 未提交修改 + 远程推送状态)
  */
 const { execSync } = require('child_process');
 const fs = require('fs');
@@ -144,7 +144,7 @@ function checkRepo(name, repoPath, wtPath) {
     } else {
       // @{u} 不存在（本地分支没建立 upstream）
       unpushedCount = -1;
-      console.log('WARN no upstream tracking branch (run openspec-push-worktrees to set up)');
+      console.log('WARN no upstream tracking branch (run cbb-worktree-push to set up)');
     }
   }
   console.log('');
@@ -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, 'CONFIG.json');
+const configPath = path.join(wsRoot, 'workspace-config.json');
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
 
@@ -165,7 +165,7 @@ results.push(checkRepo('workspace', wsRoot, wtDir));
 
 for (const app of apps) {
   const appWt = path.join(wtDir, app.name);
-  const appPath = path.join(wsRoot, '.code', app.name);
+  const appPath = path.join(wsRoot, '.codespace', app.name);
   results.push(checkRepo(app.name, appPath, appWt));
 }