@jspg-ai/coding-bb 0.0.3-beta.34 → 0.0.3-beta.36

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

@@ -99,39 +99,6 @@ trigger: always_on
 
 **检验标准：** 用户从未因"AI 直接改了代码没打招呼"而感到意外。
 
-## 8. 业务空间开发模式（双模式，用户选择制）
-
-**仅当工作目录是业务空间根（存在 `CBB-WORKSPACE.json` 且 `.git` 为目录）时生效。空间支持两种开发模式，能力对称（都能修改 workspace 内容与应用代码、都强制分支隔离、交付均有 MR 与直合并两条通道，ADR 0007/0008），由用户显式选择，agent 只给推荐不代决。**
-
-**模式一 · 本地模式（单线程快改，当前会话就地干）：**
-
-- 就地切分支：根 + 各涉及应用 `.codespace/<app>/` 同名 `checkout -b`（基线 = `origin/<main>`，经 `cbb-local-mode` 技能执行）
-- 当前会话原地开发，相对路径原样生效；**一次只承载一个需求**（独占本地检出；期间并行新需求走 worktree 模式，互不干扰）
-- 收尾（收尾合并门禁，ADR 0007）：`merge-branches.js --check` 判定已合并；未合并须三选一（提 MR / 直合并 `--allow-checkout` / 确认废弃）后方可收尾；各参与仓库 `checkout main && pull && 删分支`
-
-**模式二 · worktree 模式（并行 / 隔离）：**
-
-- `cbb-worktree-init` 建隔离 worktree（AI 配置内容子目录已 junction 就位），**开发会话开进 `.worktrees/worktree-<需求名>/`**，可多需求并行；app 检出收拢在 `<wt>/.codespace/<app>/`——**镜像空间根布局**（`.codespace/<app>/...` 相对路径两模式通用，ADR 0003）
-- 根会话保留作控制面（worktree 生灭、`cbb update` 等空间级操作）；**会话形态按工具定，能自动则 agent 亲自做**：OpenCode 桌面端 = agent 自动把会话切进/切出 worktree（`session_move`，上下文保留、不列入用户待办，空间根路径在案供回切）；无会话搬移能力的桌面端 = 用户手动切根；CLI/TUI = 新开会话进 worktree
-
-**基准与防线（两模式共同，ADR 0002）：**
-
-- **基准 = `origin/main`（唯一真相源）；`.codespace/<app>/` 的检出 = 视图**——本地模式可暂态被需求分支占用，收尾恢复
-- **严禁直接在任何 main 检出上提交载荷**：分支感知 pre-commit hook 机械拦截（workspace 仓库仅放行控制面白名单：`CBB-WORKSPACE.json` / `.gitignore` / `AGENTS.md` / `openspec/config.yaml` / `openspec/schemas/**`；应用仓库 main 全拦；**merge 提交（`MERGE_HEAD` 存在）放行**，见 ADR 0007）——**被拦是防线生效，不是故障**；`--no-verify` 绕过仅限用户显式要求
-- 需求分支推送唯一出口 = `cbb-worktree-push`（init 创建流程零远端操作，lazy push）；推送后可选提 MR 或**直接合并**（`merge-branches.js`，主干 / 测试分支，ADR 0008）；收尾合并门禁同源（ADR 0007）
-- **收尾合并门禁（ADR 0007）**：两模式收尾均须每仓库"已合并"（`safety-check` / `merge-branches.js --check` 判定）；未合并三选一——提 MR / 直合并 / 确认废弃（远程重命名 `<分支>-deprecated`）；交付完成自动删本地+远程分支
-- **模式误判零代价**：本地模式中途要并行/隔离 → 重跑 `cbb-worktree-init`（分支已存在自动复用，提交随身带走）
-
-**三时刻对齐（agent 必须遵守）：**
-
-1. **开工前——状态自检**（`cbb-local-mode` 的 `check-local-state.js`）：干净态零交互直接开工；**遗留态（别的需求未收尾，任一仓库检出在非主干分支）必须让用户四选一**（继续 / 先收尾 / 升级 worktree / 丢弃），不得自行决定
-2. **开工时——布局确认**：向用户展示参与仓库与分支名，确认后执行
-3. **进行中——插单归属**：用户插入非本需求的改动，先确认归属（并入 / 收尾后处理 / 转 worktree），不得静默混入
-
-**读基准代码约定：** 本地模式进行中，工作区是开发态而非基准——要读"main 现状"先确认检出分支，或直接 `git show main:<path>` / `git diff main`；不要默认工作区即基准。
-
-**检验标准：** 任何 main 检出上无载荷提交（hook 兜底，git log 可机械审计；merge 提交除外）；本地模式收尾后全部仓库回主干且 clean；worktree 模式的变更产物只出现在需求工作树内；需求分支只经 push 技能产生；**未合并且非废弃的分支无法通过收尾（门禁兜底）**。
-
 ---
 
 **这些准则生效的标志：** diff 中不必要的改动减少、不会因过度设计而重写、澄清问题在实现前而非出错后提出。

package/cbb/dev-standards/rules/cbb-workspace-discipline.md

@@ -0,0 +1,36 @@
+---
+trigger: always_on
+---
+
+# 业务空间开发纪律（双模式，用户选择制）
+
+**仅当工作目录是业务空间根（存在 `CBB-WORKSPACE.json` 且 `.git` 为目录）时生效。空间支持两种开发模式，能力对称（都能修改 workspace 内容与应用代码、都强制分支隔离、交付均有 MR 与直合并两条通道，ADR 0007/0008），由用户显式选择，agent 只给推荐不代决。**
+
+**模式一 · 本地模式（单线程快改，当前会话就地干）：**
+
+- 就地切分支：根 + 各涉及应用 `.codespace/<app>/` 同名 `checkout -b`（基线 = `origin/<main>`，经 `cbb-local-mode` 技能执行）
+- 当前会话原地开发，相对路径原样生效；**一次只承载一个需求**（独占本地检出；期间并行新需求走 worktree 模式，互不干扰）
+- 收尾（收尾合并门禁，ADR 0007）：`merge-branches.js --check` 判定已合并；未合并须三选一（提 MR / 直合并 `--allow-checkout` / 确认废弃）后方可收尾；各参与仓库 `checkout main && pull && 删分支`
+
+**模式二 · worktree 模式（并行 / 隔离）：**
+
+- `cbb-worktree-init` 建隔离 worktree（AI 配置内容子目录已 junction 就位），**开发会话开进 `.worktrees/worktree-<需求名>/`**，可多需求并行；app 检出收拢在 `<wt>/.codespace/<app>/`——**镜像空间根布局**（`.codespace/<app>/...` 相对路径两模式通用，ADR 0003）
+- 根会话保留作控制面（worktree 生灭、`cbb update` 等空间级操作）；**会话形态按工具定，能自动则 agent 亲自做**：OpenCode 桌面端 = agent 自动把会话切进/切出 worktree（`session_move`，上下文保留、不列入用户待办，空间根路径在案供回切）；无会话搬移能力的桌面端 = 用户手动切根；CLI/TUI = 新开会话进 worktree
+
+**基准与防线（两模式共同，ADR 0002）：**
+
+- **基准 = `origin/main`（唯一真相源）；`.codespace/<app>/` 的检出 = 视图**——本地模式可暂态被需求分支占用，收尾恢复
+- **严禁直接在任何 main 检出上提交载荷**：分支感知 pre-commit hook 机械拦截（workspace 仓库仅放行控制面白名单：`CBB-WORKSPACE.json` / `.gitignore` / `AGENTS.md` / `openspec/config.yaml` / `openspec/schemas/**`；应用仓库 main 全拦；**merge 提交（`MERGE_HEAD` 存在）放行**，见 ADR 0007）——**被拦是防线生效，不是故障**；`--no-verify` 绕过仅限用户显式要求
+- 需求分支推送唯一出口 = `cbb-worktree-push`（init 创建流程零远端操作，lazy push）；推送后可选提 MR 或**直接合并**（`merge-branches.js`，主干 / 测试分支，ADR 0008）；收尾合并门禁同源（ADR 0007）
+- **收尾合并门禁（ADR 0007）**：两模式收尾均须每仓库"已合并"（`safety-check` / `merge-branches.js --check` 判定）；未合并三选一——提 MR / 直合并 / 确认废弃（远程重命名 `<分支>-deprecated`）；交付完成自动删本地+远程分支
+- **模式误判零代价**：本地模式中途要并行/隔离 → 重跑 `cbb-worktree-init`（分支已存在自动复用，提交随身带走）
+
+**三时刻对齐（agent 必须遵守）：**
+
+1. **开工前——状态自检**（`cbb-local-mode` 的 `check-local-state.js`）：干净态零交互直接开工；**遗留态（别的需求未收尾，任一仓库检出在非主干分支）必须让用户四选一**（继续 / 先收尾 / 升级 worktree / 丢弃），不得自行决定
+2. **开工时——布局确认**：向用户展示参与仓库与分支名，确认后执行
+3. **进行中——插单归属**：用户插入非本需求的改动，先确认归属（并入 / 收尾后处理 / 转 worktree），不得静默混入
+
+**读基准代码约定：** 本地模式进行中，工作区是开发态而非基准——要读"main 现状"先确认检出分支，或直接 `git show main:<path>` / `git diff main`；不要默认工作区即基准。
+
+**检验标准：** 任何 main 检出上无载荷提交（hook 兜底，git log 可机械审计；merge 提交除外）；本地模式收尾后全部仓库回主干且 clean；worktree 模式的变更产物只出现在需求工作树内；需求分支只经 push 技能产生；**未合并且非废弃的分支无法通过收尾（门禁兜底）**。

package/cbb/lib/install/init.js

@@ -396,7 +396,7 @@ function deployCoreRules(adapter, isUpgrade, managedPaths) {
   const rulesDest = path.join(TARGET_DIR, adapter.rulesDir);
   const action = isUpgrade ? '更新' : '安装';
 
-  const coreRules = ['cbb-coding-rule.md', 'cbb-priority.md', 'cbb-ai-behavior.md'];
+  const coreRules = ['cbb-coding-rule.md', 'cbb-priority.md', 'cbb-ai-behavior.md', 'cbb-workspace-discipline.md'];
 
   // 确保目标目录存在
   fs.mkdirSync(rulesDest, { recursive: true });
@@ -1086,13 +1086,14 @@ async function init(targetDir, options = {}) {
     newPaths.add(`${adapter.rulesDir}/cbb-coding-rule.md`);
     newPaths.add(`${adapter.rulesDir}/cbb-priority.md`);
     newPaths.add(`${adapter.rulesDir}/cbb-ai-behavior.md`);
+    newPaths.add(`${adapter.rulesDir}/cbb-workspace-discipline.md`);
     // opencode：rules glob 登记进 .opencode/opencode.json instructions，并迁移根文件旧登记
     if (adapter.instructionsFile) {
       injectInstructions(adapter, newPaths, managedPaths);
       migrateLegacyInstructions(adapter);
     }
   });
-  log(`核心规则 → ${selectedAdapters.map(a => a.rulesDir).join(', ')} (2 个文件)`, 'success');
+  log(`核心规则 → ${selectedAdapters.map(a => a.rulesDir).join(', ')} (4 个文件)`, 'success');
 
   // 安装 Skills（支持 skills 的适配器）
   const skillsAdapters = selectedAdapters.filter(a => a.skillsDir);
@@ -1212,15 +1213,6 @@ async function init(targetDir, options = {}) {
   setupOpenSpec(isUpgrade, managedPaths);
   newPaths.add('openspec/config.yaml');
 
-  // 业务空间根专属：空间导航 AGENTS.md（仅缺失时生成，永不覆盖）+ 旧版导航文案提示
-  let agentsMdState = null;
-  if (isWorkspaceRoot) {
-    agentsMdState = workspaces.ensureWorkspaceAgentsMd(TARGET_DIR);
-    if (workspaces.detectLegacyAgentsMd(TARGET_DIR)) {
-      log('空间根 AGENTS.md 仍是旧版导航文案（单层安装改造前模板）。建议删除该文件后重跑 cbb update 重新生成（仅缺失时生成，不会覆盖你的增补内容）', 'warn');
-    }
-  }
-
   // AGENTS.md 规则导航块（声明 agentsNav 的适配器；MiniMax 唯一项目级规则注入通道）。
   // 选中 → 注入/更新托管块（块外用户内容不动）；未选中（本次 update 取消勾选）→ 精确摘除。
   let agentsNavState = null;
@@ -1366,7 +1358,6 @@ async function init(targetDir, options = {}) {
   if (hasCommands) extras.push('Commands');
   if (hasHooks) extras.push('版本检查 hook');
   if (hookSummary) extras.push('提交防线 pre-commit hook');
-  if (agentsMdState === 'created') extras.push('AGENTS.md（空间导航）');
   if (agentsNavState === 'created' || agentsNavState === 'updated') extras.push('AGENTS.md（规则导航）');
   if (extras.length > 0) {
     console.log(`  ${extras.join(' / ')} 已配置`);
@@ -1983,7 +1974,7 @@ async function setupUserLevelComponents(targetAdapters = toolSelection.selectabl
  * cbb update：就地升级当前目录内容 + 用户级组件。
  *
  * 单层安装：统一安装器按空间根判定（CBB-WORKSPACE.json + .git 目录）补齐
- * worktree 管理入口与空间导航；旧子集清单升级时由清单差集机制自动补齐全量内容。
+ * worktree 管理入口；旧子集清单升级时由清单差集机制自动补齐全量内容。
  */
 async function updateInstalled() {
   // 用户级组件沿用本目录的工具选择（.last-tools），无记录或为空才回退全量。

package/cbb/lib/install/workspaces.js

@@ -8,7 +8,6 @@
  *  - 加载 + 校验
  *  - 归一化 remote URL（兼容 SSH / HTTPS 两种写法）
  *  - 检测当前目录是否已拉取指定 workspace 的仓库
- *  - 空间种子文件生成（AGENTS.md 空间导航，仅缺失时）
  */
 
 const fs = require('fs');
@@ -17,7 +16,6 @@ const { execSync } = require('child_process');
 
 const DEFAULT_CONFIG = 'config/workspaces.json';
 const SAMPLE_CONFIG  = 'config/CBB-WORKSPACE.sample.json';
-const SAMPLE_AGENTS_MD = 'config/workspace-agents.sample.md';
 
 /**
  * 归一化 git remote URL：提取 "namespace/repo" 形式（去掉 .git 后缀）。
@@ -168,51 +166,6 @@ function validateWorkspaceConfig(configPath) {
   return { valid: true, config: raw };
 }
 
-/**
- * 确保业务空间根目录存在 AGENTS.md（空间导航文件，讲清目录职责与协作约定）。
- *
- * 仅缺失时从包内模板复制；已存在（可能含团队自维护内容）一律不覆盖。
- * 该文件不登记安装清单，升级 / 卸载均不触碰。
- *
- * @param {string} targetDir 业务空间根目录
- * @returns {'exists' | 'created'}
- */
-function ensureWorkspaceAgentsMd(targetDir) {
-  const agentsPath = path.join(targetDir, 'AGENTS.md');
-  if (fs.existsSync(agentsPath)) return 'exists';
-
-  const samplePath = path.resolve(__dirname, '..', '..', '..', SAMPLE_AGENTS_MD);
-  fs.copyFileSync(samplePath, agentsPath);
-  return 'created';
-}
-
-// 旧版空间导航模板的特征语句（命中即提示用户删除后重跑 cbb update 重新生成；
-// 该文件归用户所有、永不覆盖）。分两代：
-//   - 0.0.3 单层安装改造前：前两条
-//   - 双模式重构前（≤0.0.3-beta.21，worktree 默认 + 轻量模式）：后两条
-const LEGACY_AGENTS_MD_MARKERS = [
-  '故意不含编码规范',
-  '自动安装沙箱内的编码规范',
-  '轻量模式',
-  'AI 会话始终停在空间根',
-];
-
-/**
- * 检测空间根 AGENTS.md 是否仍为旧版导航文案（命中任一特征语句即为旧版）。
- * 仅用于安装时打印提示，不修改文件。
- * @returns {boolean}
- */
-function detectLegacyAgentsMd(targetDir) {
-  const agentsPath = path.join(targetDir, 'AGENTS.md');
-  if (!fs.existsSync(agentsPath)) return false;
-  try {
-    const content = fs.readFileSync(agentsPath, 'utf-8');
-    return LEGACY_AGENTS_MD_MARKERS.some(m => content.includes(m));
-  } catch (_) {
-    return false;
-  }
-}
-
 /**
  * 在指定目录执行 `git remote -v`，解析出 [{ name, url }] 列表。
  * 任何异常静默返回空数组，便于上层用 state 机判定。
@@ -306,13 +259,10 @@ function findSampleApps(apps) {
 module.exports = {
   DEFAULT_CONFIG,
   SAMPLE_CONFIG,
-  SAMPLE_AGENTS_MD,
   normalizeRepoUrl,
   matchesConfiguredRepo,
   loadWorkspaces,
   validateWorkspaceConfig,
-  ensureWorkspaceAgentsMd,
-  detectLegacyAgentsMd,
   readGitRemotes,
   detectRepo,
   extractRepoBasename,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.34",
+  "version": "0.0.3-beta.36",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {

package/config/workspace-agents.sample.md

@@ -1,10 +0,0 @@
-# AGENTS.md
-
-本空间由 `@jspg-ai/coding-bb` 初始化（升级用 `cbb update`）。
-
-- **行为准则与开发纪律**（双模式、基准 = `origin/main`、提交防线、推送出口）：见你所用 AI 工具规则目录中的 `cbb-ai-behavior.md`——各工具自动加载；未适配的工具可任选一处直接读，如 `.claude/rules/cbb-ai-behavior.md` 或 `.qoder/rules/` 下同名文件。
-- **空间事实**：关联应用清单（增减应用即编辑它）见 `CBB-WORKSPACE.json`；目录职责建议维护在你自己的 `README.md`。
-
----
-
-本文件由 `@jspg-ai/coding-bb` 生成（仅缺失时写入，之后不会覆盖或删除，可自由增补团队约定）。