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

package/cbb/worktrees/skills/cbb-worktree-init/scripts/sync-repos.js

@@ -4,7 +4,7 @@ require('./silence-popup');
  * cbb-worktree-init 同步 .codespace/ 仓库
  *
  * 用法：node sync-repos.js <ws_root>
- *   - ws_root: 工作空间根绝对路径（apps 从 <ws_root>/workspace-config.json 读取）
+ *   - ws_root: 工作空间根绝对路径（apps 从 <ws_root>/CBB-WORKSPACE.json 读取）
  *
  * 对每个 app：
  *   - .codespace/<name>/.git 存在 → fetch --all
@@ -19,6 +19,7 @@ require('./silence-popup');
 const { execSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const { installTo: installGitHook } = require('./install-git-hook');
 
 const wsRoot = process.argv[2];
 
@@ -28,23 +29,23 @@ if (!wsRoot) {
 }
 
 /**
- * 从 workspace-config.json 读取 apps（避免 shell 字符串传递中的转义问题）
+ * 从 CBB-WORKSPACE.json 读取 apps（避免 shell 字符串传递中的转义问题）
  */
 function loadAppsFromConfig() {
-  const configPath = path.join(wsRoot, 'workspace-config.json');
+  const configPath = path.join(wsRoot, 'CBB-WORKSPACE.json');
   if (!fs.existsSync(configPath)) {
-    console.error('❌ workspace-config.json 不存在：' + configPath);
+    console.error('❌ CBB-WORKSPACE.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('❌ workspace-config.json 中 apps 为空');
+      console.error('❌ CBB-WORKSPACE.json 中 apps 为空');
       return null;
     }
     return config.apps;
   } catch (e) {
-    console.error('❌ workspace-config.json 解析失败：' + e.message);
+    console.error('❌ CBB-WORKSPACE.json 解析失败：' + e.message);
     return null;
   }
 }
@@ -77,7 +78,10 @@ for (const app of apps) {
     // 不存在：clone
     try {
       execSync('git clone -q "' + app.repo + '" "' + target + '"', { stdio: 'pipe' });
-      console.log('✅ ' + app.name + ': 代码已拉取（clone）');
+      // 兜底 clone 出的应用同步装分支感知 pre-commit hook（ADR 0002；
+      // cbb setup 首次 clone 已装，此处幂等补齐）
+      installGitHook(target);
+      console.log('✅ ' + app.name + ': 代码已拉取（clone + 提交防线 hook）');
       results.push({ name: app.name, status: 'cloned' });
     } catch (e) {
       console.error('❌ ' + app.name + ': clone 失败 — ' + app.repo);

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,11 +1,11 @@
 ---
 name: cbb-worktree-push
-description: "提交并推送当前需求的所有关联仓库（跨 worktree 批量）。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-worktree 前需要先推送未提交改动。注意：本技能会先识别场景——不在 cbb 工作空间时降级为普通单仓库提交推送。"
+description: "提交并推送当前需求的所有关联仓库（跨 worktree 批量），推送后提供交付选择：提 MR（预填链接）或由 agent 直接合并到目标分支（主干/测试分支，ADR 0008）。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'/'提MR'/'提合并请求'/'merge request'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-worktree 前需要先推送未提交改动。注意：本技能会先识别场景——不在 cbb 工作空间时降级为普通单仓库提交推送。"
 ---
 
-# Push Worktrees（跨平台脚本化版本 v1.0）
+# Push Worktrees（跨平台脚本化版本 v2.0）
 
-提交并推送当前需求的所有关联仓库（跨 worktree 批量）。专门解决"开发完成后批量推送"和"用户口语化提交并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）。
 
 > **本技能描述含宽泛触发词（"提交"/"push"），允许被误触发**。因此第一步永远是 **Step 0 场景识别**：在 cbb 工作空间内才走跨 worktree 批量流程；在普通 git 仓库降级为单仓库提交推送；非 git 目录则退出。
 
@@ -15,12 +15,13 @@ description: "提交并推送当前需求的所有关联仓库（跨 worktree
 
 - 本技能的所有原子操作封装为 `scripts/*.js` Node.js 脚本，**跨平台执行**
 - **两阶段**：先 `commit-worktrees.js` 提交所有 dirty 仓库，再 `push-worktrees.js` 推送所有 worktree 仓库。两个脚本独立退出码，AI agent 区分阶段
+- **push 后交付选择（Step 7，ADR 0008）**：三选一——提 MR（`make-mr-urls.js` 生成预填链接，可自动开浏览器；只生成链接，提交/评审/合并由人在平台完成，不触碰凭据）/ **直接合并**（`merge-branches.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` 对称）：
   - 工作空间根目录（`WS_ROOT/`）
   - worktree 内部（`WS_ROOT/.worktrees/worktree-<需求名>/` 或其子目录）
-- 输入约定：**自由文本**（commit 信息、需求名等）直接在对话中提问并等待回复；**固定选项多选**（如 "应用统一信息 vs 分别信息"）使用 `AskUserQuestion`
+- 输入约定：**自由文本**（需求名等）直接在对话中提问并等待回复；**固定选项多选**使用 `AskUserQuestion`。**例外：commit 信息由 agent 自行生成，不提问、不等待确认**
 
 ---
 
@@ -35,7 +36,7 @@ node "<skill_dir>/scripts/<name>.js" <参数>
 ```
 
 > - `<skill_dir>` = 本 SKILL.md 所在目录的绝对路径（AI 从读取路径即可推出）
-> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `workspace-config.json` 与 git 仓库
+> - **cwd 必须保持在工作空间根目录**：脚本按 cwd 定位 `CBB-WORKSPACE.json` 与 git 仓库
 > - 不要用 `./scripts/...` 裸相对路径（AI 的 cwd 不是技能目录，会解析失败）
 
 脚本输出：
@@ -53,9 +54,9 @@ node "<skill_dir>/scripts/<name>.js" <参数>
 
 | 场景 | 判据 | 策略 |
 |------|------|------|
-| **A. cbb 工作空间根** | cwd（或其 git 顶层）含 `workspace-config.json`；`find-workspace-root.js` 退出码 0 | 走 **Step 1 → 6** 的跨 worktree 批量流程 |
+| **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 仓库内，但无 `workspace-config.json`（`find-workspace-root.js` 退出码 1） | **降级为单仓库提交推送**：不调 worktree 脚本，按常规 `git add -u` → 向用户询问 commit 信息 → `git commit` → `git push`（保留本 skill 的"必问 commit 信息"约束） |
+| **C. 普通 git 仓库** | 在 git 仓库内，但无 `CBB-WORKSPACE.json`（`find-workspace-root.js` 退出码 1） | **降级为单仓库提交推送**：不调 worktree 脚本，按常规 `git add -u` → agent 生成 commit 信息 → `git commit` → `git push`（信息生成规则与 A/B 场景一致：精炼最简、5–50 字符） |
 | **D. 非 git 目录** | `git rev-parse --is-inside-work-tree` 失败 | 说明"当前目录不是 git 仓库"，终止，不做任何操作 |
 
 **判场景与定位（A/B 场景）：**
@@ -73,13 +74,13 @@ node "<skill_dir>/scripts/find-workspace-root.js"
 **场景 C 降级流程**（普通仓库误触）：
 
 1. `git status` 报告改动现状
-2. 直接对话询问 commit 信息（**禁止**自动生成）
+2. agent 基于改动内容生成 commit 信息（精炼最简，5–50 字符；规则见 Step 3）
 3. `git add -u`（默认不含未追踪文件；用户明确要求时才 `git add -A`）
-4. `git commit -m "<用户提供的信息>"`
+4. `git commit -m "<agent 生成的信息>"`
 5. `git push`（无 upstream 时先询问用户是否 `-u`）
 6. 汇报结果；**不要**提及 worktree 批量流程
 
-> 场景 C 是兜底：让"提交代码"在普通仓库里也能正常完成，而不是因找不到 `workspace-config.json` 报错。
+> 场景 C 是兜底：让"提交代码"在普通仓库里也能正常完成，而不是因找不到 `CBB-WORKSPACE.json` 报错。
 
 ---
 
@@ -90,9 +91,9 @@ 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`（本地模式）
 
 ---
 
@@ -110,36 +111,27 @@ node "<skill_dir>/scripts/commit-worktrees.js" "<ws_root>" "<branch>" --message
 - `skipped (skip-repo)`：用户指定跳过
 - `failed`：错误
 
-> ⓘ **dry-run 必跑**：让用户确认将要 commit 的内容，避免误纳 `.idea/` 等被 git 忽略的文件（虽然 `git add -u` 已天然排除，但 dry-run 仍是最后的兜底确认）。
+> ⓘ **dry-run 必跑**：把将要 commit 的文件清单与 agent 生成的 commit 信息一并展示给用户（透明可见，**不停顿等待回复**），避免误纳 `.idea/` 等被 git 忽略的文件（虽然 `git add -u` 已天然排除，但 dry-run 仍是最后兜底）。
 
 ---
 
-## Step 3：收集 commit 信息（对话中提问）
+## Step 3：生成 commit 信息（agent 自主）
 
-AI agent 在执行真实 commit 前**必须**在对话中向用户确认 commit 信息。**禁止**自动生成。
+AI agent 在执行 commit 前**自行生成** commit 信息，**不向用户提问、不等待确认**。
 
-**问询模板**（直接对话提问，不用 `AskUserQuestion`）：
+**生成规则（硬约束）**：
 
-```
-检测到以下 worktree 仓库有未提交改动：
-  - workspace: 5 个文件（workspace-config.json, openspec/changes/foo/...）
-  - ep-foo-app: 12 个文件
-  - ep-bar-app: 3 个文件
-
-请提供 commit 信息：
-  [1] 所有仓库用同一条信息（推荐简单场景）
-  [2] 每仓库分别提供（推荐多仓库改不同东西）
-
-回复示例（统一）：
-  feat(<branch>): 实现客户运费逻辑
-
-回复示例（分别）：
-  workspace: chore(<branch>): 同步 openspec 标准
-  ep-foo-app: feat(<branch>): 实现 saveClientExpectFreight
-  ep-bar-app: refactor(<branch>): 拆分 PlanService
-```
+| 规则 | 要求 |
+|------|------|
+| 长度 | **5–50 字符**（按字符计：1 个中文字 = 1，1 个英文字母 / 空格 / 标点 = 1）；超出范围不得提交 |
+| 风格 | 精炼、最简——一句话说清"改了什么"，不写缘由、不换行、不堆砌 |
+| 依据 | 以 Step 2 dry-run 的实际改动 + `openspec/changes/<branch>/tasks.md` 已完成 task 为准；禁止凭空编造 |
+| 格式 | 沿用 Conventional Commits 前缀（`feat` / `fix` / `refactor` / `chore` / `docs` 等）+ 需求名，如 `feat(<branch>): 实现客户运费逻辑` |
+| 多仓库 | 各仓库改动语义不同时**逐仓库分别生成**（经 `--per-repo`），禁止硬塞同一条 |
 
-**自动建议**（仅作辅助）：agent 可以从 `openspec/changes/<branch>/tasks.md` 已完成的 task 描述生成建议，但**必须**由用户确认或修改后才能传给脚本。
+**展示时机**：生成的每条信息在 Step 2 dry-run 预览中随待提交文件一并输出（透明可见），但**不停顿等待回复**，直接进入 Step 4。
+
+> ⓘ 用户若在对话中显式给出 commit 信息，直接采用（不覆盖用户意图）；未给出时按上述规则自行生成。
 
 ---
 
@@ -162,7 +154,7 @@ node "<skill_dir>/scripts/commit-worktrees.js" "<ws_root>/.worktrees/worktree-<b
 **选项**：
 | 选项 | 说明 |
 |------|------|
-| `--message / -m` | 必填（除非 --per-repo 完全覆盖）。commit 信息 |
+| `--message / -m` | 必填（除非 --per-repo 完全覆盖）。commit 信息（agent 生成，5–50 字符） |
 | `--per-repo "<name>:msg;<name>:msg"` | 覆盖特定仓库的 commit 信息 |
 | `--untracked` | 同时 stage 未追踪文件（默认 `git add -u`，加此项时 `git add -A`） |
 | `--allow-empty` | 允许空提交 |
@@ -224,6 +216,153 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 
 ---
 
+## Step 7：交付选择（MR / 直接合并 / 暂不处理）
+
+Step 5 的 `PUSH_RESULT` 中至少一个仓库为 `pushed` / `skipped`（feature 分支已在远端）时，用 `AskUserQuestion` 提案。**动作与目标解耦**（ADR 0008）：
+
+```
+推送完成。接下来怎么交付？
+  [提 MR]（推荐）   生成预填的合并请求链接，由人工在浏览器合入
+  [直接合并]         由 agent 直接合并到目标分支并推送远端（不经过 MR）
+  [暂不处理]         结束本步，分支已推到远端
+```
+
+### 7.1 目标分支候选（A / B 两出口共用）
+
+`git branch -r` 列出**现场实际存在**的候选（主干 / dev / test / release-* 等），交互式让用户指定（**禁止 AI 代决**）。全仓库统一用一个目标分支；远端不存在该分支的仓库自动跳过。
+
+### 7.2 出口 A · 提 MR
+
+1. 确定目标分支（见 7.1）
+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`（其收尾合并门禁会校验主干合并状态，未合并且非废弃不放行；见 ADR 0007）
+
+### 7.3 出口 B · 直接合并（ADR 0008）
+
+**前置顺序：先归档（仅目标 = 主干）、后提交检查；两步都满足才可合并。**
+
+#### B1 归档前置（仅当目标 = 主干）
+
+目标为主干时**合并前必须已归档**；检查（共享脚本）：
+
+```bash
+node "<skill_dir>/scripts/check-unarchived.js" "<ws_root>" "<branch>"
+```
+
+- 末行 `UNARCHIVED_RESULT` 的 `changes` 为空 → 通过，进 B2
+- 非空 → `AskUserQuestion`：
+
+```
+⚠️ 检测到未归档 change：<名称>
+   合并进主干前必须已归档（/opsx:archive）。
+
+  [去归档]（推荐）  立即执行归档流程；归档产物落盘后自动回到本步
+  [改为提 MR]       转出口 A
+  [中止]            结束本步
+```
+
+选「去归档」→ agent 执行归档流程（`/opsx:archive`，产物落 `openspec/changes/archive/`）→ 进入 B2（归档产物属未提交改动，由 B2 处理）。
+
+> 目标为测试 / 中间分支时**不要求归档**（归档仍在验收通过后执行）；「已提交」检查两类目标都适用。
+
+#### B2 提交检查（通用）
+
+逐仓库 `git status --porcelain`。存在未提交改动（含归档产物）时：
+
+```
+⚠️ 检测到未提交改动：
+  - workspace: 2 个文件
+
+是否提交并推送后再继续合并？
+  [提交并推送]（推荐）  走提交推送流程，完成后自动回到合并
+  [中止]                我先手动处理
+```
+
+- 选「提交并推送」→ 执行本技能 Step 2 → Step 5（dry-run 预览 → 批量 commit → 批量 push）→ **直接回到 B3**（不再重复动作选择，避免递归）
+- 选「中止」→ 结束本步（**前置不满足，不予合并**）
+
+#### B3 目标分支确认
+
+从 7.1 的候选里选定，明确显示主干项：
+
+```
+请选择直接合并的目标分支：
+  [主干 main]         合并进正式主干（跳过测试与验收）
+  [dev] / [test] / …   合并进中间分支（验收后主干仍需另行交付）
+```
+
+#### B4 风险提醒 + 确认（必须显式确认）
+
+目标 = 主干（强提醒）：
+
+```
+⚠️ 你选择直接合并到主干 <main> —— 将跳过：
+   • 测试环境部署与用户验收
+   • 公司正式发布流程
+   • MR 评审记录（平台无评审痕迹）
+
+合并后内容立即进入主干并推送远端，撤回只能靠 revert 补救。
+
+  [确认合并]    我已知晓，执行合并
+  [改为提 MR]   转出口 A
+  [中止]        结束本步
+```
+
+目标 = 测试 / 中间分支（弱提醒）：
+
+```
+⚠️ 你选择直接合并到 <dev> —— 将跳过 MR 评审（平台无记录）；
+   验收通过后主干仍需另行交付。
+
+  [确认合并] / [改为提 MR] / [中止]
+```
+
+#### B5 执行与报告
+
+```bash
+node "<skill_dir>/scripts/merge-branches.js" "<ws_root>" "<branch>" --apps "<app1,app2>" --target "<目标>"
+```
+
+- 缺省 / `--target` 等于探测主干 → 主干快路径（本地主干检出上 `merge --no-ff` → push）
+- `--target` 为非主干分支 → **临时 worktree** 合并（基于 `origin/<目标>`，不动用户检出）
+
+**解读末行 `MERGE_RESULT`**：
+- 退出码 0 → 交付完成
+- `need-mr`（目标分支受保护）→ 报明细并**转出口 A**
+- `failed`（含 `merge-failed` / `push-failed`）→ 报明细，修复后重跑（幂等）
+- `not-on-main`（仅主干路径）→ 空间根检出被其他需求占用（本地模式进行中）：**先收尾该本地需求或改用出口 A 提 MR**；不得用 `--allow-checkout` 抢占（该参数属本地模式收尾，会切走占用者的工作区）
+
+报告形态：
+
+```
+✅ 直接合并完成
+  目标分支：main
+  workspace:            merged（merge --no-ff + push origin/main）
+  jspg-cvat:            merged
+  jspg-cvat-model-factory: skipped（远端无该分支）
+
+  后续：主干已交付 → cbb-worktree-close 收尾将直接放行并自动删分支；
+        中间分支已交付（dev）→ 验收通过后主干仍需另行交付
+```
+
+> **直接合并成功后不删分支**（ADR 0008）：分支与 worktree 保留（验收可能需修复），删除由收尾门禁（`cbb-worktree-close`）统一执行。
+
+---
+
 ## 最终报告
 
 ```
@@ -238,7 +377,7 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
     workspace: ✅ origin/<branch>
     ep-foo-app: ✅ origin/<branch>
     ep-bar-app: ⚠️  远程分支已存在（需用户决策 → 已关联）
-  后续：可继续开发 / 调 /opsx:verify 验证 / 调 /opsx:archive 归档 / 调 `cbb-worktree-close` skill 关闭
+  后续：Step 7 交付选择（提 MR 到测试分支 → 部署验收 → /opsx:archive → 正式发布；或直接合并到主干/测试分支，ADR 0008）→ 最后 cbb-worktree-close
 ```
 
 ---
@@ -249,17 +388,22 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 |------|----------|
 | **任何触发** | **先做 Step 0 场景识别**，再决定策略 |
 | 场景 A：cwd 在 cbb 工作空间根 | find-workspace-root 成功 → 多个 worktree 时让用户选 |
-| 场景 B：cwd 在 worktree 内 | 自动用 cwd 反推分支，扫描后进入询问 commit 信息 |
-| 场景 C：cwd 在普通 git 仓库（无 workspace-config.json） | **降级为单仓库提交推送**，不调用 worktree 脚本 |
+| 场景 B：cwd 在 worktree 内 | 自动用 cwd 反推分支，扫描后 agent 生成 commit 信息 |
+| 场景 C：cwd 在普通 git 仓库（无 CBB-WORKSPACE.json） | **降级为单仓库提交推送**，不调用 worktree 脚本 |
 | 场景 D：cwd 非 git 目录 | 说明情况并终止，不做任何操作 |
-| commit 信息缺失 | 必须询问用户；禁止自动生成（可基于 apply task 上下文给建议） |
-| 多仓库需不同 commit 信息 | 用 `--per-repo "ep-foo:m1;ep-bar:m2"`，必须由用户逐条提供 |
+| commit 信息 | agent 自行生成（5–50 字符，精炼最简），不询问用户；dry-run 预览时一并展示 |
+| 多仓库改动语义不同 | agent 逐仓库分别生成，用 `--per-repo "ep-foo:msg;ep-bar:msg"` |
 | 仓库干净 | commit-worktrees 自动 skipped，只 push 不 commit |
 | 仓库已有 ahead commit | commit-worktrees 自动 skipped（不重复 commit），只 push |
 | 未追踪文件 | 默认不纳入（避免误纳 .idea）；用户明确要求时加 `--untracked` |
 | 远程分支已存在 | push 退出码 2，AI 输出元信息后由用户决策（关联/终止） |
 | push 失败（SSH/HTTPS/网络/保护） | push 退出码 2，AI 按错误码分类处理，阻塞并询问用户 |
 | close-worktree 前调用 | 先调本 skill 把 ahead 推送完，避免 close 时丢提交 |
+| push 完成后 | Step 7 交付选择：提 MR → make-mr-urls.js 生成预填链接 + 开浏览器（不代合并）；直接合并 → B1 归档（仅主干）→ B2 提交检查 → B3 目标 → B4 风险确认 → merge-branches.js 执行；暂不处理 |
+| 直合并前置 | 目标=主干必须先归档（check-unarchived.js）；有未提交改动则询问后走本技能提交推送流程；未确认不合并 |
+| 直合并后 | **不删分支**（ADR 0008），删除归 cbb-worktree-close 收尾门禁 |
+| MR 目标分支 | 交互式：`git branch -r` 列主干候选由用户指定，全仓库统一；缺该分支的仓库自动跳过（no-target） |
+| MR 平台误判 | 非 github.com/gitee.com 默认按 GitLab 拼 URL；有误判用 `--platform gitlab\|github\|gitee` 强制 |
 | --dry-run | 任何时候想预览将要 commit 的内容时使用，不实际修改任何东西 |
 
 ---
@@ -271,10 +415,10 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 - **问题：** 用户在普通仓库说"提交代码"，技能被 description 匹配触发，直接跑 `find-workspace-root.js` 失败并报错终止
 - **修复：** Step 0 先判场景；场景 C（普通 git 仓库）降级为单仓库提交推送，不调用 worktree 脚本、不提及批量流程
 
-### 自动生成 commit 信息不让用户确认
+### commit 信息超长或空洞
 
-- **问题：** agent 拍脑袋写 "feat: xxx"，与用户实际意图不符
-- **修复：** Step 3 必须**直接对话提问**让用户输入或确认
+- **问题：** agent 生成的 commit 信息过长（罗列全部改动、写缘由）或过于笼统（"更新代码"），与"5–50 字符、精炼最简"不符
+- **修复：** Step 3 按规则生成——以实际 diff / 已完成 task 为依据，一句话说清改了什么，长度落在 5–50 字符
 
 ### 误纳未追踪文件
 
@@ -283,18 +427,18 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 
 ### close-worktree 前忘记先 push
 
-- **问题：** 调 close-worktree 时，close-safety-check 检测到 ahead 提交 → 询问用户「先推送 / 接受丢失 / 中止」；用户没意识到要调本 skill
-- **修复：** close-worktree/SKILL.md Step 3.4 决策点已提示「先推送」选项；本 skill 是该选项的执行入口
+- **问题：** 调 close-worktree 时，safety-check 检测到 ahead 提交 → 询问用户「先推送 / 继续 / 中止」；用户没意识到要调本 skill
+- **修复：** close-worktree/SKILL.md Step 3.3 决策点已提示「先推送」选项；本 skill 是该选项的执行入口。走「直合并」出口时，ahead 提交会随合并一并推送到主干
 
 ### apply 完成后不调 push 直接 close
 
-- **问题：** apply 实现完 → 用户关掉 IDE → 调 close-worktree → ahead 提交永久丢失
-- **修复：** 强烈建议 apply 完成后立即调本 skill 推送；或 close-worktree Step 3.4 兜底
+- **问题：** apply 实现完 → 用户关掉 IDE → 调 close-worktree → 收尾合并门禁触发（ADR 0007），未合并且非废弃不放行
+- **修复：** 走门禁三选一：提 MR（先经本 skill 推送 feature）或直合并（ahead 提交随合并推送到主干）
 
-### 多仓库用同一条 commit 信息
+### 多仓库硬塞同一条 commit 信息
 
-- **问题：** workspace 改了 workspace-config.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
-- **修复：** 用 `--per-repo` 模式，让用户逐仓库提供
+- **问题：** workspace 改了 CBB-WORKSPACE.json，ep-foo-app 改了 Java 代码，硬塞同一条 "feat: 实现 XX" 信息不准确
+- **修复：** agent 逐仓库生成各自的 commit 信息，用 `--per-repo` 传入
 
 ### push 失败时跳过失败仓库直接继续
 
@@ -312,23 +456,32 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 
 **绝不允许**
 
-- 自动生成 commit 信息不让用户确认
+- commit 信息超出 5–50 字符范围 / 空洞无意义 / 与改动不符
 - 默认 `git add -A` 误纳未追踪文件
 - push 失败后跳过失败仓库直接继续
 - 远程分支已存在时脚本自动 set-upstream-to
 - AI 询问关联选项前不输出 commit 元信息
 - 运行环境 node 不可用时强行继续 → 改为 fail-fast 提示用户
+- MR 出口下代为合并 / 触碰平台凭据 → MR 出口只生成预填链接，提交与合并由人在平台完成。**直合并只能经 Step 7 出口 B 的 `merge-branches.js` 执行（ADR 0008），且必须先过 B1 归档前置、B2 提交检查、B4 风险确认**
+- 直合并跳过风险提醒直接执行 → 目标为主干时必须强提醒并显式确认；**未经确认不得合并**
+- 目标为主干但未归档就合并 → 必须先归档（B1）
+- 直合并成功后擅自删除分支 → 分支保留，删除归收尾门禁（ADR 0007）
+- MR 目标分支由 AI 猜测代决 → 必须列候选让用户指定
 
 **必须执行**
 
 - 严格按 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 上下文生成建议并由用户确认
+- Step 2 dry-run 必跑，把待提交文件清单与 agent 生成的 commit 信息一并展示给用户
+- Step 3 由 agent 自行生成 commit 信息（5–50 字符、精炼最简），不向用户提问、不等待确认；生成结果在 dry-run 预览中展示
+- commit 信息必须依据实际 diff / 已完成 task 生成，沿用 Conventional Commits 前缀（feature/refactor/fix 等语义）
+- 多个仓库改动语义不同时必须逐仓库分别生成（`--per-repo`），禁止硬塞同一条
 - commit-worktrees / push-worktrees 退出码 2 时必须阻塞流程
 - 远程分支已存在时 AI 必须先输出 commit 元信息再询问
+- push 成功后必须走 Step 7 交付选择（AskUserQuestion 固定选项；用户选"暂不处理"则正常结束）
+- 直合并严格按 B1（归档，仅主干）→ B2（提交检查）→ B3（目标）→ B4（确认）→ B5（执行）顺序；前置不满足不予合并
+- 直合并目标为中间分支时跳过 B1（不要求归档）；两类目标都必须过 B2
 
 ---
 
@@ -340,4 +493,7 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 | `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/`） | （共享模块） | - |
+| `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 |

package/cbb/worktrees/skills/cbb-worktree-push/scripts/check-unarchived.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * 未归档 change 检查（共享脚本，真源：cbb/worktrees/_shared/scripts/）
+ *
+ * 供 cbb-worktree-close（收尾安全评估）与 cbb-worktree-push（Step 7 直合并前置，ADR 0008）调用。
+ *
+ * 用法：node check-unarchived.js <ws_root> [branch]
+ *
+ * 双扫（ADR 0002）：
+ *   - <ws_root>/openspec/changes/                       → 空间根当前检出（本地模式产物 / 空间根遗留）
+ *   - <ws_root>/.worktrees/worktree-<branch>/openspec/changes/ → worktree 模式产物
+ *     （branch 未传时跳过 worktree 扫描，保持旧调用兼容）
+ *
+ * 输出：changes 为两处合集（去重）；detail 标注每个 change 的来源
+ *       （'root' / 'worktree'，同名两处共存时为 'both'）。
+ * 本检查为信息收集性质，不阻断流程。
+ *
+ * 退出码：
+ *   0 - 检查完成（无论是否有未归档 change）
+ *   1 - 参数错误
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const wsRoot = process.argv[2];
+const branch = process.argv[3];
+
+if (!wsRoot) {
+  console.error('Usage: node check-unarchived.js <ws_root> [branch]');
+  process.exit(1);
+}
+
+/**
+ * 扫描单个 changes 目录，返回未归档 change 名数组（目录不存在返回 []）。
+ */
+function scanDir(changesDir) {
+  if (!fs.existsSync(changesDir)) return [];
+  let entries;
+  try {
+    entries = fs.readdirSync(changesDir, { withFileTypes: true });
+  } catch (e) {
+    console.error('Failed to read ' + changesDir + ':', e.message);
+    return [];
+  }
+  return entries
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+    .map(e => e.name);
+}
+
+const rootChanges = scanDir(path.join(wsRoot, 'openspec', 'changes'));
+
+const worktreeDir = branch
+  ? path.join(wsRoot, '.worktrees', 'worktree-' + branch, 'openspec', 'changes')
+  : null;
+const wtChanges = worktreeDir ? scanDir(worktreeDir) : [];
+
+const detail = {};
+for (const name of rootChanges) detail[name] = 'root';
+for (const name of wtChanges) {
+  detail[name] = detail[name] === 'root' ? 'both' : 'worktree';
+}
+
+const changes = Object.keys(detail).sort();
+
+if (rootChanges.length === 0 && wtChanges.length === 0) {
+  console.log('ℹ️  未发现未归档 change（根与 worktree' + (worktreeDir ? '' : '（未指定 branch，跳过）') + '均无）');
+} else {
+  console.log('ℹ️  未归档 change：' + (changes.join(', ') || '无'));
+  for (const name of changes) {
+    console.log('    - ' + name + '（来源：' + detail[name] + '）');
+  }
+}
+
+console.log('UNARCHIVED_RESULT', JSON.stringify({ changes, detail }));
+process.exit(0);