@jspg-ai/coding-bb 0.0.3-beta.3 → 0.0.3-beta.30

package/cbb/worktrees/skills/cbb-worktree-init/scripts/update-gitignore.js

@@ -6,13 +6,13 @@ require('./silence-popup');
  * 用法：node update-gitignore.js <ws_root> <branch>
  *
  * 行为：
- *   1. stash 当前未提交修改
- *   2. 切换到目标分支
- *   3. 检查 .worktrees/ 和 .codespace/ 是否在 .gitignore
- *   4. 添加缺失条目
- *   5. 提交 .gitignore
- *   6. 切回原分支
- *   7. pop stash（如有）
+ *   1. stash 当前未提交修改（仅 untracked 时不产生 stash）
+ *   2. 目标分支不存在则从 <remote>/<main> 创建（首跑时分支尚未由 create-branches.js 建立，
+ *      顺序无关自愈；create-branches.js 后续会报 reused；基线不取 HEAD，见 ADR 0002）
+ *   3. 切换到目标分支
+ *   4. 检查 .worktrees/ 和 .codespace/ 是否在 .gitignore，缺失则添加并提交
+ *   5. 切回原分支
+ *   6. pop stash（如有）
  *
  * 幂等：目标分支已在某个 worktree 中检出（init-worktree 重跑场景，上次已处理过
  * .gitignore）时，跳过全部操作直接输出 GITIGNORE_OK——避免 checkout 与 worktree 检出冲突。
@@ -67,8 +67,12 @@ const status = run('git status --porcelain', wsRoot);
 if (status.ok && status.out) {
   const stash = run('git stash push -m "init-worktree-temp"', wsRoot);
   if (stash.ok) {
-    stashed = true;
-    console.log('✅ 已 stash 未提交修改');
+    if (/No local changes to save/.test(stash.out)) {
+      console.log('ℹ️  仅 untracked 文件，无需 stash');
+    } else {
+      stashed = true;
+      console.log('✅ 已 stash 未提交修改');
+    }
   } else {
     console.error('❌ git stash 失败：' + stash.err);
     process.exit(2);
@@ -77,6 +81,30 @@ if (status.ok && status.out) {
   console.log('ℹ️  无未提交修改，跳过 stash');
 }
 
+// 2.1 目标分支不存在则创建（Step 3.2 先于 Step 3.3 执行时分支尚未建立）
+// 基线取 <remote>/<main>（ADR 0002，与 create-branches.js 一致）：本地模式进行中根可能检出在
+// feature 分支，从 HEAD 建会把未合并的开发态带进新分支；无 remote 时回退 HEAD
+const branchList = run('git branch --list "' + branch + '"', wsRoot);
+if (branchList.ok && !branchList.out) {
+  const remoteOut = run('git remote', wsRoot);
+  let base = 'HEAD';
+  if (remoteOut.ok && remoteOut.out) {
+    const r = remoteOut.out.split(/\r?\n/)[0];
+    const symbolic = run('git symbolic-ref "refs/remotes/' + r + '/HEAD"', wsRoot);
+    const main = (symbolic.ok && symbolic.out)
+      ? symbolic.out.replace('refs/remotes/' + r + '/', '')
+      : 'main';
+    base = r + '/' + main;
+  }
+  const create = run('git branch "' + branch + '" "' + base + '"', wsRoot);
+  if (!create.ok) {
+    console.error('❌ 创建分支 ' + branch + ' 失败：' + create.err);
+    if (stashed) run('git stash pop', wsRoot);
+    process.exit(2);
+  }
+  console.log('✅ 分支 ' + branch + ' 不存在，已从 ' + base + ' 创建');
+}
+
 // 3. 切换到目标分支
 const checkout = run('git checkout "' + branch + '"', wsRoot);
 if (!checkout.ok) {

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

@@ -1,24 +1,21 @@
 ---
 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 批量），推送后提案生成 MR（合并请求）预填链接。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'/'提MR'/'提合并请求'/'merge request'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-worktree 前需要先推送未提交改动。注意：本技能会先识别场景——不在 cbb 工作空间时降级为普通单仓库提交推送。"
 ---
 
-# Push Worktrees（跨平台脚本化版本 v1.0）
+# Push Worktrees（跨平台脚本化版本 v2.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 的缺口。
+提交并推送当前需求的所有关联仓库（跨仓库批量，ADR 0002 双布局：worktree 布局或本地模式布局自动发现）。专门解决"开发完成后批量推送"和"用户口语化提交并push"两类场景——本技能是**唯一的远端推送出口**（cbb-worktree-init 自 0.0.3-beta.22 起 lazy push，创建流程零远端副作用；首次 push 自动建立 upstream）。
 
-**启动时声明：** "我正在使用 cbb-worktree-push 技能来批量提交并推送当前需求的所有 worktree 仓库。"
+> **本技能描述含宽泛触发词（"提交"/"push"），允许被误触发**。因此第一步永远是 **Step 0 场景识别**：在 cbb 工作空间内才走跨 worktree 批量流程；在普通 git 仓库降级为单仓库提交推送；非 git 目录则退出。
+
+**启动时声明：** "我正在使用 cbb-worktree-push 技能来推送当前需求的关联仓库。"
 
 ## 核心原则
 
 - 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**
 - **两阶段**：先 `commit-worktrees.js` 提交所有 dirty 仓库，再 `push-worktrees.js` 推送所有 worktree 仓库。两个脚本独立退出码，AI agent 区分阶段
+- **push 后 MR 提案（Step 7）**：`make-mr-urls.js` 生成预填合并请求链接（可自动开浏览器）；只生成链接，提交/评审/合并全部由人在平台完成，不触碰任何凭据
 - 复用 `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` 对称）：
@@ -30,12 +27,18 @@ metadata:
 
 ## 调用脚本的统一方式
 
-**所有脚本必须用绝对路径调用**（Agent 运行环境中 AI agent 的 cwd 不一定是技能目录）。
+**重要**：本技能的所有脚本位于**本 SKILL.md 所在目录的 `scripts/` 下**（skill 目录）。
+
+调用时用**本技能目录的绝对路径**拼接脚本名（AI 读取本 SKILL.md 时即已知该目录）：
 
 ```
-node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/<name>.js" <参数>
+node "<skill_dir>/scripts/<name>.js" <参数>
 ```
 
+> - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `CBB-WORKSPACE.json` 与 git 仓库
+> - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
+
 脚本输出：
 - 人类可读报告（OK / FAIL / WARN）
 - 机器可读摘要（末行以 `COMMIT_RESULT` / `PUSH_RESULT` 开头）
@@ -43,28 +46,54 @@ node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/<name>.js" <参数>
 
 ---
 
-## Step 0：定位工作空间
+## Step 0：场景识别（先判场景，再定策略）
+
+**本技能允许被"提交"/"push"这类宽泛措辞误触发**。执行任何操作前，先判断当前处于哪种场景，按场景选择策略——**不要硬套 cbb 工作空间流程**。
+
+判断依据（任一命中即定场景）：
+
+| 场景 | 判据 | 策略 |
+|------|------|------|
+| **A. cbb 工作空间根** | cwd（或其 git 顶层）含 `CBB-WORKSPACE.json`；`find-workspace-root.js` 退出码 0 | 走 **Step 1 → 6** 的跨 worktree 批量流程 |
+| **B. worktree 内** | cwd 命中 `<ws_root>/.worktrees/worktree-<需求名>/` | 用 cwd 反推 `<需求名>`，走 **Step 1 → 6** 批量流程 |
+| **C. 普通 git 仓库** | 在 git 仓库内，但无 `CBB-WORKSPACE.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>/.qoder/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 是兜底：让"提交代码"在普通仓库里也能正常完成，而不是因找不到 `CBB-WORKSPACE.json` 报错。
 
 ---
 
-## Step 1：识别目标 worktree
+## Step 1：识别目标 worktree（A/B 场景）
 
 ```bash
-node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/find-target-worktree.js" "<ws_root>"
+node "<skill_dir>/scripts/find-target-worktree.js" "<ws_root>"
 ```
 
 **解读末行**：
-- 退出码 0 + 末行（需求名） → 唯一识别，自动用之
-- 退出码 1 + 末行 `MULTIPLE_WORKTREEES` → 多个 worktree，AI agent 在对话中让用户输入序号或分支名
-- 退出码 2 + 末行 `NO_WORKTREE` → 无 worktree，提示用户先用 `cbb-worktree-init`
+- 退出码 0 + 末行（需求名） → 唯一识别，自动用之（脚本自动合并 worktree 布局与本地模式布局候选，`（local）` 标本地模式进行中）
+- 退出码 1 + 末行 `MULTIPLE_WORKTREEES` → 多个进行中需求，AI agent 在对话中让用户输入序号或分支名
+- 退出码 2 + 末行 `NO_WORKTREE` → 无进行中需求，提示用户先执行 `cbb-worktree-init`（worktree 模式）或 `cbb-local-mode`（本地模式）
 
 ---
 
@@ -72,7 +101,7 @@ node "<ws_root>/.qoder/skills/cbb-worktree-push/scripts/find-target-worktree.js"
 
 ```bash
 # 仅 commit 阶段先做 dry-run 预览
-node "<ws_root>/.qoder/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`**：每项仓库的状态
@@ -94,7 +123,7 @@ AI agent 在执行真实 commit 前**必须**在对话中向用户确认 commit
 
 ```
 检测到以下 worktree 仓库有未提交改动：
-  - workspace: 5 个文件（workspace-config.json, openspec/changes/foo/...）
+  - workspace: 5 个文件（CBB-WORKSPACE.json, openspec/changes/foo/...）
   - ep-foo-app: 12 个文件
   - ep-bar-app: 3 个文件
 
@@ -119,16 +148,16 @@ AI agent 在执行真实 commit 前**必须**在对话中向用户确认 commit
 
 ```bash
 # 统一信息
-node "<ws_root>/.qoder/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 +184,10 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>" --message "..."
 ## Step 5：批量 push
 
 ```bash
-node "<ws_root>/.qoder/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`**：
@@ -196,6 +225,39 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 
 ---
 
+## Step 7：MR 提案（push 完成后）
+
+Step 5 的 `PUSH_RESULT` 中至少一个仓库为 `pushed` / `skipped`（feature 分支已在远端）时，用 `AskUserQuestion`（固定选项）提案：
+
+```
+推送完成。要提 MR（合并请求）吗？
+  [提 MR 到测试分支]  生成预填的 MR 创建链接（如 dev/test）
+  [提 MR 到正式分支]  生成预填的 MR 创建链接（如 main/master）
+  [暂不提 MR]         结束本步
+```
+
+用户选择提 MR 后：
+
+1. **确定目标分支（交互式，禁止 AI 代决）**：`git branch -r` 列出现场实际的主干候选（dev / test / develop / main / master / release-*），请用户指定一个；全仓库统一用该目标分支（不存在此分支的仓库由脚本自动跳过）
+2. **生成链接**：
+
+```bash
+node "<skill_dir>/scripts/make-mr-urls.js" "<ws_root>" "<branch>" "<target>" --open
+```
+
+**解读末行 `MR_RESULT`**（逐仓库）：
+- `ok` → 已生成 URL（`--open` 时已开浏览器；用户在平台页面确认标题/评审人后提交）
+- `no-diff` → 与目标分支无差异，跳过
+- `not-pushed` → feature 分支不在远端（提示先完成 push）
+- `no-target` → 远端无该目标分支（回退重新指定候选）
+- `manual` → origin 无法解析为已知平台，输出手动创建指引；可用 `--platform gitlab|github|gitee` 强制
+
+> 平台识别：`github.com` → PR compare、`gitee.com` → compare、**其余默认 GitLab**（企业自建主流）；误判用 `--platform` 覆盖。
+
+3. **提 MR 后提醒用户后续链路**：测试环境部署 → 用户验收 → 验收通过后 `/opsx:archive` → 正式分支合并走公司发布流程 → 最后 `cbb-worktree-close`
+
+---
+
 ## 最终报告
 
 ```
@@ -210,8 +272,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 关闭
+  后续：Step 7 提 MR 到测试分支 → 部署验收 → 验收通过后 /opsx:archive → 正式发布（公司流程）→ cbb-worktree-close
 ```
 
 ---
@@ -220,8 +281,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 仓库（无 CBB-WORKSPACE.json） | **降级为单仓库提交推送**，不调用 worktree 脚本 |
+| 场景 D：cwd 非 git 目录 | 说明情况并终止，不做任何操作 |
 | commit 信息缺失 | 必须询问用户；禁止自动生成（可基于 apply task 上下文给建议） |
 | 多仓库需不同 commit 信息 | 用 `--per-repo "ep-foo:m1;ep-bar:m2"`，必须由用户逐条提供 |
 | 仓库干净 | commit-worktrees 自动 skipped，只 push 不 commit |
@@ -230,12 +294,20 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 | 远程分支已存在 | push 退出码 2，AI 输出元信息后由用户决策（关联/终止） |
 | push 失败（SSH/HTTPS/网络/保护） | push 退出码 2，AI 按错误码分类处理，阻塞并询问用户 |
 | close-worktree 前调用 | 先调本 skill 把 ahead 推送完，避免 close 时丢提交 |
+| push 完成后 | Step 7 MR 提案：AskUserQuestion 固定选项 → make-mr-urls.js 生成预填链接 + 开浏览器；只生成链接，不代合并 |
+| MR 目标分支 | 交互式：`git branch -r` 列主干候选由用户指定，全仓库统一；缺该分支的仓库自动跳过（no-target） |
+| MR 平台误判 | 非 github.com/gitee.com 默认按 GitLab 拼 URL；有误判用 `--platform gitlab\|github\|gitee` 强制 |
 | --dry-run | 任何时候想预览将要 commit 的内容时使用，不实际修改任何东西 |
 
 ---
 
 ## 常见错误
 
+### 误触后硬套 worktree 流程
+
+- **问题：** 用户在普通仓库说"提交代码"，技能被 description 匹配触发，直接跑 `find-workspace-root.js` 失败并报错终止
+- **修复：** Step 0 先判场景；场景 C（普通 git 仓库）降级为单仓库提交推送，不调用 worktree 脚本、不提及批量流程
+
 ### 自动生成 commit 信息不让用户确认
 
 - **问题：** agent 拍脑袋写 "feat: xxx"，与用户实际意图不符
@@ -258,7 +330,7 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 
 ### 多仓库用同一条 commit 信息
 
-- **问题：** workspace 改了 workspace-config.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
+- **问题：** workspace 改了 CBB-WORKSPACE.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
 - **修复：** 用 `--per-repo` 模式，让用户逐仓库提供
 
 ### push 失败时跳过失败仓库直接继续
@@ -283,16 +355,20 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 - 远程分支已存在时脚本自动 set-upstream-to
 - AI 询问关联选项前不输出 commit 元信息
 - 运行环境 node 不可用时强行继续 → 改为 fail-fast 提示用户
+- 代为合并 MR / 直接向测试、正式分支 push / 触碰平台凭据 → MR 只生成预填链接，提交与合并由人在平台完成
+- MR 目标分支由 AI 猜测代决 → 必须列候选让用户指定
 
 **必须执行**
 
-- 严格按 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 上下文生成建议并由用户确认
 - commit-worktrees / push-worktrees 退出码 2 时必须阻塞流程
 - 远程分支已存在时 AI 必须先输出 commit 元信息再询问
+- push 成功后必须走 Step 7 MR 提案（AskUserQuestion 固定选项；用户选"暂不提"则正常结束）
 
 ---
 
@@ -304,4 +380,5 @@ node "..." "<ws_root>/.worktrees/worktree-<branch>"
 | `find-target-worktree.js` | 目标需求名识别（共享脚本，源仓库真源在 `_shared/scripts/`） | ws_root | 0/1/2 |
 | `commit-worktrees.js` | 批量 commit（默认 `-u`，加 `--untracked` 时 `-A`） | ws_root, branch, --message / --per-repo / --untracked / --allow-empty / --dry-run / --skip-repo | 0/1/2 |
 | `push-worktrees.js` | 批量 push（复用 push-core 错误归类） | ws_root, branch（或 wt_path） | 0/1/2 |
+| `make-mr-urls.js` | 生成预填 MR/PR 创建链接（平台识别 + 远端校验 + diff 判定 + `--open` 开浏览器） | ws_root, branch, target（或 wt_path, target）, --platform, --open | 0/1/2 |
 | `push-core.js` | 推送核心（classifyError / pushSingle / collectRemoteMetadata，共享脚本，源仓库真源在 `_shared/scripts/`） | （共享模块） | - |

package/cbb/worktrees/skills/cbb-worktree-push/scripts/commit-worktrees.js

@@ -7,7 +7,9 @@ require('./silence-popup');
  *   node commit-worktrees.js <wt_path> --message "msg" [options]
  *
  * 行为：
- *   1. 扫描 <ws_root>/.worktrees/worktree-<branch>/ 下所有 git 仓库
+ *   1. 按需求名发现参与仓库（ADR 0002 双布局）：
+ *      - worktree 布局：.worktrees/worktree-<branch>/ 的 workspace + 其 .codespace/<app>/ 容器内各 app worktree（镜像主布局，ADR 0003）
+ *      - 本地布局：根 / .codespace/<app>/ 检出恰在 <branch> 分支上
  *   2. 对每个仓库：
  *      a. git status --porcelain 检测 dirty
  *      b. 若 clean 或已有 ahead commit → 跳过
@@ -95,23 +97,79 @@ function isGitRepo(p) {
   return fs.existsSync(path.join(p, '.git'));
 }
 
+/** 读取 CBB-WORKSPACE.json 的 app 名列表（旧布局兼容判定用；缺失返回 []） */
+function loadAppNames(wsRoot) {
+  try {
+    const cfg = JSON.parse(fs.readFileSync(path.join(wsRoot, 'CBB-WORKSPACE.json'), 'utf-8'));
+    return Array.isArray(cfg.apps) ? cfg.apps.map(a => a.name).filter(Boolean) : [];
+  } catch (e) {
+    return [];
+  }
+}
+
+function currentBranch(p) {
+  try {
+    return execSync('git branch --show-current', { cwd: p, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).toString().trim();
+  } catch (e) { return ''; }
+}
+
+/**
+ * 按需求名发现参与仓库（ADR 0002 双布局）：
+ *   布局一 worktree：.worktrees/worktree-<branch>/ 的 workspace + 其 .codespace/<app>/ 容器内 app worktree（ADR 0003 镜像主布局；≤beta.23 旧平铺顶层布局按配置 app 名兼容）
+ *   布局二 本地模式：根 / .codespace/<app>/ 的检出恰在 <branch> 分支上（同名仓库以 worktree 布局优先）
+ * 两者皆空 → error。
+ */
 function scanWorktreeRepos(wsRoot, branch) {
   const wtRoot = path.join(wsRoot, '.worktrees', 'worktree-' + branch);
   const repos = [];
-  if (!fs.existsSync(wtRoot)) {
-    return { wtRoot, repos, error: 'worktree 目录不存在：' + wtRoot };
+
+  // 布局一：worktree
+  if (fs.existsSync(wtRoot)) {
+    if (isGitRepo(wtRoot)) {
+      repos.push({ name: 'workspace', wt: wtRoot, repo: wsRoot, layout: 'worktree' });
+    }
+    // app worktree 收拢在 .codespace/ 容器内（镜像主布局，ADR 0003）
+    const appContainer = path.join(wtRoot, '.codespace');
+    if (fs.existsSync(appContainer)) {
+      for (const e of fs.readdirSync(appContainer, { withFileTypes: true })) {
+        if (!e.isDirectory()) continue;
+        const appWt = path.join(appContainer, e.name);
+        if (!isGitRepo(appWt)) continue;
+        repos.push({ name: e.name, wt: appWt, repo: path.join(wsRoot, '.codespace', e.name), layout: 'worktree' });
+      }
+    }
+    // 兼容 ≤beta.23 旧平铺布局：按配置 app 名精确匹配（避免把根仓库自带的嵌套 git 目录误判为 app）
+    for (const name of loadAppNames(wsRoot)) {
+      if (repos.some(r => r.name === name)) continue;
+      const legacyWt = path.join(wtRoot, name);
+      if (fs.existsSync(path.join(legacyWt, '.git'))) {
+        console.error('⚠️  ' + name + ' 仍是旧平铺布局（' + legacyWt + '），建议重跑 cbb-worktree-init 迁移到 .codespace/ 容器');
+        repos.push({ name, wt: legacyWt, repo: path.join(wsRoot, '.codespace', name), layout: 'worktree' });
+      }
+    }
   }
-  if (isGitRepo(wtRoot)) {
-    repos.push({ name: 'workspace', wt: wtRoot, repo: wsRoot });
+
+  // 布局二：本地模式（检出在需求分支上）
+  const names = new Set(repos.map(r => r.name));
+  if (!names.has('workspace') && isGitRepo(wsRoot) && currentBranch(wsRoot) === branch) {
+    repos.push({ name: 'workspace', wt: wsRoot, repo: wsRoot, layout: 'local' });
   }
-  const entries = fs.readdirSync(wtRoot, { withFileTypes: true });
-  for (const e of entries) {
-    if (!e.isDirectory() || e.name.startsWith('.')) continue;
-    const appWt = path.join(wtRoot, e.name);
-    if (!isGitRepo(appWt)) continue;
-    repos.push({ name: e.name, wt: appWt, repo: path.join(wsRoot, '.codespace', e.name) });
+  const codeDir = path.join(wsRoot, '.codespace');
+  if (fs.existsSync(codeDir)) {
+    for (const name of fs.readdirSync(codeDir).sort()) {
+      if (names.has(name)) continue;
+      const appDir = path.join(codeDir, name);
+      if (!isGitRepo(appDir)) continue;
+      if (currentBranch(appDir) === branch) {
+        repos.push({ name, wt: appDir, repo: appDir, layout: 'local' });
+      }
+    }
   }
-  return { wtRoot, repos, error: null };
+
+  const error = repos.length === 0
+    ? ('未发现需求 ' + branch + ' 的参与仓库（worktree 不存在，且无仓库检出在 ' + branch + ' 分支上）')
+    : null;
+  return { wtRoot, repos, error };
 }
 
 function run(cmd, cwd) {