@jspg-ai/coding-bb 0.0.1

package/cbb/worktrees/_shared/scripts/find-target-worktree.js

@@ -0,0 +1,96 @@
+require('./silence-popup');
+/**
+ * openspec-shared 目标需求名识别
+ *
+ * 唯一真源：cbb/worktrees/_shared/scripts/find-target-worktree.js
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（extend / close / push）。
+ *
+ * 用法：node find-target-worktree.js <ws_root>
+ *
+ * 优先级：
+ *   1. cwd 在 .worktrees/worktree-xxx/ 内 → 自动从路径反推
+ *   2. .worktrees/ 下只有一个 worktree → 自动选用
+ *   3. 多个 worktree → 按 mtime 倒序，第一个为推荐
+ *
+ * 输出：
+ *   末行输出需求名（用于 AI agent 解析）
+ *   多个时按 [1] xxx ⭐ / [2] yyy 列出
+ *
+ * 退出码：
+ *   0 - 唯一识别（自动或唯一）
+ *   1 - 多个 worktree，需用户输入
+ *   2 - 无 worktree
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+
+if (!wsRoot) {
+  console.error('❌ 用法：node find-target-worktree.js <ws_root>');
+  process.exit(1);
+}
+
+// 优先级 1：cwd 反推
+const cwd = process.cwd();
+const cwdMatch = cwd.match(/\.worktrees[\\\/]worktree-([^\\\/]+)/);
+if (cwdMatch) {
+  const branch = cwdMatch[1];
+  console.log('✅ 从 cwd 反推需求名：' + branch);
+  console.log('---');
+  console.log(branch);
+  process.exit(0);
+}
+
+const worktreesDir = path.join(wsRoot, '.worktrees');
+if (!fs.existsSync(worktreesDir)) {
+  console.error('❌ .worktrees 目录不存在：' + worktreesDir);
+  console.error('   请先执行 openspec-init-worktree 创建 worktree');
+  console.log('---');
+  console.log('NO_WORKTREE');
+  process.exit(2);
+}
+
+// 列出所有 worktree-xxx 目录
+const entries = fs.readdirSync(worktreesDir, { withFileTypes: true })
+  .filter(e => e.isDirectory() && e.name.startsWith('worktree-'))
+  .map(e => ({
+    name: e.name.substring('worktree-'.length),
+    fullName: e.name,
+    path: path.join(worktreesDir, e.name),
+    mtime: fs.statSync(path.join(worktreesDir, e.name)).mtime.getTime(),
+  }));
+
+if (entries.length === 0) {
+  console.error('❌ 未找到任何 worktree');
+  console.error('   请先执行 openspec-init-worktree 创建 worktree');
+  console.log('---');
+  console.log('NO_WORKTREE');
+  process.exit(2);
+}
+
+// 优先级 2：唯一
+if (entries.length === 1) {
+  console.log('✅ 自动选用唯一 worktree：' + entries[0].name);
+  console.log('---');
+  console.log(entries[0].name);
+  process.exit(0);
+}
+
+// 优先级 3：多个 → 按 mtime 倒序
+entries.sort((a, b) => b.mtime - a.mtime);
+
+console.log('⚠️  检测到 ' + entries.length + ' 个 worktree（按最近修改排序）：');
+entries.forEach((e, i) => {
+  if (i === 0) {
+    console.log('  [' + (i + 1) + '] ' + e.name + '  ⭐ (推荐：最近修改)');
+  } else {
+    console.log('  [' + (i + 1) + '] ' + e.name);
+  }
+});
+console.log('请在对话中输入序号(1/2/3)或完整分支名：');
+console.log('---');
+console.log('MULTIPLE_WORKTREEES');
+process.exit(1);

package/cbb/worktrees/_shared/scripts/find-workspace-root.js

@@ -0,0 +1,67 @@
+require('./silence-popup');
+/**
+ * openspec-shared 工作空间根目录定位
+ *
+ * 唯一真源：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
+ *
+ * 退出码：
+ *   0 - 定位成功，输出 WS_ROOT 绝对路径
+ *   1 - 未找到工作空间根目录
+ *
+ * 输出格式：
+ *   第一行：人类可读报告
+ *   最后一行：纯路径（便于 AI agent 解析后用于 cd）
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function tryExec(cmd) {
+  try {
+    return { ok: true, out: execSync(cmd, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).trim() };
+  } catch (e) {
+    return { ok: false };
+  }
+}
+
+let wsRoot = '';
+
+// 优先：git worktree list 第一行
+const worktreeList = tryExec('git worktree list');
+if (worktreeList.ok) {
+  const firstLine = worktreeList.out.split('\n')[0];
+  if (firstLine) {
+    // 格式：<path> <sha> [<branch>]
+    const candidate = firstLine.split(/\s+/)[0];
+    if (candidate && fs.existsSync(candidate)) {
+      wsRoot = candidate;
+    }
+  }
+}
+
+// 兜底：当前目录含 CONFIG.json
+if (!wsRoot) {
+  const cwd = process.cwd();
+  if (fs.existsSync(path.join(cwd, 'CONFIG.json'))) {
+    wsRoot = cwd;
+  }
+}
+
+// 校验
+if (!wsRoot || !fs.existsSync(path.join(wsRoot, 'CONFIG.json'))) {
+  console.error('❌ 未找到工作空间根目录');
+  console.error('   原因：git worktree list 失败且当前目录无 CONFIG.json');
+  console.error('   请在业务工作空间根目录（由 cbb setup 初始化、包含 CONFIG.json）下执行本技能');
+  process.exit(1);
+}
+
+console.log('✅ 工作空间根目录：' + wsRoot);
+console.log('---');
+// 最后一行输出纯路径，AI agent 可直接 cd 使用
+console.log(wsRoot);
+process.exit(0);

package/cbb/worktrees/_shared/scripts/push-core.js

@@ -0,0 +1,136 @@
+require('./silence-popup');
+/**
+ * openspec-shared 推送核心模块
+ *
+ * 唯一真源：cbb/worktrees/_shared/scripts/push-core.js
+ * 由 scripts/sync-shared.js 展开到各 skill 的 scripts/ 下（init-worktree / extend-worktree / push-worktrees）。
+ *
+ * 公开 API：
+ *   - tryExec(cmd, cwd, execImpl)             包装 execSync，统一返回 {ok, out|err}
+ *   - escapeBranch(name)                      分支名 shell 转义（防命令注入）
+ *   - classifyError(stderr)                   将 stderr 归类为 8 种错误码之一
+ *   - pushSingle(repoPath, repoName, branch)  推送单个仓库并建立 upstream
+ *   - collectRemoteMetadata(repoPath, branch, remote)  采集远程 commit 元信息
+ *
+ * 错误码契约（classifyError 输出）：
+ *   - ssh-auth-failed        Permission denied (publickey)
+ *   - https-auth-failed      Authentication failed
+ *   - network-unreachable    Could not resolve host / hung up / connection refused
+ *   - branch-protected       protected branch / deny updating
+ *   - remote-exists          already exists
+ *   - no-remote              (pushSingle 内部判定)
+ *   - non-fast-forward       non-fast-forward
+ *   - unknown                兜底
+ */
+
+const { execSync: realExecSync } = require('child_process');
+
+const PUSH_TIMEOUT_MS = 60000;
+
+function tryExec(cmd, cwd, execImpl) {
+  const execSync = (execImpl || realExecSync);
+  try {
+    return {
+      ok: true,
+      out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], timeout: PUSH_TIMEOUT_MS }).toString().trim(),
+    };
+  } catch (e) {
+    const stderr = (e.stderr ? e.stderr.toString() : e.message || String(e)).trim();
+    return { ok: false, err: stderr };
+  }
+}
+
+function escapeBranch(name) {
+  return '"' + String(name).replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+}
+
+function classifyError(stderr) {
+  const s = (stderr || '').toLowerCase();
+  if (s.includes('permission denied (publickey)')) return 'ssh-auth-failed';
+  if (s.includes('authentication failed')) return 'https-auth-failed';
+  if (s.includes('could not resolve host') || s.includes('hung up') || s.includes('connection refused')) {
+    return 'network-unreachable';
+  }
+  if (s.includes('protected branch') || s.includes('deny updating')) return 'branch-protected';
+  if (s.includes('already exists')) return 'remote-exists';
+  if (s.includes('non-fast-forward')) return 'non-fast-forward';
+  return 'unknown';
+}
+
+/**
+ * 采集远程分支的元信息（hash/author/date/message + 本地 hash）
+ * 任意子命令失败时返回 null（不抛错）
+ * @param {string} repoPath
+ * @param {string} branch
+ * @param {string} remote
+ * @param {{ execSyncImpl?: Function }} [opts]
+ * @returns {{ remote: {hash, author, date, message}, local: {hash} } | null}
+ */
+function collectRemoteMetadata(repoPath, branch, remote, opts) {
+  const execImpl = opts && opts.execSyncImpl;
+  try {
+    const remoteHash = tryExec('git rev-parse ' + escapeBranch(remote + '/' + branch), repoPath, execImpl);
+    if (!remoteHash.ok || !remoteHash.out) return null;
+
+    const remoteLog = tryExec('git log -1 --format="%an <%ae> | %ad | %s" ' + escapeBranch(remote + '/' + branch), repoPath, execImpl);
+    const localHash = tryExec('git rev-parse ' + escapeBranch(branch), repoPath, execImpl);
+    if (!remoteLog.ok || !localHash.ok || !localHash.out) return null;
+
+    // 解析 "author <email> | date | message"
+    const parts = remoteLog.out.split(' | ');
+    const author = parts[0] || '';
+    const date = parts[1] || '';
+    const message = parts.slice(2).join(' | ') || '';
+
+    return {
+      remote: {
+        hash: remoteHash.out,
+        author,
+        date,
+        message,
+      },
+      local: {
+        hash: localHash.out,
+      },
+    };
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * 推送单个仓库的分支并建立 upstream
+ * @param {string} repoPath
+ * @param {string} repoName
+ * @param {string} branch
+ * @param {{ execSyncImpl?: Function }} [opts]
+ * @returns {{ name: string, status: string, upstream?: string, error?: string, message?: string, metadata?: object }}
+ */
+function pushSingle(repoPath, repoName, branch, opts) {
+  const execImpl = opts && opts.execSyncImpl;
+  const remote = tryExec('git remote', repoPath, execImpl);
+  if (!remote.ok || !remote.out) {
+    return { name: repoName, status: 'failed', error: 'no-remote', message: '无远程配置' };
+  }
+  const r = remote.out.split(/\r?\n/)[0];
+  const branchEsc = escapeBranch(branch);
+  const remoteEsc = '"' + String(r).replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+  const pushResult = tryExec('git push -u ' + remoteEsc + ' ' + branchEsc, repoPath, execImpl);
+  if (pushResult.ok) {
+    return { name: repoName, status: 'pushed', upstream: r + '/' + branch };
+  }
+  const errCode = classifyError(pushResult.err);
+  if (errCode === 'remote-exists') {
+    const metadata = collectRemoteMetadata(repoPath, branch, r, opts);
+    return {
+      name: repoName,
+      status: 'remote-exists',
+      error: errCode,
+      message: '远程分支已存在，需用户决策',
+      metadata,
+    };
+  }
+  return { name: repoName, status: 'failed', error: errCode, message: pushResult.err.split(/\r?\n/)[0] };
+}
+
+module.exports = { tryExec, escapeBranch, classifyError, pushSingle, collectRemoteMetadata };

package/cbb/worktrees/_shared/scripts/silence-popup.js

@@ -0,0 +1,23 @@
+// silence-popup.js (shared)
+// Silences Windows 0xc0000142 (STATUS_DLL_INIT_FAILED) popups from child git processes.
+// Cross-platform: only effective on Windows; no-op on macOS/Linux.
+// 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）。
+// skill 内同目录引用：脚本第一行 `require('./silence-popup')`。
+if (process.platform === 'win32') {
+  try {
+    const path = require('path');
+    const { execSync } = require('child_process');
+    const globalRoot = execSync('npm root -g', { stdio: 'pipe', timeout: 5000 }).toString().trim();
+    const koffiPath = path.join(globalRoot, '@jspg-ai', 'coding-bb', 'node_modules', 'koffi');
+    const koffi = require(koffiPath);
+    const kernel32 = koffi.load('kernel32.dll');
+    const SetErrorMode = kernel32.func('uint __stdcall SetErrorMode(uint uMode)');
+    // SEM_FAILCRITICALERRORS=0x0001 | SEM_NOGPFAULTERRORBOX=0x0002 | SEM_NOOPENFILEERRORBOX=0x8000
+    SetErrorMode(0x0001 | 0x0002 | 0x8000);
+  } catch (e) {
+    // koffi unavailable or SetErrorMode failed: silently continue (worst case: popups may reappear)
+  }
+}

package/cbb/worktrees/commands/close.md

@@ -0,0 +1,64 @@
+---
+name: "OPSX: Close"
+description: 关闭/清理由 init-worktree 创建的多仓库联动 worktree 工作空间，移除 worktree 并按用户选择处理特性分支
+category: Workflow
+tags: [worktree, cleanup, worktree, git-worktree]
+---
+
+# OPSX: Close - 关闭 Worktree
+
+## 重要：第一步必须用 Read 工具直接打开 SKILL.md
+
+**禁止**用 `ls` / `find` / `cat` / `head` / `grep` 等 bash 命令搜索 SKILL.md。这些命令在 Qoder Windows PowerShell 沙箱中经常失败。
+
+**直接路径**：
+- Qoder 适配器：`.qoder/skills/openspec-close-worktree/SKILL.md`
+- Claude Code 适配器：`.claude/skills/openspec-close-worktree/SKILL.md`
+
+**第一步**：
+1. 用 Read 工具直接打开 SKILL.md
+2. 按 SKILL.md 的 Step 0 → 1 → 2 → 3 → 4 → 5 → 6 顺序执行
+3. 每次调用 Node.js 脚本时使用**绝对路径**
+
+## Input
+
+参数 `<分支名>`（可选），指定要关闭的 worktree 对应的特性分支。**未提供时按 SKILL.md Step 1 在对话中询问或自动选取唯一 worktree**。
+
+**Steps 概述**（完整流程见 SKILL.md）
+
+1. Step 0：前置校验（Git 仓库检测、CONFIG.json 检测，支持向上查找）
+2. Step 1：确定要关闭的目标 worktree（列出 `.worktrees/` 下的工作空间 worktree，用户选择或自动选取）
+3. Step 2：发现关联应用 worktree（读 CONFIG.json，按实际存在性确定关联清单）
+4. Step 3：安全检查（未提交修改 / 是否合并到主分支 / 是否推到远程，含主动 fetch 刷新远程引用）
+5. Step 4：用户决策（未提交修改处理方式 + 分支处理方式，AskUserQuestion 固定选项）
+6. Step 5：移除 Worktree（三层降级策略：正常移除 → prune+物理删除 → 仅 prune 延迟清理）
+7. Step 5.5：二次确认 worktree 已移除（确保分支不再被检出）
+8. Step 6：删除分支（按用户选择的 MODE：保留 / 删本地 / 删本地+远程）
+9. Step 8：确认收尾（pwd 确认、残留检查、最终报告）
+
+**Output**
+
+```
+✅ 工作空间 worktree 已关闭
+  当前目录：<工作空间根目录绝对路径>
+  已移除 worktree：
+    - .worktrees/worktree-<需求名>（workspace）
+    - .worktrees/worktree-<需求名>/<应用名1>（嵌套）
+    - .worktrees/worktree-<需求名>/<应用名2>（嵌套）
+  未提交修改：已丢弃（--force）/ 无
+  分支处理：<需求名> 已删除（本地+远程）/ 已删除（本地）/ 已保留
+  剩余工作空间 worktree：<列出仍存在的，或 "无" >
+  Workspace cleaned up.
+```
+
+详细输出格式与安全检查报告，见 SKILL.md「最终报告」与「Step 3」段。
+
+**Guardrails**
+
+- 必须在业务工作空间根目录执行（包含 CONFIG.json 的目录），支持从 worktree 内部向上查找
+- 顺序硬约束：**先移除所有 worktree，再删除分支**（先删分支会报 `Cannot delete branch checked out at`）
+- 破坏性操作必须先报告、经用户确认才执行（未提交修改、未合并分支绝不静默 `--force` 或 `-D`）
+- 只操作 `.worktrees/worktree-<需求名>` 路径，绝不碰其它 worktree（如 IDE 会话 worktree）
+- 关联应用以实际存在的 worktree 为准，不假设 CONFIG.json 中所有应用都有关联
+- 依赖 shell 函数的脚本必须整段在一次 Bash 调用中执行（函数不跨调用保留）
+- git 操作一律用 `git -C <仓库>` 绝对路径，不依赖跨调用的 cwd

package/cbb/worktrees/commands/extend.md

@@ -0,0 +1,65 @@
+---
+name: "OPSX: Extend"
+description: 为已存在的 worktree（init-worktree 创建的工作空间）补加关联应用，添加嵌套 worktree，不影响现有开发
+category: Workflow
+tags: [worktree, extend, worktree, git-worktree, add-app]
+---
+
+# OPSX: Extend - 补加应用到现有 Worktree
+
+## 重要：第一步必须用 Read 工具直接打开 SKILL.md
+
+**禁止**用 `ls` / `find` / `cat` / `head` / `grep` 等 bash 命令搜索 SKILL.md。这些命令在 Qoder Windows PowerShell 沙箱中经常失败。
+
+**直接路径**：
+- Qoder 适配器：`.qoder/skills/openspec-extend-worktree/SKILL.md`
+- Claude Code 适配器：`.claude/skills/openspec-extend-worktree/SKILL.md`
+
+**第一步**：
+1. 用 Read 工具直接打开 SKILL.md
+2. 按 SKILL.md 的 Step 0 → 1 → 2 → 3 → 4 → 5 顺序执行
+3. 每次调用 Node.js 脚本时使用**绝对路径**
+
+## Input
+
+无必需参数。
+
+- 未指定时自动识别目标 worktree：cwd 在 worktree 内则反推需求名；唯一 worktree 时自动选用；多个时按 SKILL.md Step 0.2 在对话中提问
+- 也可在斜杠命令后直接传 `<需求名>`（kebab-case），与已有 worktree 匹配则使用
+
+**Steps 概述**（完整流程见 SKILL.md）
+
+1. Step 0：前置校验（向上查找 CONFIG.json + cwd 反推需求名 + 校验目标 worktree 存在）
+2. Step 1：选择要补加的应用（CONFIG.json 减去已关联 → AskUserQuestion multiSelect）
+3. Step 2：状态检查（仅对新增应用，workspace 跳过）
+4. Step 3：创建分支 + 嵌套 worktree（仅对新增应用，分支已存在则复用）
+5. Step 4：在新增 worktree 中执行 `cbb init -y`（`.cbb/.managed-by-cbb` 判重）
+6. Step 5：报告扩展前后对比（**不切 IDE 窗口**，用户留在原 worktree）
+
+**Output**
+
+```
+✅ worktree 已扩展
+  目标 worktree:  <需求名>
+  工作空间根:    <WS_ROOT>
+  当前目录:      <cwd>
+  补加应用:
+    - ep-user-info-server  → .worktrees/<需求名>/ep-user-info-server
+    - ep-user-web          → .worktrees/<需求名>/ep-user-web
+  AI 配置:       ✅ 已安装（新建）/ 跳过（已存在）
+  已存在的关联应用（本次未变）：
+    - ep-user-auth-app
+```
+
+详细输出格式与失败回滚命令，见 SKILL.md「最终报告」与「常见错误」段。
+
+**Guardrails**
+
+- **目标 worktree 必须已存在**（`.worktrees/<需求名>/` 必须存在），否则提示用 init-worktree
+- **不重建、修改、删除任何已存在的 worktree**——只增量添加
+- 嵌套 worktree 路径与 init-worktree 完全一致：`.worktrees/<需求名>/<应用名>/`
+- 分支名与 init-worktree 一致：`<需求名>`（不加前缀）
+- 仅对待补加应用执行状态检查、clone/fetch、创建分支、worktree add
+- **不切 IDE 窗口**——用户在原 worktree 继续开发，扩展的工作是嵌套子目录
+- 自由文本输入（需求名、应用 URL）禁止使用 `AskUserQuestion`，仅在固定选项场景（应用多选）使用
+- 必须单次 Bash 调用合并 `cd "..." && ...`，不依赖跨调用的 cwd

package/cbb/worktrees/commands/init.md

@@ -0,0 +1,55 @@
+---
+name: "OPSX: Init"
+description: 为一个需求在 workspace 与各关联应用仓库同步创建同名 git worktree，物理直聚在 `.worktrees/<需求名>/` 目录
+category: Workflow
+tags: [worktree, isolation, worktree, git-worktree]
+---
+
+# OPSX: Init - 创建 Worktree
+
+## 重要：第一步必须用 Read 工具直接打开 SKILL.md
+
+**禁止**用 `ls` / `find` / `cat` / `head` / `grep` 等 bash 命令搜索 SKILL.md 是否存在。**这些命令在 Qoder Windows PowerShell 沙箱中经常失败**（如 `head` 不存在、stderr 重定向无效等）。
+
+**直接路径**：
+- Qoder 适配器：`.qoder/skills/openspec-init-worktree/SKILL.md`
+- Claude Code 适配器：`.claude/skills/openspec-init-worktree/SKILL.md`
+
+**第一步**：
+1. 用 Read 工具直接打开 `.qoder/skills/openspec-init-worktree/SKILL.md`（或 `.claude/skills/...`）
+2. 按 SKILL.md 的 Step 0 → 1 → 2 → 3 → 4 → 5 → 6 顺序执行
+3. 每次调用 Node.js 脚本时，使用**绝对路径**（避免依赖相对路径）：
+   ```
+   node "D:\workspace\<用户工作空间>\.qoder\skills\openspec-init-worktree\scripts\<name>.js" <参数>
+   ```
+   - 参数形式：
+     - `check-env.js`：无参数
+     - `parse-config.js`：无参数
+     - `sync-repos.js`：`<ws_root>`
+     - `check-repos.js`：`<ws_root>`
+     - `create-branches.js`：`<ws_root> <branch>`
+     - `update-gitignore.js`：`<ws_root> <branch>`
+     - `create-worktrees.js`：`<ws_root> <branch>`
+     - `install-ai.js`：`<wt_path>`
+     - `auto-open.js`：`<wt_path>`
+
+## Input
+
+参数 `<需求名>`（kebab-case），同时作分支名和 workspace 工作树目录名。**未提供时按 SKILL.md Step 3.1 在对话中询问**。
+
+## 流程总览（完整流程见 SKILL.md）
+
+1. Step 0：环境探活 + 解析 CONFIG.json
+2. Step 1：同步 .code/ 仓库（fetch --all）
+3. Step 2：状态检查（5 项 / 3 项分级）
+4. Step 3：创建分支（workspace 从 HEAD，app 从 origin/master）
+5. Step 4：创建 worktree（workspace + 嵌套 app）
+6. Step 5：在 worktree 中安装 AI 配置（cbb init -y）
+7. Step 6：环境感知 + 进入工作目录
+
+## 关键 Guardrails
+
+- workspace 主分支 tracked 的所有内容（openspec/、cbb/ 等）由 git worktree 自动 checkout——**禁止 cp / clone / symlink “带过来”**
+- 必须用 `git branch` 而非 `git checkout -b`（分支不能同时在主目录与 worktree 检出）
+- 沙箱内 node 不可用时 fail-fast：终止流程并提示用户到系统终端重试
+- **不要试图搜索 SKILL.md**——直接用 Read 工具打开

package/cbb/worktrees/commands/push.md

@@ -0,0 +1,42 @@
+---
+name: "OPSX: Push"
+description: 跨 worktree 提交并推送当前需求的所有关联仓库到 origin
+category: Workflow
+tags: [workflow, push, commit, worktree, experimental]
+---
+
+跨 worktree 提交并推送当前需求的所有关联仓库到 origin。
+
+**Input**: 可选指定需求名（如 `/opsx:push ft-diff-on-cargo`）。省略时从 cwd 的 `.worktrees/worktree-<需求名>/` 路径推断（cwd 在工作空间根目录时由 Step 0 定位）。
+
+**何时使用**：
+
+- apply 完成后准备推送所有改动
+- close-worktree 前需要先确保 ahead 提交已推送（避免丢）
+- 开发过程中想保存中间进度
+- 用户口语化说"提交并push" / "推一下"
+
+**Steps 摘要**（详细见 [openspec-push-worktrees SKILL.md](../../skills/openspec-push-worktrees/SKILL.md)）：
+
+1. **Step 0**：定位工作空间根（find-workspace-root.js）
+2. **Step 1**：识别目标 worktree（find-target-worktree.js）
+3. **Step 2**：扫描所有 worktree 仓库状态（commit-worktrees.js --dry-run）
+4. **Step 3**：对话中收集 commit 信息（必须由用户提供）
+5. **Step 4**：批量 commit（commit-worktrees.js）
+6. **Step 5**：批量 push（push-worktrees.js）
+7. **Step 6**：汇总报告
+
+**关键 Guardrails**：
+
+- 严格按 Step 0 → 1 → 2 → 3 → 4 → 5 → 6 顺序执行
+- **Step 2 dry-run 必跑**，让用户看到将要 commit 的内容
+- **Step 3 必问用户 commit 信息**（自由文本），禁止自动生成
+- 默认 `git add -u`（仅 tracked），避免误纳未追踪文件
+- push 失败时阻塞并按错误码分类处理，**禁止**自动跳过失败仓库
+- 远程分支已存在时必须输出 commit 元信息再询问用户决策
+
+**Failure Handling**：
+
+- commit-worktrees.js 退出码 2 → 部分 commit 失败，**阻塞流程**，询问用户
+- push-worktrees.js 退出码 2 → 部分 push 失败，**阻塞流程**，按错误码询问用户
+- 远程分支已存在 → 先输出元信息，再 AskUserQuestion 让用户选择「关联」或「终止」