@jspg-ai/coding-bb 0.0.3-beta.6 → 0.0.3-beta.8

package/cbb/lib/utils/upstream.js

@@ -0,0 +1,90 @@
+'use strict';
+
+/**
+ * 上游内容拉取的共享工具。
+ *
+ * 维护者侧（cbbm update --upstream-*）需要访问 GitHub / npm registry。
+ * 本模块提供：
+ *   - 镜像前缀列表加载（config/upstream-mirrors.json，仓库内维护）
+ *   - 带重定向跟随的 HTTPS GET
+ *   - 「按镜像列表依次尝试」的拉取策略（首个成功即用）
+ *
+ * 镜像前缀为空字符串表示直连；列表末位通常放 "" 作为兜底。
+ */
+
+const fs = require('fs');
+const https = require('https');
+const path = require('path');
+
+const SHARED_STANDARDS_DIR = path.join(__dirname, '..', '..', '..');
+const MIRRORS_FILE = path.join(SHARED_STANDARDS_DIR, 'config', 'upstream-mirrors.json');
+
+/**
+ * 读取指定上游的镜像前缀列表。
+ * 文件缺失 / 解析失败 / 未配置该上游时返回 ['']（仅直连）。
+ * @param {string} name - 上游名（如 'superpowers'）
+ * @returns {string[]}
+ */
+function loadMirrors(name) {
+  try {
+    const data = JSON.parse(fs.readFileSync(MIRRORS_FILE, 'utf-8'));
+    const list = data[name];
+    if (Array.isArray(list) && list.length > 0) {
+      return list.map(m => String(m));
+    }
+  } catch (_) { /* 回退到直连 */ }
+  return [''];
+}
+
+/**
+ * 发起 HTTPS GET，跟随重定向（最多 8 次），返回响应体 Buffer。
+ * @param {string} url
+ * @param {number} [redirectCount]
+ * @returns {Promise<Buffer>}
+ */
+function httpsGetBuffer(url, redirectCount = 0) {
+  if (redirectCount > 8) return Promise.reject(new Error('Too many redirects'));
+  return new Promise((resolve, reject) => {
+    https.get(url, { headers: { 'User-Agent': 'cbb-cli' } }, res => {
+      if ([301, 302, 307, 308].includes(res.statusCode) && res.headers.location) {
+        res.resume();
+        return httpsGetBuffer(res.headers.location, redirectCount + 1).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        res.resume();
+        return reject(new Error(`HTTP ${res.statusCode}: ${url}`));
+      }
+      const chunks = [];
+      res.on('data', c => chunks.push(c));
+      res.on('end', () => resolve(Buffer.concat(chunks)));
+      res.on('error', reject);
+    }).on('error', reject);
+  });
+}
+
+/**
+ * 按镜像列表依次尝试拉取，首个成功即返回。
+ * @param {string[]} mirrors - 镜像前缀列表（'' = 直连）
+ * @param {(prefix: string) => string} buildUrl - 由前缀构造完整 URL
+ * @returns {Promise<{buffer: Buffer, mirror: string, url: string}>}
+ */
+async function fetchWithMirrors(mirrors, buildUrl) {
+  const errors = [];
+  for (const mirror of mirrors) {
+    const url = buildUrl(mirror);
+    try {
+      const buffer = await httpsGetBuffer(url);
+      return { buffer, mirror, url };
+    } catch (err) {
+      errors.push(`${mirror || '(直连)'}: ${err.message}`);
+    }
+  }
+  throw new Error(`所有镜像均失败:\n  ${errors.join('\n  ')}`);
+}
+
+module.exports = {
+  MIRRORS_FILE,
+  loadMirrors,
+  httpsGetBuffer,
+  fetchWithMirrors,
+};

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

@@ -1,12 +1,6 @@
 ---
 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:
-  author: Contributors
-  version: "2.0"
-  generatedBy: coding-bb
 ---
 
 # Close Worktree（跨平台脚本化版本 v2.0）
@@ -29,12 +23,28 @@ metadata:
 
 ---
 
+## 调用脚本的统一方式
+
+**重要**：本技能的所有脚本位于**本 SKILL.md 所在目录的 `scripts/` 下**（skill 目录）。
+
+调用时用**本技能目录的绝对路径**拼接脚本名（AI 读取本 SKILL.md 时即已知该目录），例如：
+
+```bash
+node "<skill_dir>/scripts/<name>.js" <参数>
+```
+
+> - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `workspace-config.json` 与 git 仓库
+> - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
+
+---
+
 ## Step 0：前置校验
 
 ### 0.1 环境健康探活
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/check-env.js"
+node "<skill_dir>/scripts/check-env.js"
 ```
 
 **解读输出**：
@@ -45,7 +55,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/check-env.js
 ### 0.2 定位工作空间根目录
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/find-workspace-root.js"
+node "<skill_dir>/scripts/find-workspace-root.js"
 ```
 
 **解读输出**：
@@ -69,7 +79,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/find-workspa
 3. AI agent 列出 `.worktrees/` 下的所有 worktree：
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/find-target-worktree.js "<ws_root>"
+node "<skill_dir>/scripts/find-target-worktree.js "<ws_root>"
 ```
 
 > 注：本技能支持工作空间根目录或 worktree 内执行，find-target-worktree 自动从 cwd 反推或列出。
@@ -84,7 +94,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/find-target-
 ### 1.2 发现关联应用 worktree
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/discover-apps.js "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/discover-apps.js "<ws_root>" "<branch>"
 ```
 
 脚本自动从 `workspace-config.json` 读取应用列表，扫描 `.worktrees/worktree-<branch>/<应用名>/` 实际存在的子目录。
@@ -93,12 +103,12 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/discover-app
 - `workspace` 字段：workspace worktree 绝对路径（AI agent 记录供后续命令使用）
 - `apps` 数组：实际存在的应用 worktree 列表（每项含 `name`, `repo`, `side`, `wt_path`, `app_path`）
 
-> 说明：app worktree 物理嵌套在 workspace worktree 内，移除 workspace worktree 时嵌套的子目录会一并消失，但各 app 仓库的 git worktree 元数据（`.git/worktrees/`）仍需通过 `git worktree remove` 逐个清理。AI 配置目录（`.claude/`、`.qoder/`、`.cbb/`）在每个 worktree 内由 init-worktree 独立安装，随 worktree 目录删除而清理，skill 无需特殊处理。
+> 说明：app worktree 物理嵌套在 workspace worktree 内，移除 workspace worktree 时嵌套的子目录会一并消失，但各 app 仓库的 git worktree 元数据（`.git/worktrees/`）仍需通过 `git worktree remove` 逐个清理。AI 配置只装在业务空间根（单层安装），worktree 内没有 AI 配置目录，无需特殊处理。
 
 ### 1.3 检查未归档 change
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/check-unarchived.js "<ws_root>"
+node "<skill_dir>/scripts/check-unarchived.js "<ws_root>"
 ```
 
 脚本扫描 `openspec/changes/` 目录，筛选出非 `archive/` 子目录的 change 名称列表。
@@ -117,7 +127,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/check-unarch
 对 workspace worktree 和每个关联应用 worktree，依次执行三项检查并汇总成安全状态表。**这是破坏性操作前的必经环节，结果将驱动 Step 3 的用户决策。**
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/safety-check.js "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/safety-check.js "<ws_root>" "<branch>"
 ```
 
 脚本内部对每个仓库自动执行：
@@ -226,10 +236,10 @@ AskUserQuestion({
 
 ```bash
 # 仅删本地分支（已合并自动 -d，未合并自动 -D；含 squash 合并 -D 兜底）
-node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local
+node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local
 
 # 删本地 + 远程分支
-node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
+node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
 ```
 
 **调用前的强警告**（调用方需自评）：
@@ -260,7 +270,7 @@ node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
   [中止] 终止流程，我先手动处理
 ```
 
-- 用户选择「先推送」→ AI 引导用户执行 `cbb-worktree-push`（或 `/cbb:worktree-push`），完成后**重新跑** Step 2 safety-check 确认 `unpushed_count = 0` 再回到本步骤
+- 用户选择「先推送」→ AI 引导用户执行 `cbb-worktree-push` skill（或 `/cbb-worktree-push`），完成后**重新跑** Step 2 safety-check 确认 `unpushed_count = 0` 再回到本步骤
 - 用户选择「接受丢失」→ 必须二次确认（ahead 提交真的会丢），确认后继续 Step 4
 - 用户选择「中止」→ 终止流程
 
@@ -289,7 +299,7 @@ node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
 **顺序：先移除各应用 worktree，再移除 workspace worktree**（逆序于创建；也为后续删分支扫清"分支仍被检出"的障碍）。
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/remove-worktrees.js "<ws_root>" "<branch>" "<force>"
+node "<skill_dir>/scripts/remove-worktrees.js "<ws_root>" "<branch>" "<force>"
 ```
 
 **三层降级策略**：`git worktree remove` 实际包含两个动作——①清理 git 元数据（`.git/worktrees/`）②删除物理目录。当 IDE 占用目录时 ② 会被 Windows 文件锁阻塞，但 ① 永远不受影响。脚本将这两个动作解耦：
@@ -333,9 +343,9 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-close/scripts/remove-workt
 如用户在 Step 1.1 选定 worktree 时已要求"删除分支"，或运行后需要单独清理，可在此步骤**手动调用**：
 
 ```bash
-node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local
+node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local
 # 或
-node "<skill>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
+node "<skill_dir>/scripts/delete-branches.js" "<ws_root>" "<branch>" local_remote
 ```
 
 脚本内部对每个仓库：
@@ -388,7 +398,6 @@ git -C "<ws_root>" worktree list
     ⏭️  fix-payment-timeout → 用户选择跳过
     （无未归档 change 时不显示本节）
   分支处理：feature-xxx 已保留（默认行为；如需删除分支，手动调用 scripts/delete-branches.js）
-  AI 配置：worktree 内独立安装，随 worktree 删除而清理；工作空间根目录的 AI 配置保留
   剩余工作空间 worktree：<列出仍存在的，或 "无" >
   Workspace cleaned up.
 ```
@@ -411,7 +420,7 @@ git -C "<ws_root>" worktree list
 - 未经用户确认用 `--force` 丢弃未提交修改，或主动调用 `delete-branches.js` 对未合并分支执行 `-D` 强删
 - 操作 `.worktrees/worktree-<需求名>` 以外的任何 worktree（如 `~/.qoder/worktree/...` 会话 worktree）
 - 移除/删除前跳过 Step 2 安全评估
-- 删除工作空间根目录的 AI 配置目录（`.claude/`、`.qoder/`、`.cbb/` 等源目录）
+- 删除工作空间根目录的 AI 配置目录（`.claude/`、`.qoder/`、`.opencode/` 等）
 - 用 `AskUserQuestion` 收集自由文本（分支名等直接对话提问）
 - 手动改任何仓库的 `.gitignore`（关闭流程不碰它）
 - 运行环境 node 不可用时强行继续 → 改为 fail-fast 提示用户
@@ -429,7 +438,7 @@ git -C "<ws_root>" worktree list
 - **合并判定依赖刷新后的远程引用，故 Step 2.0 先主动 `git fetch`**：feature 多由他人经 MR 合入远端，本地引用否则会陈旧误判
 - **并行块用临时文件收结果、不用共享变量**：原 bash 版本中 `&` 后台任务跑在独立子 shell；Node.js 同步执行无此问题
 - **`.gitignore` 无需清理**：创建时的 `.worktrees/` 条目提交在 feature 分支上，删分支时随分支消失（未合并）或无害保留（已合并）
-- **AI 配置目录在每个 worktree 内独立安装**：关闭 worktree 时这些目录随 worktree 目录一起删除
+- **AI 配置只装在空间根（单层安装）**：worktree 内没有 AI 配置目录，关闭时无需处理
 - **部分 `worktree remove` 失败**：已移除的无需回退，未移除的报告详情让用户处理后重跑
 - **Windows IDE 目录锁的三层降级**：`git worktree remove` 内部做两件事——①清元数据 ②删目录。Windows 文件锁只阻塞 ②，不阻塞 ①
 

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

@@ -1,12 +1,6 @@
 ---
 name: cbb-worktree-init
 description: "为一个需求在 workspace 与各关联应用仓库（= workspace-config.json 全量 apps）同步创建同名物理 git worktree，直聚在 `.worktrees/worktree-<需求名>/` 下。触发：用户明确要求创建需求工作空间/开发隔离环境，或为已有需求补齐新增应用（重跑本技能即幂等）。禁止自动串联 cbb-worktree-close——除非用户明确说了要关闭。"
-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
 ---
 
 # Init Worktree（跨平台脚本化版本 v2.0）
@@ -28,13 +22,18 @@ metadata:
 
 ## 调用脚本的统一方式
 
-**重要**：所有脚本必须用**绝对路径**调用。`./scripts/...` 相对路径在 Agent 运行环境中不适用（AI agent 的 cwd 不一定是技能目录）。worktree 运行时统一部署在空间根 `.cbb/skills/` 下，各工具一致。
+**重要**：本技能的所有脚本位于**本 SKILL.md 所在目录的 `scripts/` 下**（skill 目录）。
 
-调用方式（推荐用绝对路径）：
-```
-node "D:\workspace\<用户工作空间>\.cbb\skills\cbb-worktree-init\scripts\<name>.js" <参数>
+调用时用**本技能目录的绝对路径**拼接脚本名（AI 读取本 SKILL.md 时即已知该目录），例如：
+
+```bash
+node "<skill_dir>/scripts/<name>.js" <参数>
 ```
 
+> - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `workspace-config.json` 与 git 仓库
+> - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
+
 脚本输出：
 - 人类可读报告（OK / FAIL / WARN）
 - 机器可读摘要（末行以 XXX_OK / XXX_FAILED / XXX_RESULT 开头）
@@ -54,7 +53,7 @@ node "D:\workspace\<用户工作空间>\.cbb\skills\cbb-worktree-init\scripts\<n
 ### 0.1 环境健康探活
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/check-env.js"
+node "<skill_dir>/scripts/check-env.js"
 ```
 
 **解读输出**：
@@ -67,7 +66,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/check-env.js"
 提前检测权限/版本问题，把可能在后续步骤暴露的失败前移到流程最开始：
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/check-env-deep.js"
+node "<skill_dir>/scripts/check-env-deep.js"
 ```
 
 **解读输出**：
@@ -81,7 +80,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/check-env-dee
 ### 0.2 读取并校验 workspace-config.json
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/parse-config.js"
+node "<skill_dir>/scripts/parse-config.js"
 ```
 
 **解读输出**：
@@ -148,7 +147,7 @@ worktree 需要知道要关联哪些应用仓库。
 
 ```bash
 # ws_root 来自 AI agent 维护的状态
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/sync-repos.js" "<ws_root>"
+node "<skill_dir>/scripts/sync-repos.js" "<ws_root>"
 ```
 
 **用法**：
@@ -192,7 +191,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/sync-repos.js
 | 当前在主分支上 | ✅ | ❌ |
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/check-repos.js" "<ws_root>"
+node "<skill_dir>/scripts/check-repos.js" "<ws_root>"
 ```
 
 **解读输出**：
@@ -220,7 +219,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/check-repos.j
 ### 3.2 安全更新 .gitignore（前置）
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/update-gitignore.js "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/update-gitignore.js "<ws_root>" "<branch>"
 ```
 
 脚本内部自动完成：stash 保护 → 切分支 → 添加 `.worktrees/` 和 `.codespace/` → 提交 → 切回 → pop stash
@@ -234,7 +233,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/update-gitign
 ### 3.3 创建分支
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/create-branches.js" "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/create-branches.js" "<ws_root>" "<branch>"
 ```
 
 **解读输出**：
@@ -259,7 +258,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/create-branch
 ### 3.4 推送并建立 upstream
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/push-branches.js" "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/push-branches.js" "<ws_root>" "<branch>"
 ```
 
 脚本内部自动完成：
@@ -287,7 +286,7 @@ node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/push-branches
 ### 3.5 创建 Worktree（含自愈清理）
 
 ```bash
-node "D:/workspace/<ws_root>/.cbb/skills/cbb-worktree-init/scripts/create-worktrees.js" "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/create-worktrees.js" "<ws_root>" "<branch>"
 ```
 
 脚本内部自动完成：
@@ -347,7 +346,7 @@ WT_PATH d:\workspace\xxx\.worktrees\worktree-feature-login
 |------|----------|
 | 空间新增了应用（编辑 `workspace-config.json` 后） | Step 1 拉取新应用代码 → Step 3.3 为新应用建分支 → Step 3.4 推送（已一致的分支 `skipped`，不一致则阻塞询问）→ Step 3.5 创建缺失的嵌套 worktree |
 | 上次 init 中途失败 | 已存在的分支 / worktree 自动复用，`.gitignore` 处理自动跳过，仅补齐缺失部分 |
-| 应用从 config 移除 | 已创建的分支 / worktree **不会**自动删除；如需清理用 `/cbb:worktree-close` 关闭后重建 |
+| 应用从 config 移除 | 已创建的分支 / worktree **不会**自动删除；如需清理用 `cbb-worktree-close` skill 关闭后重建 |
 
 > ⓘ 重跑**不会静默推送**开发中的本地提交：远程分支已存在但与本地不一致时，Step 3.4 走阻塞式 `remote-exists` 决策（展示 commit 元信息让用户选择）。
 
@@ -368,7 +367,7 @@ WT_PATH d:\workspace\xxx\.worktrees\worktree-feature-login
 | 运行环境 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） |
+| 开发过程中推送所有 worktree | Step 3.4 仅覆盖创建时的空 commit；开发过程中产生的提交必须调 `cbb-worktree-push` skill 推送（详见该 skill） |
 
 ---
 
@@ -467,7 +466,7 @@ WT_PATH d:\workspace\xxx\.worktrees\worktree-feature-login
 - workspace 仓库标准检查（当前在主分支等），app 仓库轻量检查（fetch + `origin/main` 可用即可）
 - app 仓库分支从 `origin/main` 创建（`git branch <需求名> ${REMOTE}/${MAIN}`），不依赖本地主分支状态
 - 严格 Step 3.3 → Step 3.4 顺序（先统一创建分支，再统一创建 worktree；workspace 工作树先建，各应用按序补建）
-- 所有脚本调用以 `node "<WS_ROOT>\.cbb\skills\cbb-worktree-init\scripts\<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 由脚本内部从 workspace-config.json 读取），**不依赖跨调用的 cwd**
+- 所有脚本调用以 `node "<skill_dir>/scripts/<name>.js" "<绝对路径>" "<branch>"` 形式发起（apps 由脚本内部从 workspace-config.json 读取）；**执行时 cwd 保持在工作空间根**（`check-env.js` / `parse-config.js` 按 cwd 定位）
 - **Step 3.4 push 步骤必须执行且插入在 create-branches.js (3.3) 之后、create-worktrees.js (3.5) 之前** — 失败时阻塞整个 init-worktree 流程
 - **Step 3.4 仅覆盖创建 worktree 时的空 commit** — 开发过程中产生的本地 commit（如 apply 任务实现）必须由用户在 worktree 中手动提交并调 `cbb-worktree-push` 推送；不允许依赖 Step 3.4 之后的自动推送（不存在）
 

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

@@ -1,19 +1,15 @@
 ---
 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).
-metadata:
-  author: Contributors
-  version: "1.0"
-  generatedBy: coding-bb
+description: "提交并推送当前需求的所有关联仓库（跨 worktree 批量）。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-worktree 前需要先推送未提交改动。注意：本技能会先识别场景——不在 cbb 工作空间时降级为普通单仓库提交推送。"
 ---
 
 # Push Worktrees（跨平台脚本化版本 v1.0）
 
-跨 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 的缺口。
+提交并推送当前需求的所有关联仓库（跨 worktree 批量）。专门解决"开发完成后批量推送"和"用户口语化提交并push"两类场景，弥补 [cbb-worktree-init Step 3.4](file:///d:/workspace/va-ai/coding-bb/cbb/worktrees/skills/cbb-worktree-init/SKILL.md) 仅推送初始空 commit 的缺口。
 
-**启动时声明：** "我正在使用 cbb-worktree-push 技能来批量提交并推送当前需求的所有 worktree 仓库。"
+> **本技能描述含宽泛触发词（"提交"/"push"），允许被误触发**。因此第一步永远是 **Step 0 场景识别**：在 cbb 工作空间内才走跨 worktree 批量流程；在普通 git 仓库降级为单仓库提交推送；非 git 目录则退出。
+
+**启动时声明：** "我正在使用 cbb-worktree-push 技能来推送当前需求的关联仓库。"
 
 ## 核心原则
 
@@ -30,12 +26,18 @@ metadata:
 
 ## 调用脚本的统一方式
 
-**所有脚本必须用绝对路径调用**（Agent 运行环境中 AI agent 的 cwd 不一定是技能目录）。
+**重要**：本技能的所有脚本位于**本 SKILL.md 所在目录的 `scripts/` 下**（skill 目录）。
+
+调用时用**本技能目录的绝对路径**拼接脚本名（AI 读取本 SKILL.md 时即已知该目录）：
 
 ```
-node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/<name>.js" <参数>
+node "<skill_dir>/scripts/<name>.js" <参数>
 ```
 
+> - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `workspace-config.json` 与 git 仓库
+> - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
+
 脚本输出：
 - 人类可读报告（OK / FAIL / WARN）
 - 机器可读摘要（末行以 `COMMIT_RESULT` / `PUSH_RESULT` 开头）
@@ -43,22 +45,48 @@ node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/<name>.js" <参数>
 
 ---
 
-## Step 0：定位工作空间
+## Step 0：场景识别（先判场景，再定策略）
+
+**本技能允许被"提交"/"push"这类宽泛措辞误触发**。执行任何操作前，先判断当前处于哪种场景，按场景选择策略——**不要硬套 cbb 工作空间流程**。
+
+判断依据（任一命中即定场景）：
+
+| 场景 | 判据 | 策略 |
+|------|------|------|
+| **A. cbb 工作空间根** | cwd（或其 git 顶层）含 `workspace-config.json`；`find-workspace-root.js` 退出码 0 | 走 **Step 1 → 6** 的跨 worktree 批量流程 |
+| **B. worktree 内** | cwd 命中 `<ws_root>/.worktrees/worktree-<需求名>/` | 用 cwd 反推 `<需求名>`，走 **Step 1 → 6** 批量流程 |
+| **C. 普通 git 仓库** | 在 git 仓库内，但无 `workspace-config.json`（`find-workspace-root.js` 退出码 1） | **降级为单仓库提交推送**：不调 worktree 脚本，按常规 `git add -u` → 向用户询问 commit 信息 → `git commit` → `git push`（保留本 skill 的"必问 commit 信息"约束） |
+| **D. 非 git 目录** | `git rev-parse --is-inside-work-tree` 失败 | 说明"当前目录不是 git 仓库"，终止，不做任何操作 |
+
+**判场景与定位（A/B 场景）：**
 
 ```bash
-node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/find-workspace-root.js"
+node "<skill_dir>/scripts/find-workspace-root.js"
 ```
 
 **解读末行**：
-- 退出码 0 + 末行（纯路径） → WS_ROOT
-- 退出码 1 → 未找到工作空间根目录，**终止流程**
+- 退出码 0 + 末行（纯路径） → WS_ROOT（场景 A/B），继续 Step 1
+- 退出码 1 → 无工作空间：**先判断场景 C 还是 D**（`git rev-parse --is-inside-work-tree`）：
+  - 是 git 仓库 → 场景 C，按降级策略走（见下）
+  - 不是 → 场景 D，终止
+
+**场景 C 降级流程**（普通仓库误触）：
+
+1. `git status` 报告改动现状
+2. 直接对话询问 commit 信息（**禁止**自动生成）
+3. `git add -u`（默认不含未追踪文件；用户明确要求时才 `git add -A`）
+4. `git commit -m "<用户提供的信息>"`
+5. `git push`（无 upstream 时先询问用户是否 `-u`）
+6. 汇报结果；**不要**提及 worktree 批量流程
+
+> 场景 C 是兜底：让"提交代码"在普通仓库里也能正常完成，而不是因找不到 `workspace-config.json` 报错。
 
 ---
 
-## Step 1：识别目标 worktree
+## Step 1：识别目标 worktree（A/B 场景）
 
 ```bash
-node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/find-target-worktree.js" "<ws_root>"
+node "<skill_dir>/scripts/find-target-worktree.js" "<ws_root>"
 ```
 
 **解读末行**：
@@ -72,7 +100,7 @@ node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/find-target-worktree.js" "
 
 ```bash
 # 仅 commit 阶段先做 dry-run 预览
-node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "preview" --dry-run
+node "<skill_dir>/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "preview" --dry-run
 ```
 
 **解读末行 `COMMIT_RESULT`**：每项仓库的状态
@@ -119,16 +147,16 @@ AI agent 在执行真实 commit 前**必须**在对话中向用户确认 commit
 
 ```bash
 # 统一信息
-node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "feat(<branch>): 实现客户运费逻辑"
+node "<skill_dir>/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"
+node "<skill_dir>/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --per-repo "ep-foo-app:feat(<branch>): 实现 saveClientExpectFreight;ep-bar-app:refactor(<branch>): 拆分 PlanService"
 
 # 含未追踪文件
-node "..." "<ws_root>" "<branch>" --message "..." --untracked
+node "<skill_dir>/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message "..." --untracked
 
 # wt_path 形式（用户在 worktree 内）
-node "..." "<ws_root>/.worktrees/worktree-<branch>" --message "..."
+node "<skill_dir>/scripts/commit-worktrees.js" "<ws_root>/.worktrees/worktree-<branch>" --message "..."
 ```
 
 **选项**：
@@ -155,10 +183,10 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>" --message "..."
 ## Step 5：批量 push
 
 ```bash
-node "<ws_root>/.cbb/skills/cbb-worktree-push/scripts/push-worktrees.js" "<ws_root>" "<branch>"
+node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>" "<branch>"
 
 # 或 wt_path 形式
-node "..." "<ws_root>/.worktrees/worktree-<branch>"
+node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<branch>"
 ```
 
 **解读末行 `PUSH_RESULT`**：
@@ -210,8 +238,7 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
     workspace: ✅ origin/<branch>
     ep-foo-app: ✅ origin/<branch>
     ep-bar-app: ⚠️  远程分支已存在（需用户决策 → 已关联）
-  AI 配置目录：worktree 内独立安装，无需处理
-  后续：可继续开发 / 调 /opsx:verify 验证 / 调 /opsx:archive 归档 / 调 /cbb:worktree-close 关闭
+  后续：可继续开发 / 调 /opsx:verify 验证 / 调 /opsx:archive 归档 / 调 `cbb-worktree-close` skill 关闭
 ```
 
 ---
@@ -220,8 +247,11 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 
 | 场景 | 处理方式 |
 |------|----------|
-| 用户说"提交并push"且 cwd 在 worktree 内 | 自动用 cwd 反推分支，Step 2 扫描后进入 Step 3 问 commit 信息 |
-| 用户说"提交并push"且 cwd 在 WS_ROOT | Step 0 定位后，多个 worktree 时让用户选 |
+| **任何触发** | **先做 Step 0 场景识别**，再决定策略 |
+| 场景 A：cwd 在 cbb 工作空间根 | find-workspace-root 成功 → 多个 worktree 时让用户选 |
+| 场景 B：cwd 在 worktree 内 | 自动用 cwd 反推分支，扫描后进入询问 commit 信息 |
+| 场景 C：cwd 在普通 git 仓库（无 workspace-config.json） | **降级为单仓库提交推送**，不调用 worktree 脚本 |
+| 场景 D：cwd 非 git 目录 | 说明情况并终止，不做任何操作 |
 | commit 信息缺失 | 必须询问用户；禁止自动生成（可基于 apply task 上下文给建议） |
 | 多仓库需不同 commit 信息 | 用 `--per-repo "ep-foo:m1;ep-bar:m2"`，必须由用户逐条提供 |
 | 仓库干净 | commit-worktrees 自动 skipped，只 push 不 commit |
@@ -236,6 +266,11 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 
 ## 常见错误
 
+### 误触后硬套 worktree 流程
+
+- **问题：** 用户在普通仓库说"提交代码"，技能被 description 匹配触发，直接跑 `find-workspace-root.js` 失败并报错终止
+- **修复：** Step 0 先判场景；场景 C（普通 git 仓库）降级为单仓库提交推送，不调用 worktree 脚本、不提及批量流程
+
 ### 自动生成 commit 信息不让用户确认
 
 - **问题：** agent 拍脑袋写 "feat: xxx"，与用户实际意图不符
@@ -286,8 +321,9 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 
 **必须执行**
 
-- 严格按 Step 0 → 1 → 2 → 3 → 4 → 5 → 6 顺序执行
-- 所有脚本调用以 `node "..." "<绝对路径>"` 形式发起
+- 严格按 Step 0 → 1 → 2 → 3 → 4 → 5 → 6 顺序执行（场景 C/D 除外，按 Step 0 降级策略）
+- 所有脚本调用以 `node "<skill_dir>/scripts/<name>.js"` 形式发起（`<skill_dir>` = 本 SKILL.md 所在目录）
+- 执行脚本时 cwd 保持在工作空间根；场景 C 降级时按普通 git 流程
 - Step 2 dry-run 必跑，让用户看到将要 commit 的内容
 - Step 3 必问用户 commit 信息（自由文本），禁止自动生成
 - commit 信息涉及业务语义时（feature/refactor/fix 等）必须从 apply task 上下文生成建议并由用户确认