@jspg-ai/coding-bb 0.0.3-beta.33 → 0.0.3-beta.35

package/cbb/worktrees/skills/cbb-worktree-close/scripts/delete-branches.js

@@ -1,138 +1,147 @@
-#!/usr/bin/env node
-require('./silence-popup');
-/**
- * cbb-worktree-close 删除分支 (按用户选择)
- */
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const wsRoot = process.argv[2];
-const branch = process.argv[3];
-const mode = process.argv[4];
-
-if (!wsRoot || !branch || !mode) {
-  console.error('Usage: node delete-branches.js <ws_root> <branch> <mode>');
-  process.exit(1);
-}
-
-if (mode === 'keep') {
-  console.log('Keep branch, skip delete');
-  console.log('---');
-  console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode: 'keep', deleted: [] }));
-  process.exit(0);
-}
-
-if (mode !== 'local' && mode !== 'local_remote') {
-  console.error('mode must be keep / local / local_remote');
-  process.exit(1);
-}
-
-function run(cmd, cwd, env) {
-  try {
-    return { ok: true, out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env, ...(env || {}) } }).trim() };
-  } catch (e) {
-    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
-  }
-}
-
-function detectMain(repoPath) {
-  const remote = run('git remote', repoPath);
-  if (!remote.ok || !remote.out) return 'main';
-  const r = remote.out.split(/\r?\n/)[0];
-  const symbolic = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', repoPath);
-  if (symbolic.ok && symbolic.out) {
-    return symbolic.out.replace('refs/remotes/' + r + '/', '');
-  }
-  return 'main';
-}
-
-function mergedTo(repoPath, from, to) {
-  // 0=merged, 1=unmerged, 2=to-ref-missing
-  if (!run('git rev-parse --verify --quiet "' + from + '"', repoPath).ok) return 1;
-  if (!run('git rev-parse --verify --quiet "' + to + '"', repoPath).ok) return 2;
-  if (run('git merge-base --is-ancestor "' + from + '" "' + to + '" && echo Y', repoPath).out === 'Y') return 0;
-  // 跨平台：不用 grep（Windows 无 grep），解析 git cherry 输出（+ 前缀 = 未合并提交）
-  const cherry = run('git cherry "' + to + '" "' + from + '"', repoPath);
-  if (!cherry.ok) return 1;
-  if (cherry.out.split(/\r?\n/).filter(Boolean).some(l => l.indexOf('+') === 0)) return 1;
-  return 0;
-}
-
-function mergedToMain(repoPath, branchName, main) {
-  if (mergedTo(repoPath, branchName, main) === 0) return true;
-  if (mergedTo(repoPath, branchName, 'origin/' + main) === 0) return true;
-  // release-* transit
-  const releaseList = run('git for-each-ref --format="%(refname:short)" "refs/heads/release-*" "refs/remotes/origin/release-*"', repoPath);
-  if (releaseList.ok && releaseList.out) {
-    const releases = releaseList.out.split(/\r?\n/).filter(Boolean).sort();
-    for (const rel of releases) {
-      if (mergedTo(repoPath, branchName, rel) === 0) {
-        if (mergedTo(repoPath, rel, main) === 0) return true;
-        if (mergedTo(repoPath, rel, 'origin/' + main) === 0) return true;
-      }
-    }
-  }
-  return false;
-}
-
-function deleteBranch(repoPath, name) {
-  const checkLocal = run('git branch --list "' + branch + '"', repoPath);
-  if (checkLocal.ok && checkLocal.out) {
-    const main = detectMain(repoPath);
-    const merged = main ? mergedToMain(repoPath, branch, main) : false;
-    let flag = merged ? '-d' : '-D';
-    const del = run('git branch ' + flag + ' "' + branch + '"', repoPath);
-    if (del.ok) {
-      console.log('OK ' + name + ' local branch deleted (' + flag + ', ' + (merged ? 'merged' : 'unmerged') + ')');
-    } else {
-      if (flag === '-d') {
-        const fallback = run('git branch -D "' + branch + '"', repoPath);
-        if (fallback.ok) {
-          console.log('OK ' + name + ' local branch deleted (squash merge, fallback -D)');
-        } else {
-          console.error('FAIL ' + name + ' local branch delete failed');
-          return false;
-        }
-      } else {
-        console.error('FAIL ' + name + ' local branch delete failed');
-        return false;
-      }
-    }
-  } else {
-    console.log('Skip ' + name + ': no local branch ' + branch);
-  }
-
-  if (mode === 'local_remote') {
-    const remote = run('git remote', repoPath);
-    if (remote.ok && remote.out) {
-      const r = remote.out.split(/\r?\n/)[0];
-      const pushDel = run('git push "' + r + '" --delete "' + branch + '"', repoPath, { GIT_TERMINAL_PROMPT: '0' });
-      if (pushDel.ok) {
-        console.log('OK ' + name + ' remote branch deleted');
-      } else {
-        console.log('Skip ' + name + ': remote has no ' + branch);
-      }
-    }
-  }
-  return true;
-}
-
-const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
-let config = {};
-try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
-
-const apps = config.apps || [];
-
-console.log('=== Delete Workspace Branch ===');
-deleteBranch(wsRoot, 'workspace');
-
-console.log('=== Delete App Branches ===');
-for (const app of apps) {
-  const appPath = path.join(wsRoot, '.codespace', app.name);
-  deleteBranch(appPath, app.name);
-}
-
-console.log('---');
-console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode, ok: true }));
-process.exit(0);
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * 删除需求分支（共享脚本，真源：cbb/worktrees/_shared/scripts/）
+ *
+ * 供 cbb-worktree-close（Step 4.4 交付完成后自动删本地 + 远程分支）与
+ * cbb-local-mode（Step 5.4 收尾删远程分支）调用。
+ *
+ * 用法：node delete-branches.js <ws_root> <branch> <mode>   # mode: keep / local / local_remote
+ *
+ * 逐仓库执行：本地分支按合并判定选 -d / -D（squash 合并 -d 失败回退 -D）；
+ * local_remote 模式追加 git push <remote> --delete。
+ * 清理阶段失败报告并继续其余仓库，不回滚（ADR 0007）。
+ */
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const branch = process.argv[3];
+const mode = process.argv[4];
+
+if (!wsRoot || !branch || !mode) {
+  console.error('Usage: node delete-branches.js <ws_root> <branch> <mode>');
+  process.exit(1);
+}
+
+if (mode === 'keep') {
+  console.log('Keep branch, skip delete');
+  console.log('---');
+  console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode: 'keep', ok: true, deleted: [] }));
+  process.exit(0);
+}
+
+if (mode !== 'local' && mode !== 'local_remote') {
+  console.error('mode must be keep / local / local_remote');
+  process.exit(1);
+}
+
+function run(cmd, cwd, env) {
+  try {
+    return { ok: true, out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env, ...(env || {}) } }).trim() };
+  } catch (e) {
+    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
+  }
+}
+
+function detectMain(repoPath) {
+  const remote = run('git remote', repoPath);
+  if (!remote.ok || !remote.out) return 'main';
+  const r = remote.out.split(/\r?\n/)[0];
+  const symbolic = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', repoPath);
+  if (symbolic.ok && symbolic.out) {
+    return symbolic.out.replace('refs/remotes/' + r + '/', '');
+  }
+  return 'main';
+}
+
+function mergedTo(repoPath, from, to) {
+  // 0=merged, 1=unmerged, 2=to-ref-missing
+  if (!run('git rev-parse --verify --quiet "' + from + '"', repoPath).ok) return 1;
+  if (!run('git rev-parse --verify --quiet "' + to + '"', repoPath).ok) return 2;
+  if (run('git merge-base --is-ancestor "' + from + '" "' + to + '" && echo Y', repoPath).out === 'Y') return 0;
+  // 跨平台：不用 grep（Windows 无 grep），解析 git cherry 输出（+ 前缀 = 未合并提交）
+  const cherry = run('git cherry "' + to + '" "' + from + '"', repoPath);
+  if (!cherry.ok) return 1;
+  if (cherry.out.split(/\r?\n/).filter(Boolean).some(l => l.indexOf('+') === 0)) return 1;
+  return 0;
+}
+
+function mergedToMain(repoPath, branchName, main) {
+  if (mergedTo(repoPath, branchName, main) === 0) return true;
+  if (mergedTo(repoPath, branchName, 'origin/' + main) === 0) return true;
+  // release-* transit
+  const releaseList = run('git for-each-ref --format="%(refname:short)" "refs/heads/release-*" "refs/remotes/origin/release-*"', repoPath);
+  if (releaseList.ok && releaseList.out) {
+    const releases = releaseList.out.split(/\r?\n/).filter(Boolean).sort();
+    for (const rel of releases) {
+      if (mergedTo(repoPath, branchName, rel) === 0) {
+        if (mergedTo(repoPath, rel, main) === 0) return true;
+        if (mergedTo(repoPath, rel, 'origin/' + main) === 0) return true;
+      }
+    }
+  }
+  return false;
+}
+
+function deleteBranch(repoPath, name) {
+  const checkLocal = run('git branch --list "' + branch + '"', repoPath);
+  if (checkLocal.ok && checkLocal.out) {
+    const main = detectMain(repoPath);
+    const merged = main ? mergedToMain(repoPath, branch, main) : false;
+    let flag = merged ? '-d' : '-D';
+    const del = run('git branch ' + flag + ' "' + branch + '"', repoPath);
+    if (del.ok) {
+      console.log('OK ' + name + ' local branch deleted (' + flag + ', ' + (merged ? 'merged' : 'unmerged') + ')');
+    } else {
+      if (flag === '-d') {
+        const fallback = run('git branch -D "' + branch + '"', repoPath);
+        if (fallback.ok) {
+          console.log('OK ' + name + ' local branch deleted (squash merge, fallback -D)');
+        } else {
+          console.error('FAIL ' + name + ' local branch delete failed');
+          return false;
+        }
+      } else {
+        console.error('FAIL ' + name + ' local branch delete failed');
+        return false;
+      }
+    }
+  } else {
+    console.log('Skip ' + name + ': no local branch ' + branch);
+  }
+
+  if (mode === 'local_remote') {
+    const remote = run('git remote', repoPath);
+    if (remote.ok && remote.out) {
+      const r = remote.out.split(/\r?\n/)[0];
+      const pushDel = run('git push "' + r + '" --delete "' + branch + '"', repoPath, { GIT_TERMINAL_PROMPT: '0' });
+      if (pushDel.ok) {
+        console.log('OK ' + name + ' remote branch deleted');
+      } else {
+        console.log('Skip ' + name + ': remote has no ' + branch);
+      }
+    }
+  }
+  return true;
+}
+
+const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
+let config = {};
+try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch (e) {}
+
+const apps = config.apps || [];
+
+console.log('=== Delete Workspace Branch ===');
+deleteBranch(wsRoot, 'workspace');
+
+console.log('=== Delete App Branches ===');
+for (const app of apps) {
+  const appPath = path.join(wsRoot, '.codespace', app.name);
+  deleteBranch(appPath, app.name);
+}
+
+console.log('---');
+console.log('BRANCH_DELETE_RESULT', JSON.stringify({ mode, ok: true }));
+process.exit(0);

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

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 目标需求名识别
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/find-target-worktree.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（extend / close / push）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（close / push）。
  *
  * 用法：node find-target-worktree.js <ws_root>
  *

package/cbb/worktrees/skills/cbb-worktree-close/scripts/find-workspace-root.js

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 工作空间根目录定位
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/find-workspace-root.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（close / push）。
  *
  * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 CBB-WORKSPACE.json 副本干扰）
  * 兜底：当前目录含 CBB-WORKSPACE.json

package/cbb/worktrees/skills/cbb-worktree-close/scripts/silence-popup.js

@@ -4,7 +4,7 @@
 // koffi is resolved from cbb global install (no local node_modules needed).
 //
 // 唯一真源：cbb/worktrees/_shared/scripts/silence-popup.js
-// 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
+// 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / close / push / local-mode）。
 // skill 内同目录引用：脚本第一行 `require('./silence-popup')`。
 if (process.platform === 'win32') {
   try {

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

@@ -17,7 +17,7 @@ description: "为一个需求在 workspace 与各关联应用仓库同步创建
 - **lazy push（ADR 0002）**：本技能**不向远端推送任何分支**——远端副作用收敛到 `cbb-worktree-push` 唯一出口；推送失败早暴露的职责由 push 技能的 dry-run 承担
 - **AI 配置 junction（ADR 0002 防线 B）**：创建 worktree 后把根的 AI 配置**内容子目录**（rules / skills / commands）junction 进工作树——开发会话开在 `<wt_path>`（上游 `/opsx:*` 相对路径原样生效，零翻译）；工具状态落在工作树自建空壳目录，不互相污染；`cbb update` 在根跑一次全 worktree 生效
 - **本技能必须在业务工作空间根目录执行**（即由 `cbb setup` 初始化、包含 `CBB-WORKSPACE.json` 的目录）
-- 输入约定：**自由文本**（需求名等）直接在对话中提问并等待回复，禁止使用 `AskUserQuestion`；`AskUserQuestion` 仅用于固定选项决策场景（如 push 失败处理、远程分支已存在时的二选一）
+- 输入约定：**自由文本**（需求名、需求描述等）直接在对话中提问并等待回复，禁止使用 `AskUserQuestion`；`AskUserQuestion` 仅用于固定选项决策场景（如 Step 3.1 候选名选择、push 失败处理、远程分支已存在时的二选一）
 - 关联应用恒为 `CBB-WORKSPACE.json` 的**全量 apps**，AI 不询问范围、不从需求语境收窄（worktree 单仓库创建成本低，全量镜像空间根布局）；仅当**用户显式点名**应用时才经 `--apps` 传子集（见 Step 1），需要增减应用时编辑该文件并重跑本技能（幂等）
 - **模式选择（ADR 0002）**：接到需求先判断用户要哪种模式——要**并行 / 隔离** → 本技能；**单线程快改、当前会话就地干** → 引导 `cbb-local-mode`。用户明确指定即遵从，agent 只给推荐不代决
 
@@ -207,17 +207,20 @@ node "<skill_dir>/scripts/check-repos.js" "<ws_root>"
 
 ### 3.1 询问需求名
 
-**直接在对话中**向用户提问（不要使用 `AskUserQuestion` 工具）：*"请输入需求名（同时作为分支名和 workspace 工作树目录名）："*，然后等待用户的纯文本回复。
+**直接在对话中**向用户提问（不要使用 `AskUserQuestion` 工具）：*"请输入需求名（同时作为分支名和 workspace 工作树目录名）；也可以输入一段需求描述，我来推荐几个英文名供你选择："*，然后等待用户的纯文本回复。
+
+**两种输入：**
+- **直接输入名字** → 按下方命名规则校验后采用
+- **输入需求描述**（中英文不限）→ agent 生成 **3–5 个** kebab-case 英文候选（语义对应描述，可按需带类型前缀 `feature-` / `fix-` / `refactor-` 等，候选间风格拉开），用 `AskUserQuestion` 列出供选择；不满意可直接回复自己的名字 → 获选名按命名规则校验后采用
+
+> 示例：描述"修复 2026 Q2 数据泄漏" → 候选 `fix-2026q2-data-leak`、`fix-q2-data-leak`、`patch-data-leak-2026q2`
 
 **命名规则：**
 - 推荐 kebab-case，如 `feature-login`、`ep-user-rebuild`、`fix-2026q2-leak`
 - 禁止包含 `..`、路径分隔符（`/`、`\`）、空格、git 分支禁用字符
 - **需求名同时**作为分支名和 workspace 工作树目录名（`.worktrees/worktree-<需求名>/`）
 
-用户输入如 `feature-login`：
-- 分支名：`feature-login`
-- workspace 工作树目录：`.worktrees/worktree-feature-login`
-- 各应用 worktree 子目录：`.worktrees/worktree-feature-login/<应用名>`
+例：`feature-login` → 分支 `feature-login`；workspace 工作树 `.worktrees/worktree-feature-login/`；应用子目录 `.worktrees/worktree-feature-login/.codespace/<应用名>/`（ADR 0003）
 
 ### 3.2 安全更新 .gitignore（前置）
 
@@ -265,7 +268,7 @@ node "<skill_dir>/scripts/create-branches.js" "<ws_root>" "<branch>" [--apps "ap
 
 ### 3.4 分支就位（lazy push，不推远端）
 
-**本技能不执行任何远端推送（ADR 0002 lazy push）**：分支创建止步于本地。远端副作用收敛到 `cbb-worktree-push` 唯一出口（dry-run 预览 → agent 生成 commit 信息并提交 → push → MR 链接）——推送类失败（认证/网络/保护分支）在 push 技能内暴露并处理，不在创建流程中阻塞。
+**本技能不执行任何远端推送（ADR 0002 lazy push）**：分支创建止步于本地。远端副作用收敛到 `cbb-worktree-push` 唯一出口（dry-run 预览 → agent 生成 commit 信息并提交 → push → Step 7 交付选择：提 MR / 直接合并，ADR 0008）——推送类失败（认证/网络/保护分支）在 push 技能内暴露并处理，不在创建流程中阻塞。
 
 > 旧版在本步骤推送空分支建立 upstream（`push-branches.js`），自 0.0.3-beta.22 起移除：避免每个需求在远端留下空分支尸体；`push-worktrees.js` 首次推送时自动建立 upstream，行为等价。
 
@@ -381,7 +384,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 | 部分应用 worktree 创建失败 | 提示已创建的回滚清理命令 |
 | workspace 主分支 tracked 内容（openspec/、cbb/ 等） | 自动 checkout 到工作树，无需额外动作（cp/clone 都是多余的） |
 | AI 配置目录（.claude/、.qoder/、.opencode/ 等） | Step 3.6 junction 内容子目录进工作树；唯一物理副本在空间根，`cbb update` 一处生效 |
-| 需求名（同时作分支名和工作树目录名） | 用户在对话中纯文本输入，参考 Step 3.1 命名规则（kebab-case，禁 `..`、路径分隔符、空格） |
+| 需求名（同时作分支名和工作树目录名） | 对话纯文本输入：直接给名，或给需求描述由 agent 推荐 3–5 个英文候选（`AskUserQuestion` 选定）；命名规则见 Step 3.1 |
 | 关联应用范围 | 恒为全量（不询问、不从需求语境收窄）；用户显式点名应用时 `--apps` 传子集；增减应用后重跑本技能（幂等） |
 | 单线程快改 / 不需要隔离 | 引导 cbb-local-mode（本地模式，就地切分支） |
 | 运行环境 node 不可用 | 脚本 fail-fast 并提示用户到系统终端重试 |
@@ -430,7 +433,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 ### 用 AskUserQuestion 收集自由文本输入
 
 - **问题：** 需求名需要用户自由输入文本，却用了 `AskUserQuestion` 工具，被迫提供预设选项
-- **修复：** 自由文本输入场景一律**直接在对话中提问**并等待用户文本回复；`AskUserQuestion` 仅用于固定选项的选择场景
+- **修复：** 自由文本（需求名、需求描述）一律**直接在对话中提问**；`AskUserQuestion` 仅用于固定选项——如 Step 3.1 输入描述后的候选名选择
 
 ### 完成后开发会话未开进 worktree
 
@@ -464,7 +467,7 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 - 跳过或绕过 Step 2 状态检查；状态检查失败后继续
 - workspace 仓库创建工作树前不验证 `.worktrees/` 和 `.codespace/` 在 `.gitignore`
 - 用 `git checkout -b` 切分支后再建 worktree（分支检出冲突）
-- 用 `AskUserQuestion` 收集自由文本（需求名 / 分支选项等）
+- 用 `AskUserQuestion` 收集自由文本（需求名 / 需求描述 / 分支选项等）——从固定候选中选名（Step 3.1）除外
 - 运行环境 node 不可用时强行继续 → 改为 fail-fast 提示用户
 - **在本技能内向远端推送任何分支**（lazy push，ADR 0002）——推送只发生在 `cbb-worktree-push`
 - **hook 拦截 main 载荷提交后用 `--no-verify` 绕过**——仅限用户显式要求

package/cbb/worktrees/skills/cbb-worktree-init/scripts/push-core.js

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 推送核心模块
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/push-core.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init-worktree / extend-worktree / push-worktrees）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / push）。
  *
  * 公开 API：
  *   - tryExec(cmd, cwd, execImpl)             包装 execSync，统一返回 {ok, out|err}

package/cbb/worktrees/skills/cbb-worktree-init/scripts/silence-popup.js

@@ -4,7 +4,7 @@
 // koffi is resolved from cbb global install (no local node_modules needed).
 //
 // 唯一真源：cbb/worktrees/_shared/scripts/silence-popup.js
-// 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
+// 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / close / push / local-mode）。
 // skill 内同目录引用：脚本第一行 `require('./silence-popup')`。
 if (process.platform === 'win32') {
   try {

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

@@ -344,6 +344,7 @@ node "<skill_dir>/scripts/merge-branches.js" "<ws_root>" "<branch>" --apps "<app
 - 退出码 0 → 交付完成
 - `need-mr`（目标分支受保护）→ 报明细并**转出口 A**
 - `failed`（含 `merge-failed` / `push-failed`）→ 报明细，修复后重跑（幂等）
+- `not-on-main`（仅主干路径）→ 空间根检出被其他需求占用（本地模式进行中）：**先收尾该本地需求或改用出口 A 提 MR**；不得用 `--allow-checkout` 抢占（该参数属本地模式收尾，会切走占用者的工作区）
 
 报告形态：
 
@@ -496,4 +497,3 @@ node "<skill_dir>/scripts/merge-branches.js" "<ws_root>" "<branch>" --apps "<app
 | `push-core.js` | 推送核心（classifyError / pushSingle / collectRemoteMetadata，共享脚本，源仓库真源在 `_shared/scripts/`） | （共享模块） | - |
 | `check-unarchived.js` | 未归档 change 检查（Step 7 直合并的归档前置，共享脚本） | ws_root, branch | 0/1 |
 | `merge-branches.js` | 直合并（Step 7 出口 B / 收尾门禁；预检 → merge --no-ff → push；`--target` 支持测试分支，共享脚本） | ws_root, branch, --apps / --target / --allow-checkout / --dry-run / --check | 0/1/2 |
-| `deprecate-branches.js` | 废弃重命名（收尾门禁出口三，共享脚本） | ws_root, branch, --apps | 0/1/2 |

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

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 目标需求名识别
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/find-target-worktree.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（extend / close / push）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（close / push）。
  *
  * 用法：node find-target-worktree.js <ws_root>
  *

package/cbb/worktrees/skills/cbb-worktree-push/scripts/find-workspace-root.js

@@ -3,7 +3,7 @@ require('./silence-popup');
  * openspec-shared 工作空间根目录定位
  *
  * 唯一真源：cbb/worktrees/_shared/scripts/find-workspace-root.js
- * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init / extend / close / push）。
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（close / push）。
  *
  * 优先：git worktree list 第一行（主仓库根目录，不受 worktree 内 CBB-WORKSPACE.json 副本干扰）
  * 兜底：当前目录含 CBB-WORKSPACE.json