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

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

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 创建 Worktree（含自愈清理）
+ * cbb-worktree-init 创建 Worktree（含自愈清理）
  *
- * 用法：node create-worktrees.js <ws_root> '<apps_json>' <branch>
+ * 用法：node create-worktrees.js <ws_root> <branch>
+ *   （apps 由脚本内部从 <ws_root>/workspace-config.json 读取）
  *
  * 行为：
  *   1. 自愈清理：prune + 物理目录清理
@@ -31,7 +32,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'));
@@ -41,7 +42,7 @@ function loadAppsFromConfig() {
 
 const apps = loadAppsFromConfig();
 if (!apps) {
-  console.error('❌ CONFIG.json 缺失或 apps 为空');
+  console.error('❌ workspace-config.json 缺失或 apps 为空');
   process.exit(1);
 }
 
@@ -57,7 +58,7 @@ function run(cmd, cwd) {
 console.log('=== 自愈清理 ===');
 
 // 1.1 prune 所有仓库
-const allRepos = [wsRoot, ...apps.map(a => path.join(wsRoot, '.code', a.name))];
+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);
@@ -114,7 +115,7 @@ if (fs.existsSync(wtDir)) {
 console.log('=== 创建 App Worktrees ===');
 const results = [];
 for (const app of apps) {
-  const appPath = path.join(wsRoot, '.code', app.name);
+  const appPath = path.join(wsRoot, '.codespace', app.name);
   const nestedWt = path.join(wtDir, app.name);
 
   if (fs.existsSync(nestedWt) && fs.existsSync(path.join(nestedWt, '.git'))) {
@@ -141,7 +142,7 @@ if (hasFailed) {
   console.error('⚠️  部分 app worktree 创建失败，需手动清理：');
   console.error('   cd ' + wsRoot + ' && git worktree remove .worktrees/worktree-' + branch);
   for (const r of results.filter(x => x.status === 'failed')) {
-    console.error('   git -C .code/' + r.name + ' worktree remove <worktree-path>');
+    console.error('   git -C .codespace/' + r.name + ' worktree remove <worktree-path>');
   }
   console.error('---');
   console.error('WORKTREE_RESULT', JSON.stringify(results));

package/cbb/worktrees/skills/{openspec-close-worktree → cbb-worktree-init}/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-init-worktree → cbb-worktree-init}/scripts/install-ai.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 在 worktree 中安装 AI 配置（必要步骤）
+ * cbb-worktree-init 在 worktree 中安装 AI 配置（必要步骤）
  *
  * 用法：node install-ai.js <wt_path>
  *
  * 行为：
- *   1. 检测 cbb 是否全局安装，未安装则自动安装
- *   2. 直接用 npm 全局 bin 路径调用 cbb（避免 PowerShell PATH 缓存）
- *   3. 在 worktree 内执行 cbb init --yes
+ *   1. 检测 cbbm 是否全局安装，未安装则自动安装
+ *   2. 直接用 npm 全局 bin 路径调用 cbbm（避免 PowerShell PATH 缓存）
+ *   3. 在 worktree 内执行 cbbm init --yes
  *   4. 失败则 exit 2，阻塞 init-worktree 流程（与 push-branches.js 语义一致）
  *
  * 退出码：
  *   0 - 成功
  *   1 - 参数错误（脚本 bug 或调用错误）
- *   2 - cbb init 执行失败（**阻塞 init-worktree**，用户必须手动恢复）
+ *   2 - cbbm init 执行失败（**阻塞 init-worktree**，用户必须手动恢复）
  */
 const { execSync } = require('child_process');
 const fs = require('fs');
@@ -40,11 +40,11 @@ function run(cmd, cwd, env) {
   }
 }
 
-// 查找 cbb 可执行文件：先 PATH，再 npm 全局 bin
+// 查找 cbbm 可执行文件：先 PATH，再 npm 全局 bin
 function findCbb() {
-  // 1. 直接调用 cbb --version
-  let r = run('cbb --version');
-  if (r.ok) return { cmd: 'cbb', version: r.out };
+  // 1. 直接调用 cbbm --version
+  let r = run('cbbm --version');
+  if (r.ok) return { cmd: 'cbbm', version: r.out };
 
   // 2. 查 npm 全局 bin 目录
   const npmRoot = run('npm root -g');
@@ -53,15 +53,15 @@ function findCbb() {
     // Unix: <npm_root>/../bin/cbb
     const candidates = [];
     if (process.platform === 'win32') {
-      candidates.push(path.join(npmRoot.out, 'cbb.cmd'));
-      candidates.push(path.join(npmRoot.out, '..', 'cbb.cmd'));
-      candidates.push(path.join(npmRoot.out, '..', 'bin', 'cbb.cmd'));
-      // npm 全局 bin 通常是 %APPDATA%\npm\cbb.cmd
-      const appdata = process.env.APPDATA || process.env.USERPROFILE;
-      if (appdata) candidates.push(path.join(appdata, 'npm', 'cbb.cmd'));
-    } else {
-      candidates.push(path.join(npmRoot.out, '..', 'bin', 'cbb'));
-      candidates.push(path.join(npmRoot.out, '..', 'cbb'));
+        candidates.push(path.join(npmRoot.out, 'cbbm.cmd'));
+        candidates.push(path.join(npmRoot.out, '..', 'cbbm.cmd'));
+        candidates.push(path.join(npmRoot.out, '..', 'bin', 'cbbm.cmd'));
+        // npm 全局 bin 通常是 %APPDATA%\npm\cbbm.cmd
+        const appdata = process.env.APPDATA || process.env.USERPROFILE;
+        if (appdata) candidates.push(path.join(appdata, 'npm', 'cbbm.cmd'));
+      } else {
+        candidates.push(path.join(npmRoot.out, '..', 'bin', 'cbbm'));
+        candidates.push(path.join(npmRoot.out, '..', 'cbbm'));
     }
     for (const c of candidates) {
       if (fs.existsSync(c)) {
@@ -77,7 +77,7 @@ function findCbb() {
 // 1. 检测/安装 cbb
 let cbbInfo = findCbb();
 if (!cbbInfo) {
-  console.log('WARN: cbb not globally installed, try auto-install...');
+  console.log('WARN: cbbm not globally installed, try auto-install...');
   const install = run('npm install -g @jspg-ai/coding-bb');
   if (!install.ok) {
     console.error('ERROR: cbb auto-install failed: ' + install.err);
@@ -85,7 +85,7 @@ if (!cbbInfo) {
     console.error('━━━ init-worktree 已中断 ━━━');
     console.error('请手动安装 cbb 后重跑 init-worktree：');
     console.error('  1. npm install -g @jspg-ai/coding-bb');
-    console.error('  2. cd "' + wtPath + '" && cbb init --yes');
+    console.error('  2. cd "' + wtPath + '" && cbbm init --yes');
     console.error('  3. 在 ai-workspace 根目录重跑 init-worktree');
     console.log('---');
     console.log('AI_INIT_FAILED');
@@ -98,8 +98,8 @@ if (!cbbInfo) {
     const npmRoot = run('npm root -g');
     if (npmRoot.ok) {
       const candidates = process.platform === 'win32'
-        ? [path.join(npmRoot.out, '..', 'cbb.cmd'), path.join(npmRoot.out, '..', 'bin', 'cbb.cmd')]
-        : [path.join(npmRoot.out, '..', 'bin', 'cbb')];
+        ? [path.join(npmRoot.out, '..', 'cbbm.cmd'), path.join(npmRoot.out, '..', 'bin', 'cbbm.cmd')]
+        : [path.join(npmRoot.out, '..', 'bin', 'cbbm')];
       for (const c of candidates) {
         if (fs.existsSync(c)) {
           cbbInfo = { cmd: '"' + c + '"', version: 'located at ' + c };
@@ -109,26 +109,26 @@ if (!cbbInfo) {
     }
   }
   if (!cbbInfo) {
-    console.error('ERROR: cbb not found after install. Likely npm PATH cache issue.');
+    console.error('ERROR: cbbm not found after install. Likely npm PATH cache issue.');
     console.error('');
     console.error('━━━ init-worktree 已中断 ━━━');
     console.error('可能原因：npm 全局 bin 目录不在当前 shell 的 PATH 中。');
     console.error('手动恢复步骤：');
-    console.error('  1. 重启终端让 PATH 生效，或手动定位 cbb：');
+    console.error('  1. 重启终端让 PATH 生效，或手动定位 cbbm：');
     console.error('     npm root -g          # 拿到全局 node_modules 路径');
-    console.error('     <path>/../cbb.cmd # Windows / <path>/../bin/cbb  # Unix');
-    console.error('  2. cd "' + wtPath + '" && cbb init --yes');
+    console.error('     <path>/../cbbm.cmd # Windows / <path>/../bin/cbbm  # Unix');
+    console.error('  2. cd "' + wtPath + '" && cbbm init --yes');
     console.error('  3. 在 ai-workspace 根目录重跑 init-worktree');
     console.log('---');
     console.log('AI_INIT_FAILED');
     process.exit(2);
   }
-  console.log('OK: cbb located: ' + cbbInfo.version);
+  console.log('OK: cbbm located: ' + cbbInfo.version);
 } else {
-  console.log('OK: cbb found: ' + cbbInfo.version);
+  console.log('OK: cbbm found: ' + cbbInfo.version);
 }
 
-// 2. 在 worktree 中执行 cbb init --yes
+// 2. 在 worktree 中执行 cbbm init --yes
 console.log('Installing AI config in worktree: ' + wtPath);
 const initCmd = cbbInfo.cmd + ' init --yes';
 const init = run(initCmd, wtPath);
@@ -145,21 +145,21 @@ if (init.ok) {
   console.error('ERROR: AI config install failed: ' + init.err);
   console.error('');
   console.error('━━━ init-worktree 已中断 ━━━');
-  console.error('原因：cbb init 是必要步骤。AI 配置缺失将导致后续 openspec-* ');
+  console.error('原因：cbbm init 是必要步骤。AI 配置缺失将导致后续 openspec-* ');
   console.error('     （propose/apply/verify/ff 等）技能全部不可用。');
   console.error('');
   console.error('━━━ 手动恢复步骤（请按顺序执行）━━━');
   console.error('');
   console.error('1. 验证环境');
-  console.error('   $ cbb --version');
+  console.error('   $ cbbm --version');
   console.error('   $ node --version    # 需要 >= 16.7.0');
   console.error('');
-  console.error('2. 若 cbb 未安装，先安装');
+  console.error('2. 若未安装（cbbm 不在 PATH），先安装');
   console.error('   $ npm install -g @jspg-ai/coding-bb');
   console.error('');
   console.error('3. 进入 worktree 并初始化 AI 配置');
   console.error('   $ cd "' + wtPath + '"');
-  console.error('   $ cbb init --yes');
+  console.error('   $ cbbm init --yes');
   console.error('');
   console.error('4. 重新执行 init-worktree');
   console.error('   在 ai-workspace 根目录重跑，会跳过已初始化的部分');

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/scripts/parse-config.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 读取并校验 CONFIG.json
+ * cbb-worktree-init 读取并校验 workspace-config.json
  *
  * 退出码：
  *   0 - 成功，输出应用列表 JSON
@@ -15,10 +15,10 @@ require('./silence-popup');
 const fs = require('fs');
 const path = require('path');
 
-const configPath = path.join(process.cwd(), 'CONFIG.json');
+const configPath = path.join(process.cwd(), 'workspace-config.json');
 
 if (!fs.existsSync(configPath)) {
-  console.error('❌ CONFIG.json 不存在');
+  console.error('❌ workspace-config.json 不存在');
   console.error('   请先在 cbb setup 阶段创建，或手动配置');
   console.error('---');
   console.error('CONFIG_MISSING');
@@ -29,7 +29,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);
   console.error('   请检查 JSON 格式');
   console.error('---');
   console.error('CONFIG_INVALID');
@@ -38,8 +38,8 @@ try {
 
 const apps = config.apps || [];
 if (apps.length === 0) {
-  console.error('❌ CONFIG.json 中 apps 为空');
-  console.error('   请编辑 CONFIG.json 配置关联应用');
+  console.error('❌ workspace-config.json 中 apps 为空');
+  console.error('   请编辑 workspace-config.json 配置关联应用');
   console.error('---');
   console.error('CONFIG_EMPTY');
   process.exit(2);
@@ -61,7 +61,7 @@ for (const app of apps) {
   }
 }
 
-console.log('✅ CONFIG.json 有效（' + apps.length + ' 个应用）');
+console.log('✅ workspace-config.json 有效（' + apps.length + ' 个应用）');
 console.log('---');
 console.log('CONFIG_OK', JSON.stringify(apps));
 process.exit(0);

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

@@ -1,9 +1,9 @@
 require('./silence-popup');
 /**
- * openspec-init-worktree 推送并建立 upstream
+ * cbb-worktree-init 推送并建立 upstream
  *
  * 薄壳脚本：核心 push 逻辑委托给同目录的 push-core.js（共享脚本，源仓库真源在 _shared/scripts/）。
- * 本脚本只负责 CLI 入口编排（编排 init-worktree 关注的 workspace + .code/<app>/ 列表）。
+ * 本脚本只负责 CLI 入口编排（编排 init-worktree 关注的 workspace + .codespace/<app>/ 列表）。
  *
  * Usage: node push-branches.js <ws_root> <branch>
  *
@@ -12,7 +12,7 @@ require('./silence-popup');
  *   1 - 参数错误（CONFIG 缺失或 argv 不足）
  *   2 - 部分/全部失败（AI agent 必须阻塞流程）
  *
- * 新场景（开发完成后跨 worktree 推送）请使用 openspec-push-worktrees/scripts/push-worktrees.js。
+ * 新场景（开发完成后跨 worktree 推送）请使用 cbb-worktree-push/scripts/push-worktrees.js。
  */
 
 const { pushSingle, classifyError, collectRemoteMetadata } = require('./push-core');
@@ -20,7 +20,7 @@ const fs = require('fs');
 const path = require('path');
 
 function loadAppsFromConfig(wsRoot) {
-  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'));
@@ -40,7 +40,7 @@ function executePush(opts) {
   const branch = opts.branch;
   const apps = opts.apps != null ? opts.apps : loadAppsFromConfig(wsRoot);
   if (apps == null) {
-    throw new Error('CONFIG.json missing or apps empty');
+    throw new Error('workspace-config.json missing or apps empty');
   }
 
   const results = [];
@@ -48,7 +48,7 @@ function executePush(opts) {
   results.push(pushSingle(wsRoot, 'workspace', branch, { execSyncImpl: opts.execSyncImpl }));
   // apps
   for (const app of apps) {
-    const appPath = path.join(wsRoot, '.code', app.name);
+    const appPath = path.join(wsRoot, '.codespace', app.name);
     results.push(pushSingle(appPath, app.name, branch, { execSyncImpl: opts.execSyncImpl }));
   }
   return results;
@@ -68,7 +68,7 @@ function main() {
 
   const apps = loadAppsFromConfig(wsRoot);
   if (apps == null) {
-    console.error('❌ CONFIG.json 缺失或 apps 为空');
+    console.error('❌ workspace-config.json 缺失或 apps 为空');
     process.exit(1);
   }
 
@@ -81,6 +81,8 @@ function main() {
   for (const r of results) {
     if (r.status === 'pushed') {
       console.log('✅ ' + r.name + ': 已推送 ' + r.upstream);
+    } else if (r.status === 'skipped') {
+      console.log('⏭️  ' + r.name + ': 远程分支与本地一致，跳过推送');
     } else if (r.status === 'remote-exists') {
       console.log('⚠️  ' + r.name + ': 远程分支已存在（需用户决策）');
     } else {

package/cbb/worktrees/skills/{openspec-extend-worktree → cbb-worktree-init}/scripts/push-core.js

@@ -12,6 +12,12 @@ require('./silence-popup');
  *   - pushSingle(repoPath, repoName, branch)  推送单个仓库并建立 upstream
  *   - collectRemoteMetadata(repoPath, branch, remote)  采集远程 commit 元信息
  *
+ * pushSingle 状态契约：
+ *   - pushed                 本次推送成功（新建分支或快进）
+ *   - skipped                远程同名分支已存在且与本地一致 → 无需推送（幂等，重跑 init 场景）
+ *   - remote-exists          远程同名分支存在但与本地不一致 → 需用户决策（附 metadata）
+ *   - failed                 推送失败，error 见错误码契约
+ *
  * 错误码契约（classifyError 输出）：
  *   - ssh-auth-failed        Permission denied (publickey)
  *   - https-auth-failed      Authentication failed
@@ -115,6 +121,18 @@ function pushSingle(repoPath, repoName, branch, opts) {
   const r = remote.out.split(/\r?\n/)[0];
   const branchEsc = escapeBranch(branch);
   const remoteEsc = '"' + String(r).replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+
+  // 幂等：远程同名分支已存在且 hash 与本地完全一致 → 此前已推送，直接跳过。
+  // 让 init-worktree 可安全重跑（补齐新增应用/中断恢复），且不会重复推送或误报 remote-exists。
+  const lsRemote = tryExec('git ls-remote --heads ' + remoteEsc + ' ' + escapeBranch('refs/heads/' + branch), repoPath, execImpl);
+  if (lsRemote.ok && lsRemote.out) {
+    const remoteHash = lsRemote.out.split(/\s+/)[0];
+    const localHash = tryExec('git rev-parse --verify ' + branchEsc, repoPath, execImpl);
+    if (localHash.ok && localHash.out && localHash.out === remoteHash) {
+      return { name: repoName, status: 'skipped', upstream: r + '/' + branch, message: '远程分支与本地一致，无需推送' };
+    }
+  }
+
   const pushResult = tryExec('git push -u ' + remoteEsc + ' ' + branchEsc, repoPath, execImpl);
   if (pushResult.ok) {
     return { name: repoName, status: 'pushed', upstream: r + '/' + branch };

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

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 同步 .code/ 仓库
+ * cbb-worktree-init 同步 .codespace/ 仓库
  *
- * 用法：node sync-repos.js <ws_root> '<apps_json>'
- *   - ws_root: 工作空间根绝对路径
- *   - apps_json: 应用列表 JSON 数组（来自 parse-config.js）
+ * 用法：node sync-repos.js <ws_root>
+ *   - ws_root: 工作空间根绝对路径（apps 从 <ws_root>/workspace-config.json 读取）
  *
  * 对每个 app：
- *   - .code/<name>/.git 存在 → fetch --all
+ *   - .codespace/<name>/.git 存在 → fetch --all
  *   - 不存在 → clone（从 repo URL）
  *
  * 退出码：
@@ -22,7 +21,6 @@ const fs = require('fs');
 const path = require('path');
 
 const wsRoot = process.argv[2];
-const appsJson = process.argv[3];
 
 if (!wsRoot) {
   console.error('❌ 用法：node sync-repos.js <ws_root>');
@@ -30,23 +28,23 @@ if (!wsRoot) {
 }
 
 /**
- * 从 CONFIG.json 读取 apps（避免 shell 字符串传递中的转义问题）
+ * 从 workspace-config.json 读取 apps（避免 shell 字符串传递中的转义问题）
  */
 function loadAppsFromConfig() {
-  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);
     return null;
   }
   try {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
     if (!config.apps || !Array.isArray(config.apps) || config.apps.length === 0) {
-      console.error('❌ CONFIG.json 中 apps 为空');
+      console.error('❌ workspace-config.json 中 apps 为空');
       return null;
     }
     return config.apps;
   } catch (e) {
-    console.error('❌ CONFIG.json 解析失败：' + e.message);
+    console.error('❌ workspace-config.json 解析失败：' + e.message);
     return null;
   }
 }
@@ -56,7 +54,7 @@ if (!apps) {
   process.exit(1);
 }
 
-const codeDir = path.join(wsRoot, '.code');
+const codeDir = path.join(wsRoot, '.codespace');
 fs.mkdirSync(codeDir, { recursive: true });
 
 const results = [];

package/cbb/worktrees/skills/{openspec-init-worktree → cbb-worktree-init}/scripts/update-gitignore.js

@@ -1,19 +1,22 @@
 #!/usr/bin/env node
 require('./silence-popup');
 /**
- * openspec-init-worktree 安全更新 .gitignore
+ * cbb-worktree-init 安全更新 .gitignore
  *
  * 用法：node update-gitignore.js <ws_root> <branch>
  *
  * 行为：
  *   1. stash 当前未提交修改
  *   2. 切换到目标分支
- *   3. 检查 .worktrees/ 和 .code/ 是否在 .gitignore
+ *   3. 检查 .worktrees/ 和 .codespace/ 是否在 .gitignore
  *   4. 添加缺失条目
  *   5. 提交 .gitignore
  *   6. 切回原分支
  *   7. pop stash（如有）
  *
+ * 幂等：目标分支已在某个 worktree 中检出（init-worktree 重跑场景，上次已处理过
+ * .gitignore）时，跳过全部操作直接输出 GITIGNORE_OK——避免 checkout 与 worktree 检出冲突。
+ *
  * 退出码：
  *   0 - 成功
  *   1 - 参数错误
@@ -48,6 +51,16 @@ if (!origBranch.ok) {
 }
 console.log('当前分支：' + origBranch.out);
 
+// 1.1 幂等检查：目标分支已被某 worktree 检出 → 上次 init-worktree 已处理 .gitignore
+const wtList = run('git worktree list --porcelain', wsRoot);
+const branchInWorktree = wtList.ok && wtList.out.split(/\r?\n/).some(l => l.trim() === 'branch refs/heads/' + branch);
+if (branchInWorktree) {
+  console.log('ℹ️  分支 ' + branch + ' 已在 worktree 中检出（init-worktree 重跑场景），跳过 .gitignore 处理');
+  console.log('---');
+  console.log('GITIGNORE_OK');
+  process.exit(0);
+}
+
 // 2. stash 当前未提交修改
 let stashed = false;
 const status = run('git status --porcelain', wsRoot);
@@ -73,13 +86,13 @@ if (!checkout.ok) {
 }
 console.log('✅ 切换到分支：' + branch);
 
-// 4. 检查并添加 .worktrees/ 和 .code/ 到 .gitignore
+// 4. 检查并添加 .worktrees/ 和 .codespace/ 到 .gitignore
 const gitignorePath = path.join(wsRoot, '.gitignore');
 let content = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
 const original = content;
 const needCommit = [];
 
-for (const dir of ['.worktrees/', '.code/']) {
+for (const dir of ['.worktrees/', '.codespace/']) {
   const check = run('git check-ignore -q "' + dir + '"', wsRoot);
   if (!check.ok) {
     // 未忽略：添加
@@ -90,7 +103,7 @@ for (const dir of ['.worktrees/', '.code/']) {
 }
 
 if (needCommit.length === 0) {
-  console.log('ℹ️  .worktrees/ 和 .code/ 均已在 .gitignore 中，跳过提交');
+  console.log('ℹ️  .worktrees/ 和 .codespace/ 均已在 .gitignore 中，跳过提交');
 } else {
   fs.writeFileSync(gitignorePath, content);
   console.log('✅ .gitignore 已添加：' + needCommit.join(', '));
@@ -101,7 +114,7 @@ if (needCommit.length === 0) {
     if (stashed) run('git stash pop', wsRoot);
     process.exit(2);
   }
-  const commit = run('git commit -m "chore: add .worktrees/ and .code/ to gitignore"', wsRoot);
+  const commit = run('git commit -m "chore: add .worktrees/ and .codespace/ to gitignore"', wsRoot);
   if (!commit.ok) {
     console.error('❌ git commit 失败：' + commit.err);
     run('git checkout "' + origBranch.out + '"', wsRoot);

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

@@ -1,5 +1,5 @@
 ---
-name: openspec-push-worktrees
+name: cbb-worktree-push
 description: "跨 worktree 提交并推送当前需求的所有关联仓库。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-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).
@@ -11,17 +11,17 @@ metadata:
 
 # Push Worktrees（跨平台脚本化版本 v1.0）
 
-跨 worktree 提交并推送当前需求的所有关联仓库到 origin。专门解决"开发完成后批量推送"和"用户口语化提交并push"两类场景，弥补 [openspec-init-worktree Step 3.4](file:///d:/workspace/va-ai/coding-bb/cbb/worktrees/skills/openspec-init-worktree/SKILL.md) 仅推送初始空 commit 的缺口。
+跨 worktree 提交并推送当前需求的所有关联仓库到 origin。专门解决"开发完成后批量推送"和"用户口语化提交并push"两类场景，弥补 [cbb-worktree-init Step 3.4](file:///d:/workspace/va-ai/coding-bb/cbb/worktrees/skills/cbb-worktree-init/SKILL.md) 仅推送初始空 commit 的缺口。
 
-**启动时声明：** "我正在使用 openspec-push-worktrees 技能来批量提交并推送当前需求的所有 worktree 仓库。"
+**启动时声明：** "我正在使用 cbb-worktree-push 技能来批量提交并推送当前需求的所有 worktree 仓库。"
 
 ## 核心原则
 
 - 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**
 - **两阶段**：先 `commit-worktrees.js` 提交所有 dirty 仓库，再 `push-worktrees.js` 推送所有 worktree 仓库。两个脚本独立退出码，AI agent 区分阶段
-- 复用 `openspec-push-worktrees/scripts/push-core.js` 的 `pushSingle` / `classifyError` —— 与 `openspec-init-worktree` 的 `push-branches.js` 行为完全一致，错误码契约统一
-- `find-workspace-root.js` / `find-target-worktree.js` 为共享脚本：源仓库真源在 `cbb/worktrees/_shared/scripts/`，部署后位于本 skill 的 `scripts/` 下，与 `openspec-extend-worktree` / `openspec-close-worktree` 逻辑完全一致
-- **本技能支持两层执行位置**（与 `openspec-close-worktree` 对称）：
+- 复用 `cbb-worktree-push/scripts/push-core.js` 的 `pushSingle` / `classifyError` —— 与 `cbb-worktree-init` 的 `push-branches.js` 行为完全一致，错误码契约统一
+- `find-workspace-root.js` / `find-target-worktree.js` 为共享脚本：源仓库真源在 `cbb/worktrees/_shared/scripts/`，部署后位于本 skill 的 `scripts/` 下，与 `cbb-worktree-init` / `cbb-worktree-close` 逻辑完全一致
+- **本技能支持两层执行位置**（与 `cbb-worktree-close` 对称）：
   - 工作空间根目录（`WS_ROOT/`）
   - worktree 内部（`WS_ROOT/.worktrees/worktree-<需求名>/` 或其子目录）
 - 输入约定：**自由文本**（commit 信息、需求名等）直接在对话中提问并等待回复；**固定选项多选**（如 "应用统一信息 vs 分别信息"）使用 `AskUserQuestion`
@@ -33,7 +33,7 @@ metadata:
 **所有脚本必须用绝对路径调用**（Qoder 沙箱中 AI agent 的 cwd 不一定是技能目录）。
 
 ```
-node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/<name>.js" <参数>
+node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/<name>.js" <参数>
 ```
 
 脚本输出：
@@ -46,7 +46,7 @@ node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/<name>.js" <参数
 ## Step 0：定位工作空间
 
 ```bash
-node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/find-workspace-root.js"
+node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/find-workspace-root.js"
 ```
 
 **解读末行**：
@@ -58,13 +58,13 @@ node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/find-workspace-roo
 ## Step 1：识别目标 worktree
 
 ```bash
-node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/find-target-worktree.js" "<ws_root>"
+node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/find-target-worktree.js" "<ws_root>"
 ```
 
 **解读末行**：
 - 退出码 0 + 末行（需求名） → 唯一识别，自动用之
 - 退出码 1 + 末行 `MULTIPLE_WORKTREEES` → 多个 worktree，AI agent 在对话中让用户输入序号或分支名
-- 退出码 2 + 末行 `NO_WORKTREE` → 无 worktree，提示用户先用 `openspec-init-worktree`
+- 退出码 2 + 末行 `NO_WORKTREE` → 无 worktree，提示用户先用 `cbb-worktree-init`
 
 ---
 
@@ -72,7 +72,7 @@ node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/find-target-worktr
 
 ```bash
 # 仅 commit 阶段先做 dry-run 预览
-node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "preview" --dry-run
+node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "preview" --dry-run
 ```
 
 **解读末行 `COMMIT_RESULT`**：每项仓库的状态
@@ -94,7 +94,7 @@ AI agent 在执行真实 commit 前**必须**在对话中向用户确认 commit
 
 ```
 检测到以下 worktree 仓库有未提交改动：
-  - workspace: 5 个文件（CONFIG.json, openspec/changes/foo/...）
+  - workspace: 5 个文件（workspace-config.json, openspec/changes/foo/...）
   - ep-foo-app: 12 个文件
   - ep-bar-app: 3 个文件
 
@@ -119,7 +119,7 @@ AI agent 在执行真实 commit 前**必须**在对话中向用户确认 commit
 
 ```bash
 # 统一信息
-node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "feat(<branch>): 实现客户运费逻辑"
+node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "feat(<branch>): 实现客户运费逻辑"
 
 # 多仓库分别
 node "..." "<ws_root>" "<branch>" --per-repo "ep-foo-app:feat(<branch>): 实现 saveClientExpectFreight;ep-bar-app:refactor(<branch>): 拆分 PlanService"
@@ -155,7 +155,7 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>" --message "..."
 ## Step 5：批量 push
 
 ```bash
-node "<ws_root>/.qoder/skills/openspec-push-worktrees/scripts/push-worktrees.js" "<ws_root>" "<branch>"
+node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/push-worktrees.js" "<ws_root>" "<branch>"
 
 # 或 wt_path 形式
 node "..." "<ws_root>/.worktrees/worktree-<branch>"
@@ -211,7 +211,7 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
     ep-foo-app: ✅ origin/<branch>
     ep-bar-app: ⚠️  远程分支已存在（需用户决策 → 已关联）
   AI 配置目录：worktree 内独立安装，无需处理
-  后续：可继续开发 / 调 /opsx:verify 验证 / 调 /opsx:archive 归档 / 调 /opsx:close 关闭
+  后续：可继续开发 / 调 /opsx:verify 验证 / 调 /opsx:archive 归档 / 调 /cbb:worktree-close 关闭
 ```
 
 ---
@@ -258,7 +258,7 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 
 ### 多仓库用同一条 commit 信息
 
-- **问题：** workspace 改了 CONFIG.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
+- **问题：** workspace 改了 workspace-config.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
 - **修复：** 用 `--per-repo` 模式，让用户逐仓库提供
 
 ### push 失败时跳过失败仓库直接继续