@jspg-ai/coding-bb 0.0.3-beta.28 → 0.0.3-beta.29

package/cbb/lib/install/agents-nav.js

@@ -0,0 +1,92 @@
+'use strict';
+
+/**
+ * AGENTS.md 托管导航块（agentsNav）。
+ *
+ * MiniMax Code 不读取 .minimax/rules（源码无该逻辑），其项目级规则注入通道
+ * 只有工作区根 AGENTS.md（local-runtime/src/project/instructions.ts，32KB 预算）。
+ * 安装时在 AGENTS.md 注入一句托管导航，引导 AI 先读取规则；块形如：
+ *
+ *   <!-- cbb:agents-nav:minimax begin -->
+ *   ⚠️ 规则优先：……
+ *   <!-- cbb:agents-nav:minimax end -->
+ *
+ * 约束：
+ *  - 幂等：块内容随安装更新，块外用户内容永不改动；
+ *  - 标记带适配器名，多适配器共存不互撞；
+ *  - 卸载只摘除本包块；摘除后文件为空（本包创建的情形）则删除文件。
+ *
+ * AGENTS.md 本身不进清单（cleanup.js 的 PROTECTED_FROM_CLEANUP 同样保护它），
+ * 托管块的注入与摘除由 init() 安装流程 / uninstall() 按适配器显式处理。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/** 转义正则元字符（适配器名入正则上下文） */
+function escapeRe(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function markersFor(adapterName) {
+  const safe = escapeRe(adapterName);
+  return {
+    begin: `<!-- cbb:agents-nav:${adapterName} begin -->`,
+    end: `<!-- cbb:agents-nav:${adapterName} end -->`,
+    // [\s\S]*? 非贪婪：块内可含任意内容（含 \r），遇最近的 end 标记即止
+    blockRe: new RegExp(`<!-- cbb:agents-nav:${safe} begin -->[\\s\\S]*?<!-- cbb:agents-nav:${safe} end -->`, 'm'),
+  };
+}
+
+/**
+ * 注入（或更新）导航块。
+ * @param {string} filePath 目标 AGENTS.md 绝对路径
+ * @param {string} adapterName 适配器名（标记命名空间）
+ * @param {string} text 导航句
+ * @returns {'created'|'updated'|'unchanged'} created = 文件原不存在或为空白
+ */
+function inject(filePath, adapterName, text) {
+  const { begin, end, blockRe } = markersFor(adapterName);
+  const existed = fs.existsSync(filePath);
+  const content = existed ? fs.readFileSync(filePath, 'utf-8') : '';
+  // 行尾与既有文件保持一致（Windows 生成的 AGENTS.md 多为 CRLF）
+  const eol = content.includes('\r\n') ? '\r\n' : '\n';
+  const block = `${begin}${eol}${text}${eol}${end}`;
+
+  if (blockRe.test(content)) {
+    const next = content.replace(blockRe, block);
+    if (next === content) return 'unchanged';
+    fs.writeFileSync(filePath, next);
+    return 'updated';
+  }
+
+  const wasBlank = content.trim() === '';
+  const base = content.replace(/\n*$/, ''); // 收敛尾部空行，块另起段落
+  const next = wasBlank ? `${block}${eol}` : `${base}${eol}${eol}${block}${eol}`;
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, next);
+  return wasBlank && !existed ? 'created' : wasBlank ? 'updated' : 'created';
+}
+
+/**
+ * 精确摘除导航块（块外内容不动）。
+ * @returns {boolean} 是否有改动（块不存在 → false）
+ */
+function remove(filePath, adapterName) {
+  if (!fs.existsSync(filePath)) return false;
+  const { blockRe } = markersFor(adapterName);
+  const content = fs.readFileSync(filePath, 'utf-8');
+  if (!blockRe.test(content)) return false;
+
+  // 只删块本身；随后收敛尾部空白（块移除后的残留空行）
+  const next = content.replace(blockRe, '').replace(/\s+$/, '');
+  if (next.trim() === '') {
+    // 文件只剩本包内容（由本包创建的情形）→ 连文件一起删除
+    fs.unlinkSync(filePath);
+    return true;
+  }
+  fs.writeFileSync(filePath, next + '\n');
+  return true;
+}
+
+module.exports = { inject, remove };

package/cbb/lib/install/command-skill.js

@@ -0,0 +1,105 @@
+'use strict';
+
+/**
+ * openspec 命令 → skill 形态转换（commandsAsSkills 适配器用，当前仅 MiniMax Code）。
+ *
+ * MiniMax Code 无项目级 commands 目录，skill 即其命令形态：每个 openspec 命令
+ * 落为 <skillsDir>/<prefix><name>/SKILL.md，目录名 = frontmatter name（Agent
+ * Skills 约定），/opsx-propose 斜杠照常可用。
+ *
+ * 同时承接命令 frontmatter 消毒（sanitizeCommandFrontmatter）：opencode 新版
+ * 校验命令配置（description 必须为 string | undefined），上游个别命令
+ * （openspec/commands/update.md）的 description 为空值（YAML 解析为 null），
+ * 会拒绝加载整个项目配置。此处对部署副本回填正文首句作为描述（超过 120 字
+ * 截断），上游源文件不动（CLI 接管区）。
+ */
+
+const path = require('path');
+
+/**
+ * 命令文件 → skill 目录名（文件名基准，保证目录名稳定）。
+ * @param {string} fileName 如 propose.md
+ * @param {string} prefix 如 opsx-
+ * @returns {string} 如 opsx-propose
+ */
+function skillNameFor(fileName, prefix) {
+  return (prefix || '') + path.basename(fileName, '.md');
+}
+
+/** 取 frontmatter（首个 --- 到闭合 --- 之间）；无 frontmatter 返回 -1 */
+function findFrontmatterEnd(lines) {
+  if ((lines[0] || '').trim() !== '---') return -1;
+  for (let i = 1; i < lines.length; i++) {
+    if ((lines[i] || '').trim() === '---') return i;
+  }
+  return -1;
+}
+
+/**
+ * 命令 frontmatter 消毒（见文件头注释）。无 frontmatter 或无需改动时原样返回。
+ */
+function sanitizeCommandFrontmatter(content) {
+  const lines = content.split('\n');
+  if ((lines[0] || '').trim() !== '---') return content;
+  const end = findFrontmatterEnd(lines);
+  if (end === -1) return content;
+  let sentence = '';
+  for (let i = end + 1; i < lines.length; i++) {
+    const t = (lines[i] || '').trim();
+    if (t) { sentence = t; break; }
+  }
+  let changed = false;
+  for (let i = 1; i < end; i++) {
+    if (/^description:\s*(null|~)?\s*\r?$/.test(lines[i])) {
+      if (sentence) {
+        if (sentence.length > 120) sentence = sentence.slice(0, 117) + '...';
+        lines[i] = 'description: ' + JSON.stringify(sentence) + (lines[i].endsWith('\r') ? '\r' : '');
+      } else {
+        lines[i] = null; // 无正文可回填则移除（undefined 同样合法）
+      }
+      changed = true;
+    }
+  }
+  return changed ? lines.filter(l => l !== null).join('\n') : content;
+}
+
+/**
+ * 把命令内容转换为 skill 的 SKILL.md 内容：
+ *  1. frontmatter description 消毒（null → 回填正文首句）；
+ *  2. frontmatter name 强制为 skillName —— 目录名 = name 是 Agent Skills 约定，
+ *     也规避上游标题与文件名不一致（如 ff.md 的 "OPSX: Fast Forward"）。
+ *
+ * 上游 frontmatter 的其余字段（category / tags 等）原样保留。
+ *
+ * @param {string} content 命令原文（调用方已应用 contentRewrites）
+ * @param {string} skillName 目标 skill 名（= 目录名）
+ * @returns {string} SKILL.md 内容
+ */
+function convertCommandToSkill(content, skillName) {
+  const sanitized = sanitizeCommandFrontmatter(content);
+  const lines = sanitized.split('\n');
+
+  // 无 frontmatter：补建（name 必填；description 回填正文首句）
+  if ((lines[0] || '').trim() !== '---') {
+    const sentence = (lines.find(l => l.trim()) || '').trim().slice(0, 120);
+    const fm = ['---', `name: "${skillName}"`];
+    if (sentence) fm.push(`description: ${JSON.stringify(sentence)}`);
+    fm.push('---', '');
+    return fm.concat(lines).join('\n');
+  }
+
+  const end = findFrontmatterEnd(lines);
+  if (end === -1) return sanitized; // 开了没闭合的异常 frontmatter：不动
+
+  let nameLine = -1;
+  for (let i = 1; i < end; i++) {
+    if (/^name:/.test(lines[i])) { nameLine = i; break; }
+  }
+  const nameValue = `name: "${skillName}"`;
+  if (nameLine === -1) lines.splice(1, 0, nameValue); // 缺 name：紧跟开标记插入
+  else lines[nameLine] = nameValue + (lines[nameLine].endsWith('\r') ? '\r' : '');
+
+  return lines.join('\n');
+}
+
+module.exports = { skillNameFor, sanitizeCommandFrontmatter, convertCommandToSkill };

package/cbb/lib/install/init.js

@@ -5,7 +5,8 @@
  *
  * 将AI 编码规范与工作流套件安装到目标项目中。
  * 支持工具：Claude Code (.claude/rules/)、Qoder (.qoder/rules/)、opencode (.opencode/rules/)、
- *          WorkBuddy (.workbuddy/rules/)、TraeWork/TraeCode 中国版 (.trae/rules/，用户级 hook 在 ~/.trae-cn)
+ *          WorkBuddy (.workbuddy/rules/)、TraeWork/TraeCode 中国版 (.trae/rules/，用户级 hook 在 ~/.trae-cn)、
+ *          MiniMax Code (.minimax/rules/，规则经 AGENTS.md 托管导航加载，命令转 skill，hook 走用户级本地插件)
  *
  * 使用方式：
  *   npm install -g @jspg-ai/coding-bb  # 首次使用
@@ -60,6 +61,7 @@ const adapters = [
   require('./trae'),
   require('./qoder'),
   require('./claude-code'),
+  require('./minimax'),
 ];
 
 // superpowers 部署白名单：仅装 openspec 工作流硬依赖 + 方法论基底（源仓库仍保留全量 15 个，
@@ -89,6 +91,15 @@ const OPENSPEC_COMMANDS_EXCLUDE = ['onboard.md'];
 // settings.json hook 工具
 const settingsManager = require('../utils/settings');
 
+// MiniMax 本地插件 hook（无 settings.json hooks 的适配器走插件形态）
+const pluginHookManager = require('../utils/plugin-hook');
+
+// AGENTS.md 托管导航块（agentsNav 适配器的项目级规则注入通道）
+const agentsNav = require('./agents-nav');
+
+// 命令 → skill 形态转换（commandsAsSkills 适配器，当前仅 MiniMax Code）
+const commandSkill = require('./command-skill');
+
 /** 适配器的 hook 方言参数（Trae 需顶层 version 字段等差异） */
 function hookOpts(adapter) {
   return adapter.hookDialect ? { dialect: adapter.hookDialect } : {};
@@ -639,47 +650,13 @@ function deployCommandFiles(adapter, srcDir, destDir, prefix, filter) {
     const srcPath = path.join(srcDir, f);
     const destPath = path.join(destDir, prefix + f);
     removePath(destPath);
-    const content = rewriteCommandName(adapter, sanitizeCommandFrontmatter(applyContentRewrites(adapter, fs.readFileSync(srcPath, 'utf-8'))));
+    const content = rewriteCommandName(adapter, commandSkill.sanitizeCommandFrontmatter(applyContentRewrites(adapter, fs.readFileSync(srcPath, 'utf-8'))));
     fs.writeFileSync(destPath, content);
   });
 
   return { count: commandFiles.length, names: commandFiles.map(f => prefix + f) };
 }
 
-/**
- * 命令 frontmatter 消毒：opencode 新版校验命令配置（description 必须为 string | undefined），
- * 上游个别命令（openspec/commands/update.md）的 description 为空值（YAML 解析为 null），
- * 会导致 opencode 拒绝加载整个项目配置。此处对部署副本回填正文首句作为描述
- * （超过 120 字截断），上游源文件不动（CLI 接管区）。
- */
-function sanitizeCommandFrontmatter(content) {
-  const lines = content.split('\n');
-  if ((lines[0] || '').trim() !== '---') return content;
-  let end = -1;
-  for (let i = 1; i < lines.length; i++) {
-    if ((lines[i] || '').trim() === '---') { end = i; break; }
-  }
-  if (end === -1) return content;
-  let sentence = '';
-  for (let i = end + 1; i < lines.length; i++) {
-    const t = (lines[i] || '').trim();
-    if (t) { sentence = t; break; }
-  }
-  let changed = false;
-  for (let i = 1; i < end; i++) {
-    if (/^description:\s*(null|~)?\s*\r?$/.test(lines[i])) {
-      if (sentence) {
-        if (sentence.length > 120) sentence = sentence.slice(0, 117) + '...';
-        lines[i] = 'description: ' + JSON.stringify(sentence) + (lines[i].endsWith('\r') ? '\r' : '');
-      } else {
-        lines[i] = null; // 无正文可回填则移除（undefined 同样合法）
-      }
-      changed = true;
-    }
-  }
-  return changed ? lines.filter(l => l !== null).join('\n') : content;
-}
-
 /**
  * opencode 命令显示名取自 frontmatter name，上游为大写空格风格（"OPSX: Propose"），
  * 与文档写法（/opsx-propose）不一致；部署副本统一重写为 kebab-case。
@@ -692,11 +669,49 @@ function rewriteCommandName(adapter, content) {
   });
 }
 
-/** 官方 OpenSpec 命令（openspec/commands/ → adapter.commandsDir） */
+/**
+ * MiniMax：无项目级 commands 目录，命令转 skill 形态（skill 即其斜杠命令），
+ * 每个命令落为 <skillsDir>/<prefix><name>/SKILL.md，目录名 = frontmatter name。
+ * @returns {{count:number, names:string[], destDir:string|null}} destDir 为清单登记用相对目录
+ */
+function deployCommandSkills(adapter, srcDir, filter) {
+  if (!fs.existsSync(srcDir)) return { count: 0, names: [], destDir: null };
+  const destDir = adapter.skillsDir;
+  const skillsRoot = path.join(TARGET_DIR, destDir);
+  fs.mkdirSync(skillsRoot, { recursive: true });
+
+  // 与 skill 同构的扁平 .md 源文件（命令不是子目录）
+  const commandFiles = fs.readdirSync(srcDir)
+    .filter(f => f.endsWith('.md') && fs.statSync(path.join(srcDir, f)).isFile())
+    .filter(f => !filter || filter.includes(f));
+
+  const names = [];
+  commandFiles.forEach(f => {
+    const skillName = commandSkill.skillNameFor(f, adapter.commandPrefix || '');
+    const skillDir = path.join(skillsRoot, skillName);
+    removePath(skillDir);
+    fs.mkdirSync(skillDir, { recursive: true });
+    const content = commandSkill.convertCommandToSkill(
+      applyContentRewrites(adapter, fs.readFileSync(path.join(srcDir, f), 'utf-8')),
+      skillName);
+    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), content);
+    names.push(skillName);
+  });
+
+  return { count: commandFiles.length, names, destDir };
+}
+
+/**
+ * 官方 OpenSpec 命令（openspec/commands/ → adapter.commandsDir；
+ * commandsAsSkills 适配器转 skill 形态 → adapter.skillsDir）
+ * @returns {{count:number, names:string[], destDir:string|null}}
+ */
 function deployCommands(adapter, isUpgrade, managedPaths, srcDir, filter) {
-  if (!adapter.commandsDir) return { count: 0, names: [] };
-  return deployCommandFiles(
+  if (adapter.commandsAsSkills) return deployCommandSkills(adapter, srcDir, filter);
+  if (!adapter.commandsDir) return { count: 0, names: [], destDir: null };
+  const result = deployCommandFiles(
     adapter, srcDir, path.join(TARGET_DIR, adapter.commandsDir), adapter.commandPrefix || '', filter);
+  return { ...result, destDir: adapter.commandsDir };
 }
 
 // ── 设置 OpenSpec 工作流 ──────────────────────────────────
@@ -1125,8 +1140,8 @@ async function init(targetDir, options = {}) {
     await detectUserLevelSuperpowers(selectedAdapters, yes);
   }
 
-  // 安装 Commands（官方 11 个 → /opsx:*，onboard 不分发）
-  const commandsAdapters = selectedAdapters.filter(a => a.commandsDir);
+  // 安装 Commands（官方 11 个 → /opsx:*，onboard 不分发；commandsAsSkills 适配器转 skill 形态）
+  const commandsAdapters = selectedAdapters.filter(a => a.commandsDir || a.commandsAsSkills);
   if (commandsAdapters.length > 0) {
     console.log(`\n  ⚡ ${action} Commands...`);
     const commandsBaseSrc = path.join(SHARED_STANDARDS_DIR, 'openspec', 'commands');
@@ -1134,7 +1149,7 @@ async function init(targetDir, options = {}) {
       .filter(f => f.endsWith('.md') && !OPENSPEC_COMMANDS_EXCLUDE.includes(f));
 
     const cmdDests = [...new Set(commandsAdapters
-      .map(a => a.commandsDir)
+      .map(a => a.commandsDir || (a.commandsAsSkills ? `${a.skillsDir}（转 skill）` : null))
       .filter(Boolean))];
     let cmdCount = 0;
     commandsAdapters.forEach(adapter => {
@@ -1143,7 +1158,7 @@ async function init(targetDir, options = {}) {
       const baseResult = deployCommands(adapter, isUpgrade, managedPaths, commandsBaseSrc, openspecCmdInclude);
       if (baseResult.count > 0) {
         adapterCmdCount += baseResult.count;
-        baseResult.names.forEach(name => newPaths.add(`${adapter.commandsDir}/${name}`));
+        baseResult.names.forEach(name => newPaths.add(`${baseResult.destDir}/${name}`));
       }
       cmdCount = Math.max(cmdCount, adapterCmdCount);
     });
@@ -1173,9 +1188,27 @@ async function init(targetDir, options = {}) {
     }
   }
 
-  // 写入自动版本检查 hook
+  // AGENTS.md 规则导航块（声明 agentsNav 的适配器；MiniMax 唯一项目级规则注入通道）。
+  // 选中 → 注入/更新托管块（块外用户内容不动）；未选中（本次 update 取消勾选）→ 精确摘除。
+  let agentsNavState = null;
+  let agentsNavFile = null;
+  adapters.filter(a => a.agentsNav).forEach(adapter => {
+    const target = path.join(TARGET_DIR, adapter.agentsNav.file);
+    if (selectedAdapters.some(sa => sa.name === adapter.name)) {
+      const state = agentsNav.inject(target, adapter.name, adapter.agentsNav.text);
+      if (state !== 'unchanged') { agentsNavState = state; agentsNavFile = adapter.agentsNav.file; }
+    } else if (agentsNav.remove(target, adapter.name)) {
+      agentsNavState = 'removed';
+    }
+  });
+  if (agentsNavState === 'created' || agentsNavState === 'updated') {
+    log(`AGENTS.md 规则导航 → ${agentsNavFile}`, 'success');
+  }
+
+  // 写入自动版本检查 hook（settings.json 方言 + 本地插件方言）
   const hookAdapters = selectedAdapters.filter(a => a.settingsFile && a.hookEvents);
-  if (hookAdapters.length > 0) {
+  const pluginHookAdapters = selectedAdapters.filter(a => a.pluginHook);
+  if (hookAdapters.length > 0 || pluginHookAdapters.length > 0) {
     console.log(`\n  🔔 配置自动版本检查...`);
     const command = settingsManager.getCheckUpdateCommand();
     hookAdapters.forEach(adapter => {
@@ -1194,7 +1227,22 @@ async function init(targetDir, options = {}) {
       }
       if (!adapter.settingsFileIsUserLevel) newPaths.add(adapter.settingsFile);
     });
-    log(`版本检查 hook → ${hookAdapters.map(a => a.displayName).join(', ')} (${hookAdapters[0].hookEvents.join(', ')})`, 'success');
+    if (hookAdapters.length > 0) {
+      log(`版本检查 hook → ${hookAdapters.map(a => a.displayName).join(', ')} (${hookAdapters[0].hookEvents.join(', ')})`, 'success');
+    }
+    // 本地插件方言（MiniMax：无 settings.json hooks）——用户级，不写入项目清单
+    if (pluginHookAdapters.length > 0) {
+      const pkgVersion = require(path.join(SHARED_STANDARDS_DIR, 'package.json')).version;
+      pluginHookAdapters.forEach(adapter => {
+        const info = pluginHookManager.install({
+          dataDir: adapter.resolveDataDir(),
+          ...adapter.pluginHook,
+          command,
+          version: pkgVersion,
+        });
+        log(`${adapter.displayName} 版本检查插件 → ${info.dir}`, 'success');
+      });
+    }
   }
 
   // 升级时清理旧路径（在旧清单中但不在新路径集中）。
@@ -1278,14 +1326,15 @@ async function init(targetDir, options = {}) {
 
   // 附加组件（单行）
   const hasSkills = selectedAdapters.some(a => a.skillsDir);
-  const hasCommands = selectedAdapters.some(a => a.commandsDir);
-  const hasHooks = selectedAdapters.some(a => a.settingsFile && a.hookEvents);
+  const hasCommands = selectedAdapters.some(a => a.commandsDir || a.commandsAsSkills);
+  const hasHooks = selectedAdapters.some(a => (a.settingsFile && a.hookEvents) || a.pluginHook);
   const extras = [];
   if (hasSkills) extras.push('Skills');
   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(' / ')} 已配置`);
   }
@@ -1829,6 +1878,22 @@ async function setupUserLevelComponents(targetAdapters = adapters) {
     summaryParts.push(`版本检查 hook → ${hookAdapters.map(a => a.displayName).join('、')}`);
   }
 
+  // 本地插件 hook（MiniMax：无 settings.json hooks，走 <dataDir>/plugins 本地插件，幂等覆盖）
+  const pluginHookAdapters = targetAdapters.filter(a => a.pluginHook);
+  if (pluginHookAdapters.length > 0) {
+    const command = settingsManager.getCheckUpdateCommand();
+    const pkgVersion = require(path.join(SHARED_STANDARDS_DIR, 'package.json')).version;
+    pluginHookAdapters.forEach(adapter => {
+      pluginHookManager.install({
+        dataDir: adapter.resolveDataDir(),
+        ...adapter.pluginHook,
+        command,
+        version: pkgVersion,
+      });
+    });
+    summaryParts.push(`版本检查插件 → ${pluginHookAdapters.map(a => a.displayName).join('、')}`);
+  }
+
   if (summaryParts.length > 0) step('✓', '用户级组件', summaryParts.join(' · '));
 
   const pkg = require(path.join(SHARED_STANDARDS_DIR, 'package.json'));
@@ -1974,7 +2039,7 @@ async function uninstall() {
   // 是否同时卸载用户级组件（工具 skills + 版本检查 hook，作用于 ~/.claude 等用户目录）
   let removeUserLevel = false;
   if (fs.existsSync(USER_MANIFEST_FILE)) {
-    const answerUser = await ask('是否同时卸载用户级组件（~/.claude、~/.qoder、~/.workbuddy、~/.trae-cn 的版本检查 hook）？(y/N): ');
+    const answerUser = await ask('是否同时卸载用户级组件（~/.claude、~/.qoder、~/.workbuddy、~/.trae-cn 的版本检查 hook、MiniMax Code 本地插件）？(y/N): ');
     removeUserLevel = answerUser.toLowerCase() === 'y' || answerUser.toLowerCase() === 'yes';
   }
 
@@ -2003,6 +2068,25 @@ async function uninstall() {
     skippedPaths.add(adapter.settingsFile);
   });
 
+  // 本地插件 hook（MiniMax，用户级组件）：仅确认卸载用户级时删除插件目录
+  if (removeUserLevel) {
+    adapters.forEach(adapter => {
+      if (!adapter.pluginHook) return;
+      if (pluginHookManager.remove({ dataDir: adapter.resolveDataDir(), ...adapter.pluginHook })) {
+        log(`移除 ${adapter.displayName} 版本检查插件（${adapter.resolveDataDir()}）`, 'success');
+      }
+    });
+  }
+
+  // AGENTS.md 规则导航块：本包托管块精确摘除（块外用户内容不动；文件归用户所有不进清单）
+  adapters.forEach(adapter => {
+    if (!adapter.agentsNav) return;
+    const target = path.join(TARGET_DIR, adapter.agentsNav.file);
+    if (agentsNav.remove(target, adapter.name)) {
+      log(`移除 ${adapter.agentsNav.file} 规则导航块`, 'success');
+    }
+  });
+
   // opencode.json：移除本包登记的 instructions pattern（cbb 创建的整体文件由清单删除兜底）
   removeInstructionsRegistrations();
 

package/cbb/lib/install/minimax.js

@@ -0,0 +1,53 @@
+/**
+ * MiniMax Code（mcode CLI）适配器
+ *
+ * 官方源码考证结论（agent.minimaxi.com 文档站 + 源码浅克隆）：
+ * - rules：MiniMax 无原生 rules 自动读取逻辑（源码无 .minimax/rules 读取），
+ *   规则照常分发到 .minimax/rules/，靠 AGENTS.md 托管导航块（agentsNav）引导
+ *   AI 主动读取——AGENTS.md 是 MiniMax 唯一的项目级规则注入通道
+ *   （local-runtime/src/project/instructions.ts，32KB 预算）。
+ * - skills：.minimax/skills 为原生 workspace skill 根（skills/roots.ts），
+ *   标准 Agent Skills 格式（目录名 = frontmatter name）零改写。
+ * - commands：MiniMax 无项目级 commands 目录，openspec 命令转 skill 形态分发
+ *   （skill 即其命令形态，/opsx-propose 斜杠照常可用），commandsAsSkills: true。
+ * - hooks：无 Claude 式 settings.json hooks（hooks 仅插件作用域），版本检查改用
+ *   用户级本地插件（<data-dir>/plugins/cbb-check-update，声明 UserPromptSubmit）。
+ *
+ * 数据目录：MINIMAX_DATA_DIR（优先）> MAVIS_DATA_DIR > ~/.minimax，与 mcode
+ * 运行时一致；用户若改过数据目录，需重跑 cbb update 以重装插件到新位置。
+ */
+
+const path = require('path');
+const os = require('os');
+
+/** 解析 mcode 数据目录（调用时求值，便于环境变量覆盖与测试） */
+function resolveDataDir() {
+  return process.env.MINIMAX_DATA_DIR
+    || process.env.MAVIS_DATA_DIR
+    || path.join(os.homedir(), '.minimax');
+}
+
+module.exports = {
+  name: 'minimax',
+  displayName: 'MiniMax Code',
+  rulesDir: '.minimax/rules',
+  skillsDir: '.minimax/skills',
+  // 无项目级 commands 目录：openspec 命令转 <skillsDir>/<prefix><name>/SKILL.md
+  commandsAsSkills: true,
+  commandPrefix: 'opsx-',
+  // 部署副本中把 /opsx: 与 /cbb: 引用改写为 skill 斜杠风格（/opsx-propose）
+  contentRewrites: [['/opsx:', '/opsx-'], ['/cbb:', '/cbb-']],
+  // AGENTS.md 托管导航块（幂等注入 / 卸载精确摘除，不触碰块外用户内容）
+  agentsNav: {
+    file: 'AGENTS.md',
+    text: '⚠️ 规则优先：在当前目录下执行的任何任务（不限于编码任务）开始前，必须先读取并遵循 `.minimax/rules/` 中的相关规则文件。',
+  },
+  // 版本检查 hook：用户级本地插件（<dataDir>/plugins/<dirName>，自动发现热加载、默认启用）
+  pluginHook: {
+    dirName: 'cbb-check-update',
+    events: ['UserPromptSubmit'],
+    // 解析上限：MiniMax timeout 单位为秒，1–10（超出视为非法回落 5s）
+    timeout: 10,
+  },
+  resolveDataDir,
+};

package/cbb/lib/utils/check-update.js

@@ -28,18 +28,22 @@ function getProjectDir() {
     || process.env.TRAE_CN_PROJECT_DIR
     || process.env.TRAE_PROJECT_DIR
     || process.env.QODER_PROJECT_DIR
+    // MiniMax 同时注入 MINIMAX_PROJECT_DIR 与 CLAUDE_PROJECT_DIR，专属变量优先
+    || process.env.MINIMAX_PROJECT_DIR
     || process.env.CLAUDE_PROJECT_DIR
     || process.cwd();
 }
 
 /** 通过环境变量检测当前调用方对应的适配器名称 */
 function detectAdapterName() {
-  // 兼容变量（CLAUDE_PROJECT_DIR）由 Trae / WorkBuddy 一并注入，故优先判定各自专属变量；
+  // 兼容变量（CLAUDE_PROJECT_DIR）由 Trae / WorkBuddy / MiniMax 一并注入，故优先判定各自专属变量；
   // CODEBUDDY_PROJECT_DIR 为 WorkBuddy 沿用的历史变量名，一并识别为 workbuddy；
-  // TRAE_CN_PROJECT_DIR / TRAE_PROJECT_DIR 为中国版 Trae 的变量名（不同版本注入不一），均识别为 trae
+  // TRAE_CN_PROJECT_DIR / TRAE_PROJECT_DIR 为中国版 Trae 的变量名（不同版本注入不一），均识别为 trae；
+  // MINIMAX_PROJECT_DIR 为 MiniMax Code 专属变量（插件 hook 注入，与 CLAUDE_PROJECT_DIR 同时存在）
   if (process.env.WORKBUDDY_PROJECT_DIR || process.env.CODEBUDDY_PROJECT_DIR) return 'workbuddy';
   if (process.env.TRAE_CN_PROJECT_DIR || process.env.TRAE_PROJECT_DIR) return 'trae';
   if (process.env.QODER_PROJECT_DIR) return 'qoder';
+  if (process.env.MINIMAX_PROJECT_DIR) return 'minimax';
   if (process.env.CLAUDE_PROJECT_DIR) return 'claude-code';
   return null;
 }

package/cbb/lib/utils/gitignore.js

@@ -30,6 +30,8 @@ const GITIGNORE_RULES = [
   // 但卸载/清理时仍移除其 gitignore 行
   { add: null, accept: ['.trae-cn', '.trae-cn/'] },
   { add: '.trae', accept: ['.trae', '.trae/'] },
+  // .minimax：MiniMax Code 项目级配置根（rules / skills）
+  { add: '.minimax', accept: ['.minimax', '.minimax/'] },
 ];
 
 /** 将 .gitignore 文本拆为行数组。 */

package/cbb/lib/utils/plugin-hook.js

@@ -0,0 +1,92 @@
+'use strict';
+
+/**
+ * MiniMax Code 本地插件 hook 的安装 / 卸载工具。
+ *
+ * MiniMax 无 Claude 式 settings.json hooks（hooks 仅插件作用域），版本检查改由
+ * 用户级本地插件承担：
+ *   <dataDir>/plugins/cbb-check-update/
+ *     .claude-plugin/plugin.json    兼容 manifest（仅 name 必填，走 CLAUDE 兼容读取器）
+ *     hooks/hooks.json              manifest 未声明 hooks 时的默认路径
+ *
+ * 机制（源码考证）：
+ *  - 本地插件根为 path.join(dataDir, 'plugins')，由扫描自动发现并热加载
+ *    （package-storage.ts + watcher），无需重启 mcode；
+ *  - 本地插件默认启用（不在 pluginDisabledLocalRoots 表即启用）；
+ *  - hook 事件 UserPromptSubmit，stdin 收 session_id JSON（与 Claude 同构），
+ *    输出 hookSpecificOutput.additionalContext 注入对话；
+ *  - timeout 单位为秒（1–10，超限视为非法回落 5s）；非 0 退出码（exit 2）会拒绝
+ *    prompt —— check-update.js 恒 exit 0，绝不阻塞；
+ *  - Windows 下 CLAUDE 格式命令经 Git Bash / PowerShell 执行（不走 cmd.exe）。
+ *
+ * 本插件目录整目录归本包管理：安装幂等覆盖本包两个文件，卸载直接删除目录。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/** 插件目录：dataDir + plugins + dirName */
+function pluginDir({ dataDir, dirName }) {
+  return path.join(dataDir, 'plugins', dirName);
+}
+
+/** 幂等写入（内容一致不重写，避免触发插件 digest 重算） */
+function writeIfChanged(file, content) {
+  if (fs.existsSync(file) && fs.readFileSync(file, 'utf-8') === content) return false;
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, content);
+  return true;
+}
+
+/**
+ * 安装（幂等）版本检查插件。
+ *
+ * @param {object} opts
+ * @param {string} opts.dataDir mcode 数据目录（由适配器 resolveDataDir 解析）
+ * @param {string} opts.dirName 插件目录名（cbb-check-update）
+ * @param {string[]} opts.events hook 事件（['UserPromptSubmit']）
+ * @param {number} opts.timeout 秒（1–10）
+ * @param {string} opts.command hook 命令（node "<check-update.js>"）
+ * @param {string} opts.version 插件 manifest 版本（= 本包版本）
+ * @returns {{dir: string, changed: boolean}}
+ */
+function install({ dataDir, dirName, events, timeout, command, version }) {
+  const root = pluginDir({ dataDir, dirName });
+
+  const manifest = {
+    name: dirName,
+    description: '@jspg-ai/coding-bb 版本检查 hook（UserPromptSubmit 触发，每日最多请求一次 registry）',
+    version: version || '0.0.0',
+    author: 'jspg-ai',
+    // 刻意不声明 hooks 字段：CLAUDE 兼容读取器对未声明的 hooks 走默认路径
+    // hooks/hooks.json（readPluginCapabilities 的 defaultPath），结构最稳。
+  };
+
+  const hooksDoc = {
+    hooks: Object.fromEntries(events.map(event => [event, [{
+      hooks: [{ type: 'command', command, timeout }],
+    }]])),
+  };
+
+  const changedManifest = writeIfChanged(
+    path.join(root, '.claude-plugin', 'plugin.json'),
+    JSON.stringify(manifest, null, 2) + '\n');
+  const changedHooks = writeIfChanged(
+    path.join(root, 'hooks', 'hooks.json'),
+    JSON.stringify(hooksDoc, null, 2) + '\n');
+
+  return { dir: root, changed: changedManifest || changedHooks };
+}
+
+/**
+ * 卸载版本检查插件（整目录删除）。
+ * @returns {boolean} 是否有删除动作
+ */
+function remove({ dataDir, dirName }) {
+  const root = pluginDir({ dataDir, dirName });
+  if (!fs.existsSync(root)) return false;
+  fs.rmSync(root, { recursive: true, force: true });
+  return true;
+}
+
+module.exports = { pluginDir, install, remove };

package/cbb/worktrees/_shared/scripts/junction-ai-config.js

@@ -33,7 +33,7 @@ if (!wsRoot || !wtPath) {
 }
 
 // 各工具的项目级配置根（存在才处理）与本包部署的内容子目录
-const CONFIG_ROOTS = ['.claude', '.qoder', '.opencode', '.workbuddy', '.trae'];
+const CONFIG_ROOTS = ['.claude', '.qoder', '.opencode', '.workbuddy', '.trae', '.minimax'];
 const CONTENT_SUBDIRS = ['rules', 'skills', 'commands'];
 // 文件级内容（复制而非 junction）：opencode 的 instructions 登记
 const CONTENT_FILES = { '.opencode': ['opencode.json'] };

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

@@ -304,7 +304,7 @@ WT_PATH d:\workspace\xxx\.worktrees\worktree-feature-login
 node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 ```
 
-脚本把根的 AI 配置**内容子目录**（`.claude/`、`.qoder/`、`.opencode/`、`.workbuddy/`、`.trae/` 下的 rules / skills / commands）junction 进工作树；`.opencode/opencode.json` 为文件则复制。
+脚本把根的 AI 配置**内容子目录**（`.claude/`、`.qoder/`、`.opencode/`、`.workbuddy/`、`.trae/`、`.minimax/` 下的 rules / skills / commands）junction 进工作树；`.opencode/opencode.json` 为文件则复制。
 
 **解读末行 `JUNCTION_RESULT`**：
 - 退出码 0 → linked / copied / skipped（幂等）任一组合均成功
@@ -333,6 +333,8 @@ node "<skill_dir>/scripts/junction-ai-config.js" "<ws_root>" "<wt_path>"
 
 ## 最终报告
 
+> **输出纪律**：严格按下方格式输出，禁止追加规则提醒等额外段落；规则由 rules 系统在触发点呈现，不复述。
+
 最终报告格式：
 
 ```

package/cbb/worktrees/skills/cbb-worktree-init/scripts/junction-ai-config.js

@@ -33,7 +33,7 @@ if (!wsRoot || !wtPath) {
 }
 
 // 各工具的项目级配置根（存在才处理）与本包部署的内容子目录
-const CONFIG_ROOTS = ['.claude', '.qoder', '.opencode', '.workbuddy', '.trae'];
+const CONFIG_ROOTS = ['.claude', '.qoder', '.opencode', '.workbuddy', '.trae', '.minimax'];
 const CONTENT_SUBDIRS = ['rules', 'skills', 'commands'];
 // 文件级内容（复制而非 junction）：opencode 的 instructions 登记
 const CONTENT_FILES = { '.opencode': ['opencode.json'] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.28",
+  "version": "0.0.3-beta.29",
   "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/githook.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/install/setup-decision.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/githook.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/install/agents-nav.test.js && node test/lib/install/command-skill.test.js && node test/lib/utils/plugin-hook.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/install/setup-decision.test.js && node test/lib/openspec/protected-paths.test.js"
   },
   "keywords": [
     "cbb",