jsharness 1.10.0 → 1.11.0

package/lib/index.mjs

@@ -107,7 +107,7 @@ export const SUPPORTED_TOOLS = [
     priority: 88,
     ruleFormat: 'markdown',
     skillFormat: 'markdown',
-    commandFormat: 'markdown',
+    commandFormat: null,
     subagentFormat: 'md',
   },
 ];
@@ -345,6 +345,30 @@ const SKILL_TRANSFORMERS = {
     return { format: 'reference', files: outputs };
   },
 
+  copilot(skillFiles, opts) {
+    // Copilot 不支持独立 skills 目录，合并为 Markdown 段落
+    let content = '';
+    for (const file of skillFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      const skillName = inferSkillName(file);
+      const description = parseFrontmatter(raw).description || extractDescription(raw) || skillName;
+      content += `### ${skillName}\n\n> ${description}\n\n${extractBody(raw)}\n\n`;
+    }
+    return { format: 'merged-section', sectionName: 'Skills', content };
+  },
+
+  codex(skillFiles, opts) {
+    // Codex CLI 不支持独立 skills 目录，合并为 Markdown 段落
+    let content = '';
+    for (const file of skillFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      const skillName = inferSkillName(file);
+      const description = parseFrontmatter(raw).description || extractDescription(raw) || skillName;
+      content += `### ${skillName}\n\n> ${description}\n\n${extractBody(raw)}\n\n`;
+    }
+    return { format: 'merged-section', sectionName: 'Skills', content };
+  },
+
   qoder(skillFiles, opts) {
     const outputs = [];
     for (const file of skillFiles) {
@@ -492,16 +516,15 @@ const COMMAND_TRANSFORMERS = {
   },
 
   augment(commandFiles, opts) {
-    const outputs = [];
+    // Augment 不支持独立 commands 目录，合并为 Markdown 段落
+    let content = '';
     for (const file of commandFiles) {
       const raw = fs.readFileSync(file.path, 'utf-8');
       const cmdName = inferCommandName(file);
-      const existingFrontmatter = parseFrontmatter(raw);
-      const description = existingFrontmatter.description || extractDescription(raw) || cmdName;
-      let content = `---\nname: ${cmdName}\ndescription: ${description}\ntrigger_type: manual\n---\n\n${extractBody(raw)}`;
-      outputs.push({ relativePath: `.augment/skills/${cmdName}/SKILL.md`, content, source: file.path });
+      const description = parseFrontmatter(raw).description || extractDescription(raw) || cmdName;
+      content += `### ${cmdName}\n\n> ${description}\n\n${extractBody(raw)}\n\n`;
     }
-    return { format: 'directory', files: outputs };
+    return { format: 'merged-section', sectionName: 'Commands', content };
   },
 
   copilot(commandFiles, opts) {
@@ -928,6 +951,30 @@ function inferAgentName(file) {
   return file.name.replace(/\.md$/, '') || 'unknown';
 }
 
+/**
+ * 将 command 内容转为 skill 格式输出（用于不支持 commands 目录的工具）
+ * 根据工具类型决定输出路径和 frontmatter 格式
+ */
+function buildCommandAsSkill(toolId, cmdName, description, body) {
+  const skillPaths = {
+    'claude-code': `.claude/skills/cmd-${cmdName}/SKILL.md`,
+    augment: `.augment/skills/cmd-${cmdName}/SKILL.md`,
+  };
+  const relativePath = skillPaths[toolId] || `.harness/skills/cmd-${cmdName}/SKILL.md`;
+
+  // 根据工具类型构建不同的 frontmatter
+  let frontmatter;
+  if (toolId === 'claude-code') {
+    frontmatter = `---\nname: cmd-${cmdName}\ndescription: ${description}\ntrigger_type: manual\n---`;
+  } else if (toolId === 'augment') {
+    frontmatter = `---\nname: cmd-${cmdName}\ndescription: ${description}\n---`;
+  } else {
+    frontmatter = `---\nname: cmd-${cmdName}\ndescription: ${description}\nalwaysApply: false\nenabled: true\n---`;
+  }
+
+  return { relativePath, content: `${frontmatter}\n\n${body}` };
+}
+
 /**
  * 从 frontmatter 和原始内容构建 agent 元数据
  * 统一提取 name/description/tools/model/agentMode/enabled/enabledAutoRun/maxTurns/scope/safetyLevel
@@ -1683,10 +1730,13 @@ export async function runInit(projectDir, options = {}) {
         // 不支持独立 skills 的工具：合并到 rules 输出
         console.log(`⚡ 合并技能到规则 (${allSkills.length} 个)...`);
         const skillMerged = transformSkills(allSkills, tool.id, transformOpts);
-        if (skillMerged.files && skillMerged.files.length > 0) {
-          // 将 skills 内容合并到 rules 的单文件中
-          const rulesOutput = outputs.find(o => o.relativePath === getRulesOutputPath(tool.id));
-          if (rulesOutput) {
+        const rulesOutput = outputs.find(o => o.relativePath === getRulesOutputPath(tool.id));
+        if (rulesOutput) {
+          if (skillMerged.format === 'merged-section') {
+            // merged-section 格式：直接拼接 sectionName + content
+            rulesOutput.content += `\n---\n\n## ${skillMerged.sectionName}\n\n${skillMerged.content}`;
+          } else if (skillMerged.files && skillMerged.files.length > 0) {
+            // directory/reference 格式：逐个拼接 body 内容
             rulesOutput.content += '\n---\n\n## Skills\n\n';
             for (const sf of skillMerged.files) {
               rulesOutput.content += sf.content + '\n\n';
@@ -1702,21 +1752,29 @@ export async function runInit(projectDir, options = {}) {
         console.log(`🔧 注入命令 (${allCommandFiles.length} 个)...`);
         outputs.push(...transformCommands(allCommandFiles, tool.id, transformOpts).files);
       } else {
-        // 不支持独立 commands 的工具：合并到 rules 输出
-        console.log(`🔧 合并命令到规则 (${allCommandFiles.length} 个)...`);
+        // 不支持独立 commands 的工具
+        console.log(`🔧 合并命令 (${allCommandFiles.length} 个)...`);
         const cmdResult = transformCommands(allCommandFiles, tool.id, transformOpts);
         if (cmdResult.format === 'merged-section') {
+          // merged-section：尝试合并到 rules 单文件
           const rulesOutput = outputs.find(o => o.relativePath === getRulesOutputPath(tool.id));
           if (rulesOutput) {
             rulesOutput.content += `\n---\n\n## ${cmdResult.sectionName}\n\n${cmdResult.content}`;
-          }
-        } else if (cmdResult.files && cmdResult.files.length > 0) {
-          const rulesOutput = outputs.find(o => o.relativePath === getRulesOutputPath(tool.id));
-          if (rulesOutput) {
-            for (const cf of cmdResult.files) {
-              rulesOutput.content += `\n---\n\n## Command Checks\n\n${cf.content}`;
+          } else {
+            // rules 是 directory 格式，无法合并到单文件 → 转为独立 skill 文件输出
+            console.log(`    📎 命令转存为技能文件...`);
+            for (const file of allCommandFiles) {
+              const raw = fs.readFileSync(file.path, 'utf-8');
+              const cmdName = inferCommandName(file);
+              const description = parseFrontmatter(raw).description || extractDescription(raw) || cmdName;
+              const body = extractBody(raw);
+              const cmdAsSkill = buildCommandAsSkill(tool.id, cmdName, description, body);
+              outputs.push(cmdAsSkill);
             }
           }
+        } else if (cmdResult.files && cmdResult.files.length > 0) {
+          // directory 格式：直接作为独立文件输出
+          outputs.push(...cmdResult.files);
         }
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsharness",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Harness Engineering - AI 编程行为工程化管控系统。将 rules/skills/commands/agents 四桶一键注入到 CodeBuddy、Cursor、Copilot、Claude Code 等 AI 工具中。",
   "main": "lib/index.mjs",
   "bin": {