@jspg-ai/coding-bb 0.0.3-beta.12 → 0.0.3-beta.14

package/cbb/dev-standards/rules/cbb-ai-behavior.md

@@ -101,18 +101,28 @@ trigger: always_on
 
 ## 8. 业务空间目录纪律
 
-**仅当工作目录是业务空间根（存在 `workspace-config.json`）时生效：写操作命令必须落在需求工作树内。**
+**仅当工作目录是业务空间根（存在 `workspace-config.json`）时生效。空间根支持两种开发模式，接到需求先判定本次属于哪种，再动手。**
 
-业务空间根（主分支）只负责组织与调度，不做需求开发。接到需求先建工作树（`cbb-worktree-init` skill，或斜杠命令 `/cbb-worktree-init`），之后：
+**模式一 · worktree 模式（默认；凡涉及应用代码改动必走此路）：**
+
+接到需求先建工作树（`cbb-worktree-init` skill，或斜杠命令 `/cbb-worktree-init`），之后：
 
 - 一切产生写操作的命令（git commit / openspec / 构建 / 测试 / 文件修改）必须以 `.worktrees/worktree-<需求名>/`（或其应用子目录）为工作目录：显式 `cd` 或绝对路径
-- 禁止在空间根执行写操作：不在主分支提交代码、不在空间根创建 openspec 变更产物、不改 `.codespace/` 基准代码
-- 只读命令（git status / log、查看文件）在空间根执行无妨
+- 不在空间根主分支提交应用代码、不在空间根创建本模式的 openspec 变更产物
 - 会话开始时确认本次需求对应的工作树路径；存在多个未完成工作树时，先与用户确认目标，不要猜
 
-**会话与工作目录是两回事：** AI 会话窗口始终停在**空间根**（worktree 内不装 AI 配置，无工作流命令），`/opsx:*` 等命令仍在空间根会话发起；只是**产生写操作的工作目录**指向需求工作树（显式 `cd` 或绝对路径）。不要把会话切到 worktree 内，也不要因「在 worktree 内开发」就在空间根直接动手。
+**模式二 · 轻量模式（仅限空间根仓库自身内容：openspec 产物、docs、空间配置）：**
+
+需求完全不触碰任何应用代码文件时，可直接在空间根开发：变更产物落空间根 `openspec/`，走完整 opsx 流程后提交 main 分支，**提交后即 push——main 就是交付线，无 worktree、无 MR，不得悬空本地提交**。
+
+**两模式共同红线（无例外）：**
+
+- `.codespace/` 是工具维护的基准代码，不是开发区——任何模式下都不许在其中改应用代码
+- 只读命令（git status / log、查看文件）在空间根执行无妨
+
+**会话与工作目录是两回事：** AI 会话窗口始终停在**空间根**（worktree 内不装 AI 配置，无工作流命令），`/opsx:*` 等命令仍在空间根会话发起；worktree 模式下**产生写操作的工作目录**指向需求工作树（显式 `cd` 或绝对路径）。不要把会话切到 worktree 内。
 
-**检验标准：** 空间根主分支的 `git status` 永远干净（除工具维护的配置文件外），openspec 变更产物只出现在需求工作树内。
+**检验标准：** worktree 模式的变更产物只出现在需求工作树内；空间根 main 的 `git status` 干净（除工具维护的配置文件外），且轻量模式产生的 main 提交都已 push（本地 main 不长期领先 origin/main）。
 
 ---
 

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

@@ -1,9 +1,9 @@
 ---
 name: cbb-worktree-push
-description: "提交并推送当前需求的所有关联仓库（跨 worktree 批量）。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-worktree 前需要先推送未提交改动。注意：本技能会先识别场景——不在 cbb 工作空间时降级为普通单仓库提交推送。"
+description: "提交并推送当前需求的所有关联仓库（跨 worktree 批量），推送后提案生成 MR（合并请求）预填链接。触发：用户说'提交'/'commit'/'push'/'推送'/'提交并push'/'推到远端'/'提MR'/'提合并请求'/'merge request'；用户在 .worktrees/worktree-<需求名>/ 下工作要求批量推送；apply 完成后准备推送所有 worktree；close-worktree 前需要先推送未提交改动。注意：本技能会先识别场景——不在 cbb 工作空间时降级为普通单仓库提交推送。"
 ---
 
-# Push Worktrees（跨平台脚本化版本 v1.0）
+# Push Worktrees（跨平台脚本化版本 v1.1）
 
 提交并推送当前需求的所有关联仓库（跨 worktree 批量）。专门解决"开发完成后批量推送"和"用户口语化提交并push"两类场景，弥补 [cbb-worktree-init Step 3.4](file:///d:/workspace/va-ai/coding-bb/cbb/worktrees/skills/cbb-worktree-init/SKILL.md) 仅推送初始空 commit 的缺口。
 
@@ -15,6 +15,7 @@ description: "提交并推送当前需求的所有关联仓库（跨 worktree
 
 - 本技能的所有原子操作封装为 `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` 对称）：
@@ -224,6 +225,39 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 
 ---
 
+## 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`
+
+---
+
 ## 最终报告
 
 ```
@@ -238,7 +272,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 → 正式发布（公司流程）→ cbb-worktree-close
 ```
 
 ---
@@ -260,6 +294,9 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 | 远程分支已存在 | 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 的内容时使用，不实际修改任何东西 |
 
 ---
@@ -318,6 +355,8 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 - 远程分支已存在时脚本自动 set-upstream-to
 - AI 询问关联选项前不输出 commit 元信息
 - 运行环境 node 不可用时强行继续 → 改为 fail-fast 提示用户
+- 代为合并 MR / 直接向测试、正式分支 push / 触碰平台凭据 → MR 只生成预填链接，提交与合并由人在平台完成
+- MR 目标分支由 AI 猜测代决 → 必须列候选让用户指定
 
 **必须执行**
 
@@ -329,6 +368,7 @@ node "<skill_dir>/scripts/push-worktrees.js" "<ws_root>/.worktrees/worktree-<bra
 - commit 信息涉及业务语义时（feature/refactor/fix 等）必须从 apply task 上下文生成建议并由用户确认
 - commit-worktrees / push-worktrees 退出码 2 时必须阻塞流程
 - 远程分支已存在时 AI 必须先输出 commit 元信息再询问
+- push 成功后必须走 Step 7 MR 提案（AskUserQuestion 固定选项；用户选"暂不提"则正常结束）
 
 ---
 
@@ -340,4 +380,5 @@ 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/`） | （共享模块） | - |

package/cbb/worktrees/skills/cbb-worktree-push/scripts/make-mr-urls.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+require('./silence-popup');
+/**
+ * cbb-worktree-push MR 链接生成（预填 URL + 可选开浏览器）
+ *
+ * 用法：
+ *   node make-mr-urls.js <ws_root> <branch> <target> [--platform gitlab|github|gitee] [--open]
+ *   node make-mr-urls.js <wt_path> <target> [...]   # wt_path 形态同 push-worktrees
+ *
+ * 行为（对 workspace worktree + 各 app worktree 逐仓库）：
+ *   1. git ls-remote 校验 feature 分支已在远端（push 过）、目标分支存在
+ *   2. git rev-list 判断与目标分支有无差异（无差异 → no-diff 跳过）
+ *   3. 解析 origin URL 判定平台（github.com / gitee.com，其余默认 GitLab；--platform 强制）
+ *   4. 生成预填 MR/PR 创建 URL；--open 时逐个开浏览器
+ *
+ * 安全红线：只生成链接，绝不代为合并、不触碰任何凭据（提交动作由人在平台页面完成）
+ *
+ * 退出码：
+ *   0 - 正常（含全部跳过）
+ *   1 - 参数错误
+ *   2 - 致命（worktree 不存在 / 无仓库）
+ *
+ * 末行 MR_RESULT [{name,status,url|reason}]
+ *   status: ok | no-diff | not-pushed | no-target | manual | no-remote
+ */
+
+const { execSync, spawn } = require('child_process');
+const path = require('path');
+const { scanWorktreeRepos } = require('./push-worktrees');
+
+function parseArgs(argv) {
+  const flags = {};
+  const pos = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--open') flags.open = true;
+    else if (a === '--platform') { flags.platform = argv[++i]; }
+    else if (a.startsWith('--platform=')) { flags.platform = a.split('=')[1]; }
+    else pos.push(a);
+  }
+  let inputs;
+  if (pos.length === 2) {
+    const wtPath = path.resolve(pos[0]);
+    const m = wtPath.match(/^(.+)[\\\/]\.worktrees[\\\/]worktree-(.+)$/);
+    if (!m) return { error: '两参数形式时 argv[1] 必须是 <ws_root>/.worktrees/worktree-<branch> 形态' };
+    inputs = { wsRoot: m[1], branch: m[2], target: pos[1] };
+  } else if (pos.length === 3) {
+    inputs = { wsRoot: path.resolve(pos[0]), branch: pos[1], target: pos[2] };
+  } else {
+    return { error: '用法：node make-mr-urls.js <ws_root> <branch> <target> [--platform X] [--open] | node make-mr-urls.js <wt_path> <target> [--open]' };
+  }
+  if (flags.platform && !['gitlab', 'github', 'gitee'].includes(flags.platform)) {
+    return { error: '--platform 仅支持 gitlab / github / gitee' };
+  }
+  return { ...inputs, ...flags };
+}
+
+/** 解析 git remote URL → { webBase }（浏览器可点的仓库主页，无 .git 后缀） */
+function parseRemoteUrl(url) {
+  const u = (url || '').trim().replace(/\.git$/, '');
+  if (!u) return null;
+  // scp 式 ssh：git@host:group/proj
+  let m = u.match(/^[^@/\s]+@([^:]+):(.+)$/);
+  if (m) return { host: m[1], repoPath: m[2], webBase: 'https://' + m[1] + '/' + m[2] };
+  // 显式 ssh:// 或 http(s)://
+  m = u.match(/^(ssh|https?):\/\/(?:[^@/\s]+@)?([^/]+)\/(.+)$/);
+  if (m) {
+    const scheme = m[1] === 'ssh' ? 'https' : m[1];
+    return { host: m[2], repoPath: m[3], webBase: scheme + '://' + m[2] + '/' + m[3] };
+  }
+  return null;
+}
+
+function detectPlatform(remoteUrlStr, override) {
+  if (override) return override;
+  const parsed = parseRemoteUrl(remoteUrlStr);
+  if (!parsed) return null;
+  const host = parsed.host.toLowerCase();
+  if (host === 'github.com' || host.endsWith('.github.com')) return 'github';
+  if (host === 'gitee.com') return 'gitee';
+  // 企业自建以 GitLab 为绝对主流；误判时 --platform 强制覆盖
+  return 'gitlab';
+}
+
+/** 生成预填 MR/PR 创建 URL（branch/target 做 URL 编码） */
+function buildMrUrl(platform, webBase, branch, target) {
+  const b = encodeURIComponent(branch);
+  const t = encodeURIComponent(target);
+  if (platform === 'gitlab') {
+    return webBase + '/-/merge_requests/new?merge_request%5Bsource_branch%5D=' + b + '&merge_request%5Btarget_branch%5D=' + t;
+  }
+  if (platform === 'github') {
+    return webBase + '/compare/' + t + '...' + b + '?expand=1';
+  }
+  if (platform === 'gitee') {
+    return webBase + '/compare/' + t + '...' + b;
+  }
+  return null;
+}
+
+function defaultRun(cmd, cwd) {
+  try {
+    return { ok: true, out: execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] }).trim() };
+  } catch (e) {
+    return { ok: false, err: (e.stderr || e.message || String(e)).trim() };
+  }
+}
+
+/**
+ * 单仓库判定：ls-remote 拿 source/target 的远端 sha → rev-list 数差异
+ * @returns {{status:'ok'|'no-diff'|'not-pushed'|'no-target'|'no-remote', remote?:string}}
+ */
+function inspectRepo(repoDir, branch, target, execImpl) {
+  const run = execImpl || defaultRun;
+  const remote = run('git remote get-url origin', repoDir);
+  if (!remote.ok) return { status: 'no-remote' };
+  const ls = run('git ls-remote --heads origin "' + branch + '" "' + target + '"', repoDir);
+  if (!ls.ok) return { status: 'no-remote' };
+  const refs = {};
+  ls.out.split('\n').forEach(line => {
+    const m = line.match(/^([0-9a-f]+)\s+refs\/heads\/(.+)$/);
+    if (m) refs[m[2]] = m[1];
+  });
+  if (!refs[branch]) return { status: 'not-pushed', remote: remote.out };
+  if (!refs[target]) return { status: 'no-target', remote: remote.out };
+  const ahead = run('git rev-list --count "' + refs[target] + '..' + refs[branch] + '"', repoDir);
+  if (ahead.ok && ahead.out === '0') return { status: 'no-diff', remote: remote.out };
+  // rev-list 失败（目标 sha 本地不可达等）→ 不阻塞，照常给链接
+  return { status: 'ok', remote: remote.out };
+}
+
+function openBrowser(url, platform) {
+  const os = process.platform;
+  try {
+    if (os === 'win32') spawn('cmd', ['/c', 'start', '""', url], { stdio: 'ignore', detached: true }).unref();
+    else if (os === 'darwin') spawn('open', [url], { stdio: 'ignore', detached: true }).unref();
+    else spawn('xdg-open', [url], { stdio: 'ignore', detached: true }).unref();
+  } catch (e) { /* 打不开不阻塞：URL 清单已输出 */ }
+}
+
+/**
+ * 编排：扫描 worktree 仓库 + 逐仓库判定与生成
+ * @param {{wsRoot:string, branch:string, target:string, platform?:string, execImpl?:Function}} opts
+ */
+function makeMrUrls(opts) {
+  const { wtRoot, repos, error } = scanWorktreeRepos(opts.wsRoot, opts.branch);
+  if (error) return { repos: [], results: [], error };
+  const results = [];
+  for (const r of repos) {
+    const info = inspectRepo(r.wt, opts.branch, opts.target, opts.execImpl);
+    const item = { name: r.name, status: info.status };
+    if (info.status === 'ok') {
+      const platform = detectPlatform(info.remote, opts.platform);
+      const web = parseRemoteUrl(info.remote);
+      const url = platform && web ? buildMrUrl(platform, web.webBase, opts.branch, opts.target) : null;
+      if (url) { item.url = url; item.platform = platform; }
+      else { item.status = 'manual'; item.reason = 'origin 无法解析为已知平台仓库地址'; }
+    } else {
+      item.reason = {
+        'no-diff': '与目标分支无差异，无需 MR',
+        'not-pushed': 'feature 分支未推送到远端（先完成 push）',
+        'no-target': '远端不存在目标分支',
+        'no-remote': '仓库无 origin 远端',
+      }[info.status];
+    }
+    results.push(item);
+  }
+  return { wtRoot, repos, results, error: null };
+}
+
+module.exports = { parseArgs, parseRemoteUrl, detectPlatform, buildMrUrl, inspectRepo, makeMrUrls };
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.error) {
+    console.error('❌ ' + args.error);
+    process.exit(1);
+  }
+  const { wsRoot, branch, target } = args;
+  console.log('=== 生成 MR 预填链接 ===');
+  console.log('需求分支：' + branch + ' → 目标分支：' + target);
+
+  const { results, error } = makeMrUrls({ wsRoot, branch, target, platform: args.platform });
+  if (error) {
+    console.error('❌ ' + error);
+    process.exit(2);
+  }
+  if (results.length === 0) {
+    console.error('❌ worktree 下未发现任何 git 仓库');
+    process.exit(2);
+  }
+
+  let opened = 0;
+  for (const r of results) {
+    if (r.status === 'ok') {
+      console.log('✅ ' + r.name + ' [' + r.platform + ']: ' + r.url);
+      if (args.open) { openBrowser(r.url); opened++; }
+    } else {
+      console.log('⏭️  ' + r.name + ': ' + r.reason + '（' + r.status + '）');
+    }
+  }
+  if (args.open && opened > 0) console.log('🌐 已在浏览器打开 ' + opened + ' 个 MR 创建页（人工确认标题/评审人后提交）');
+
+  console.log('---');
+  console.log('MR_RESULT', JSON.stringify(results));
+  process.exit(0);
+}
+
+if (require.main === module) {
+  main();
+}

package/config/openspec/schemas/spec-driven/schema.yaml

@@ -227,7 +227,7 @@ apply:
     **收尾（全部任务翻成 `- [x]` 后执行；本段为项目级硬约束，覆盖官方 apply 模板自带的完成提示语）：**
 
     1. **未决项自检**（逐项确认，任何一项未过都不得宣布完成）：
-       - change 产物（proposal.md / design.md / specs/** / tasks.md / plan.md）已提交到需求分支；未提交时先询问用户是否现在提交（可随 cbb-worktree-push 一并推送）
+       - change 产物（proposal.md / design.md / specs/** / tasks.md / plan.md）已提交到需求分支（轻量模式：空间根 main 分支）；未提交时先询问用户是否现在提交（可随 cbb-worktree-push 一并推送；轻量模式提交后即 push）
        - 本会话产生的临时文件与环境改动（备份目录、未回写远端的本地提交、cherry-pick 等）已列清并交用户决策
     2. **输出顺序纪律**：存在未决项时，本轮只列未决项并等待用户决策；**禁止同轮输出"下一步建议"**，禁止出现"规划与实施均已完成""可运行 archive"之类表述（产物未提交时归档会丢规划产物）
     3. **全部未决项关闭后，唯一可建议的下一步是 `/opsx:verify`**：本项目工作流为 propose → apply → verify → archive，verify（强制 code-review + 产出 cr.md）是 archive 的前置阶段；**禁止直接建议 archive**，官方模板的 "You can archive this change" 提示语以本段为准
@@ -244,3 +244,14 @@ verify:
        即便 AI 自认能 review,仍必须调 skill。
     2. **MANDATORY 产出 `cr.md`**:把完整 Verification Report 写到 `openspec/changes/<name>/cr.md`,
        缺则视为 verify 未完成。报告必须包含五段:Summary / CRITICAL / WARNING / SUGGESTION / Code Review。
+
+    **收尾（cr.md 产出且无 CRITICAL 遗留后执行；本段为项目级硬约束，覆盖官方 verify 模板自带的完成提示语）：**
+
+    verify 通过后，用 AskUserQuestion（固定选项）向用户提供两条路径并等待选择，禁止替用户决定、禁止单一路径直接建议归档：
+
+    - **路径 A · 先验收后归档（推荐）**：执行 `cbb-worktree-push` 推送 feature 分支并提 MR 到测试分支 → 测试环境部署、用户验收 → 验收要改则在 worktree 内修复后再次 push（小改动无需重跑 verify）→ 验收通过后才 `/opsx:archive`
+    - **路径 B · 先归档后推送**：立即 `/opsx:archive` 落定变更产物（归档移动与 spec 同步发生在 feature 分支上）→ 再执行 `cbb-worktree-push` 一并推送 → 提 MR 到测试分支验收。注意：验收若发现问题，产物已归档，修复需走新 change 或将归档移回后继续；适合改动小、验收把握大的场景
+
+    用户选定后按该路径执行；官方模板的单一 "suggest archive" 提示语以本段为准。
+
+    **轻量模式变体**（本次 change 完全不涉及应用代码，产物在空间根仓库）：无 worktree push / 测试分支 MR 环节，两条路径替换为——A（推荐）"先 push main 交付、观察无回归后再 archive" / B"立即 archive 落定产物，再 push main"；main 提交不得悬空本地。

package/config/workspace-agents.sample.md

@@ -5,12 +5,12 @@
 
 ## 核心约定
 
-1. **本目录不做需求开发**。本目录（业务空间主分支）只负责组织与调度；需求开发的**写操作**都在 `.worktrees/worktree-<需求名>/` 隔离目录内进行，**AI 会话仍停在空间根**（worktree 内不装 AI 配置）。
+1. **双模式开发**：涉及**应用代码**的需求在 `.worktrees/worktree-<需求名>/` 隔离目录内进行（worktree 模式，默认）；完全不触碰应用代码的需求（openspec 产物、docs、空间配置）可直接在空间根开发（轻量模式，提交 main 后即 push）。**AI 会话始终停在空间根**（worktree 内不装 AI 配置）。
 2. **AI 配置安装在空间根**：编码规范、OpenSpec 命令、worktree 管理技能都装在本目录（`cbb setup` / `cbb update` 安装）；worktree 内**不安装** AI 配置，AI 会话始终以空间根为基础。
-3. **接到新需求先建 worktree**：使用 `/cbb-worktree-init <需求名>`（skill 形态，各工具写法见文末），或直接自然语言说"为 <需求名> 创建工作空间"。它会为 `workspace-config.json` 中的全量关联应用同步创建同名 worktree。
-4. **开发命令在本会话执行，写操作指向 worktree**：需求提案 / 实现 / 验证 / 归档（`/opsx:propose` → `/opsx:apply` → `/opsx:verify` → `/opsx:archive`）在空间根会话执行；但所有产生写操作的命令（git commit / openspec / 构建 / 测试 / 文件修改）必须以 `.worktrees/worktree-<需求名>/`（或其应用子目录）为工作目录（显式 `cd` 或绝对路径）；**禁止在空间根（主分支）执行写操作**。
+3. **涉及应用代码的新需求先建 worktree**：使用 `/cbb-worktree-init <需求名>`（skill 形态，各工具写法见文末），或直接自然语言说"为 <需求名> 创建工作空间"。它会为 `workspace-config.json` 中的全量关联应用同步创建同名 worktree。
+4. **开发命令在本会话执行，写操作按模式定落点**：需求提案 / 实现 / 验证 / 归档（`/opsx:propose` → `/opsx:apply` → `/opsx:verify` → `/opsx:archive`）在空间根会话执行；worktree 模式下所有产生写操作的命令（git commit / openspec / 构建 / 测试 / 文件修改）必须以 `.worktrees/worktree-<需求名>/`（或其应用子目录）为工作目录（显式 `cd` 或绝对路径），**不得往主分支提交应用代码**；轻量模式在空间根直接写、提交 main 后即 push。
 5. **关联应用增减只改配置**：编辑 `workspace-config.json` 的 `apps` 数组（`name` / `repo` / `side` / `desc`），然后用同一需求名重跑 worktree 初始化即幂等补齐；不要手工 `git clone` 应用仓库。
-6. **不要绕过 worktree 直接修改 `.codespace/` 或本目录的代码**。`.codespace/` 是工具维护的基准代码，不是开发区。
+6. **不要绕过 worktree 直接修改 `.codespace/`**。`.codespace/` 是工具维护的基准代码，不是开发区；应用代码改动任何模式都必须走 worktree。
 
 ## 目录结构与职责
 
@@ -19,7 +19,7 @@
 | `workspace-config.json` | 关联应用清单，所有应用联动的唯一数据源 | 人工编辑 |
 | `.codespace/` | 各关联应用的基准代码（每个应用一个子目录） | `cbb setup` 与 worktree 流程自动 clone / fetch；**勿手动编辑**；已 gitignore，不提交 |
 | `.worktrees/` | 需求隔离开发区（每个需求一个 `worktree-<需求名>/` 目录） | worktree 命令自动创建 / 清理；不提交（首次执行 worktree 流程时自动加入 .gitignore） |
-| `openspec/` | OpenSpec 工作流配置（`config.yaml` + `schemas/`） | 由 cbb 安装；需求变更产物（`openspec/changes/` 等）在**需求工作树内**生成，随需求分支提交 |
+| `openspec/` | OpenSpec 工作流配置（`config.yaml` + `schemas/`） | 由 cbb 安装；变更产物（`openspec/changes/` 等）worktree 模式在**需求工作树内**生成随需求分支提交，轻量模式直接在空间根生成提交 main |
 | `.claude/` `.qoder/` `.opencode/` `.codebuddy/` `.trae/` | AI 工具适配目录：编码规范规则、OpenSpec 命令、worktree 管理技能（skill 形态） | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
 | `.cbb/` | cbb 安装清单与状态（`.managed-by-cbb`、`.last-tools`） | 由 cbb 管理；**勿手动编辑** |
 
@@ -28,10 +28,14 @@
 ```
 本目录：对 AI 说"为 <需求名> 创建工作空间"（或 /cbb-worktree-init <需求名>）
   → 继续在当前会话开发：写操作命令以 .worktrees/worktree-<需求名>/ 为工作目录
-    （/opsx:propose → /opsx:apply → /opsx:verify → /opsx:archive）
-  → 说"提交并推送"（或 /cbb-worktree-push）→ 合并后说"关闭工作空间"（或 /cbb-worktree-close）
+    （/opsx:propose → /opsx:apply → /opsx:verify）
+  → 说"提交并推送"（或 /cbb-worktree-push）→ 结尾会提案生成 MR 预填链接（提往测试分支）
+  → 测试环境验收通过 → /opsx:archive → 正式合并走公司流程
+  → 全链路完成后说"关闭工作空间"（或 /cbb-worktree-close）
 ```
 
+> 轻量模式（需求完全不涉及应用代码）跳过上述流程：空间根直接 `/opsx:*` 全程 → 提交 main → 立即 push。
+
 > worktree 管理三件套（init / close / push）以 **skill 形态**分发：既能被 AI 在对话中按意图**自动触发**，也能用斜杠命令手动指定（`/cbb-worktree-init` 等，各工具一致）。OpenSpec 命令为 `/opsx:propose`（opencode 扁平化为 `/opsx-propose`）。
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.12",
+  "version": "0.0.3-beta.14",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {
@@ -19,7 +19,7 @@
   "scripts": {
     "sync:shared": "node scripts/sync-shared.js",
     "pretest": "node scripts/sync-shared.js --check",
-    "test": "node test/lib/install/cleanup.test.js && node test/lib/utils/settings.test.js && node test/lib/utils/gitignore.test.js && node test/lib/utils/version.test.js && node test/lib/install/workspaces.test.js && node test/lib/utils/checkbox.test.js && node test/lib/utils/output.test.js && node test/lib/install/cli-help.test.js && node test/lib/install/adapters.test.js && node test/lib/wiki/wiki-publish.test.js && node test/lib/wiki/wiki-parse-args.test.js && node test/lib/wiki/wiki-split.test.js && node test/lib/superpowers/superpowers.test.js && node test/worktrees/push-branches.test.js && node test/worktrees/commit-worktrees.test.js && node test/worktrees/push-worktrees.test.js && node test/worktrees/check-env-deep.test.js && node test/worktrees/create-worktrees.test.js && node test/lib/openspec/protected-paths.test.js"
+    "test": "node test/lib/install/cleanup.test.js && node test/lib/utils/settings.test.js && node test/lib/utils/gitignore.test.js && node test/lib/utils/version.test.js && node test/lib/install/workspaces.test.js && node test/lib/utils/checkbox.test.js && node test/lib/utils/output.test.js && node test/lib/install/cli-help.test.js && node test/lib/install/adapters.test.js && node test/lib/wiki/wiki-publish.test.js && node test/lib/wiki/wiki-parse-args.test.js && node test/lib/wiki/wiki-split.test.js && node test/lib/superpowers/superpowers.test.js && node test/worktrees/push-branches.test.js && node test/worktrees/commit-worktrees.test.js && node test/worktrees/push-worktrees.test.js && node test/worktrees/check-env-deep.test.js && node test/worktrees/create-worktrees.test.js && node test/worktrees/make-mr-urls.test.js && node test/lib/openspec/protected-paths.test.js"
   },
   "keywords": [
     "cbb",