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

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 };