autosnippet 3.0.1 → 3.0.2

package/lib/external/mcp/handlers/skill.js

@@ -42,9 +42,7 @@ function _getProjectSkillsDir() {
  */
 function _parseSkillMeta(skillName, baseDir = SKILLS_DIR) {
   try {
-    const content = fs.readFileSync(
-      path.join(baseDir, skillName, 'SKILL.md'), 'utf8',
-    );
+    const content = fs.readFileSync(path.join(baseDir, skillName, 'SKILL.md'), 'utf8');
     const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
     const meta = { description: skillName, createdBy: null, createdAt: null };
     if (fmMatch) {
@@ -53,12 +51,17 @@ function _parseSkillMeta(skillName, baseDir = SKILLS_DIR) {
       if (descMatch) {
         const desc = descMatch[1].trim();
         const firstSentence = desc.split(/\.\s/)[0];
-        meta.description = firstSentence.length < desc.length ? `${firstSentence}.` : desc.substring(0, 120);
+        meta.description =
+          firstSentence.length < desc.length ? `${firstSentence}.` : desc.substring(0, 120);
       }
       const cbMatch = fm.match(/^createdBy:\s*(.+?)$/m);
-      if (cbMatch) meta.createdBy = cbMatch[1].trim();
+      if (cbMatch) {
+        meta.createdBy = cbMatch[1].trim();
+      }
       const caMatch = fm.match(/^createdAt:\s*(.+?)$/m);
-      if (caMatch) meta.createdAt = caMatch[1].trim();
+      if (caMatch) {
+        meta.createdAt = caMatch[1].trim();
+      }
     }
     return meta;
   } catch {
@@ -83,6 +86,10 @@ const SKILL_USE_CASES = {
   'autosnippet-reference-swift': 'Swift 语言最佳实践参考',
   'autosnippet-reference-objc': 'Objective-C 语言最佳实践参考',
   'autosnippet-reference-jsts': 'JavaScript/TypeScript 语言最佳实践参考',
+  'autosnippet-reference-python': 'Python 语言最佳实践参考',
+  'autosnippet-reference-java': 'Java 语言最佳实践参考',
+  'autosnippet-reference-kotlin': 'Kotlin 语言最佳实践参考',
+  'autosnippet-reference-go': 'Go 语言最佳实践参考',
 };
 
 // ═══════════════════════════════════════════════════════════
@@ -99,23 +106,43 @@ export function listSkills() {
     const skillMap = new Map();
 
     // 内置 Skills
-    const builtinDirs = fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
-      .filter(d => d.isDirectory()).map(d => d.name);
+    const builtinDirs = fs
+      .readdirSync(SKILLS_DIR, { withFileTypes: true })
+      .filter((d) => d.isDirectory())
+      .map((d) => d.name);
     for (const name of builtinDirs) {
       const meta = _parseSkillMeta(name, SKILLS_DIR);
-      skillMap.set(name, { name, source: 'builtin', summary: meta.description, createdBy: null, createdAt: null, useCase: SKILL_USE_CASES[name] || null });
+      skillMap.set(name, {
+        name,
+        source: 'builtin',
+        summary: meta.description,
+        createdBy: null,
+        createdAt: null,
+        useCase: SKILL_USE_CASES[name] || null,
+      });
     }
 
     // 项目级 Skills（覆盖同名内置）
     try {
       const projectSkillsDir = _getProjectSkillsDir();
-      const projectDirs = fs.readdirSync(projectSkillsDir, { withFileTypes: true })
-        .filter(d => d.isDirectory()).map(d => d.name);
+      const projectDirs = fs
+        .readdirSync(projectSkillsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name);
       for (const name of projectDirs) {
         const meta = _parseSkillMeta(name, projectSkillsDir);
-        skillMap.set(name, { name, source: 'project', summary: meta.description, createdBy: meta.createdBy, createdAt: meta.createdAt, useCase: SKILL_USE_CASES[name] || null });
+        skillMap.set(name, {
+          name,
+          source: 'project',
+          summary: meta.description,
+          createdBy: meta.createdBy,
+          createdAt: meta.createdAt,
+          useCase: SKILL_USE_CASES[name] || null,
+        });
       }
-    } catch { /* no project skills */ }
+    } catch {
+      /* no project skills */
+    }
 
     const skills = [...skillMap.values()].sort((a, b) => a.name.localeCompare(b.name));
 
@@ -126,7 +153,9 @@ export function listSkills() {
         const snapshot = global._signalCollector.getSnapshot();
         suggestionCount = snapshot?.lastResult?.newSuggestions || 0;
       }
-    } catch { /* silent */ }
+    } catch {
+      /* silent */
+    }
 
     return JSON.stringify({
       success: true,
@@ -180,7 +209,7 @@ export function loadSkill(_ctx, args) {
     if (section) {
       const sectionRe = new RegExp(
         `^##\\s+.*${section.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}.*$\\n([\\s\\S]*?)(?=^##\\s|$)`,
-        'mi',
+        'mi'
       );
       const match = content.match(sectionRe);
       if (match) {
@@ -207,8 +236,16 @@ export function loadSkill(_ctx, args) {
   } catch {
     // 列出所有可用 Skills
     const available = new Set();
-    try { fs.readdirSync(SKILLS_DIR, { withFileTypes: true }).filter(d => d.isDirectory()).forEach(d => available.add(d.name)); } catch {}
-    try { fs.readdirSync(_getProjectSkillsDir(), { withFileTypes: true }).filter(d => d.isDirectory()).forEach(d => available.add(d.name)); } catch {}
+    try {
+      fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .forEach((d) => available.add(d.name));
+    } catch {}
+    try {
+      fs.readdirSync(_getProjectSkillsDir(), { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .forEach((d) => available.add(d.name));
+    } catch {}
 
     return JSON.stringify({
       success: false,
@@ -234,7 +271,14 @@ export function loadSkill(_ctx, args) {
  * @returns {string} JSON envelope
  */
 export function createSkill(_ctx, args) {
-  const { name, description, content, overwrite = false, createdBy = 'external-ai', title } = args || {};
+  const {
+    name,
+    description,
+    content,
+    overwrite = false,
+    createdBy = 'external-ai',
+    title,
+  } = args || {};
 
   // ── 参数校验 ──
   if (!name || !description || !content) {
@@ -288,22 +332,23 @@ export function createSkill(_ctx, args) {
     fs.mkdirSync(skillDir, { recursive: true });
 
     // 自动推断 title: 优先使用传入参数，否则从 content 的第一个 # heading 提取
-    const resolvedTitle = title || (() => {
-      const m = (content || '').match(/^#\s+(.+)/m);
-      return m ? m[1].trim() : '';
-    })();
+    const resolvedTitle =
+      title ||
+      (() => {
+        const m = (content || '').match(/^#\s+(.+)/m);
+        return m ? m[1].trim() : '';
+      })();
 
-    const fmLines = [
-      '---',
-      `name: ${name}`,
-    ];
-    if (resolvedTitle) fmLines.push(`title: "${resolvedTitle.replace(/"/g, '\\"')}"`);
+    const fmLines = ['---', `name: ${name}`];
+    if (resolvedTitle) {
+      fmLines.push(`title: "${resolvedTitle.replace(/"/g, '\\"')}"`);
+    }
     fmLines.push(
       `description: ${description}`,
       `createdBy: ${createdBy}`,
       `createdAt: ${new Date().toISOString()}`,
       '---',
-      '',
+      ''
     );
     const frontmatter = fmLines.join('\n');
 
@@ -323,7 +368,9 @@ export function createSkill(_ctx, args) {
     if (global._signalCollector) {
       global._signalCollector.removePendingSuggestion(name);
     }
-  } catch { /* silent */ }
+  } catch {
+    /* silent */
+  }
 
   return JSON.stringify({
     success: true,
@@ -346,17 +393,20 @@ export function createSkill(_ctx, args) {
 function _regenerateEditorIndex() {
   try {
     // 扫描项目级 Skills
-    let projectSkills = [];
+    const projectSkills = [];
     const projectSkillsDir = _getProjectSkillsDir();
     try {
-      const dirs = fs.readdirSync(projectSkillsDir, { withFileTypes: true })
-        .filter(d => d.isDirectory())
-        .map(d => d.name);
+      const dirs = fs
+        .readdirSync(projectSkillsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name);
       for (const name of dirs) {
         const meta = _parseSkillMeta(name, projectSkillsDir);
         projectSkills.push({ name, summary: meta.description });
       }
-    } catch { /* no project skills dir */ }
+    } catch {
+      /* no project skills dir */
+    }
 
     const projectRoot = _getProjectRoot();
     const rulesDir = path.join(projectRoot, '.cursor', 'rules');
@@ -364,14 +414,16 @@ function _regenerateEditorIndex() {
     if (projectSkills.length === 0) {
       // 没有项目级 Skills 时，删除索引文件（如果存在）
       const indexPath = path.join(rulesDir, 'autosnippet-skills.mdc');
-      try { fs.unlinkSync(indexPath); } catch { /* not exists */ }
+      try {
+        fs.unlinkSync(indexPath);
+      } catch {
+        /* not exists */
+      }
       return { success: true, skillCount: 0 };
     }
 
     // 生成 .mdc 内容
-    const skillLines = projectSkills
-      .map(s => `- **${s.name}**: ${s.summary}`)
-      .join('\n');
+    const skillLines = projectSkills.map((s) => `- **${s.name}**: ${s.summary}`).join('\n');
 
     const mdcContent = [
       '---',
@@ -505,7 +557,10 @@ export function updateSkill(_ctx, args) {
   if (!description && !content) {
     return JSON.stringify({
       success: false,
-      error: { code: 'NOTHING_TO_UPDATE', message: 'At least one of description or content must be provided.' },
+      error: {
+        code: 'NOTHING_TO_UPDATE',
+        message: 'At least one of description or content must be provided.',
+      },
     });
   }
 
@@ -563,14 +618,16 @@ export function updateSkill(_ctx, args) {
 
     // 重建 frontmatter
     const fmLines = ['---', `name: ${name}`];
-    if (title) fmLines.push(`title: ${title}`);
+    if (title) {
+      fmLines.push(`title: ${title}`);
+    }
     fmLines.push(
       `description: ${newDesc}`,
       `createdBy: ${createdBy}`,
       `createdAt: ${createdAt}`,
       `updatedAt: ${new Date().toISOString()}`,
       '---',
-      '',
+      ''
     );
 
     pathGuard.assertProjectWriteSafe(path.join(projectSkillsDir, name));
@@ -590,7 +647,9 @@ export function updateSkill(_ctx, args) {
     data: {
       skillName: name,
       updated: true,
-      fieldsUpdated: [description ? 'description' : null, content ? 'content' : null].filter(Boolean),
+      fieldsUpdated: [description ? 'description' : null, content ? 'content' : null].filter(
+        Boolean
+      ),
       editorIndex: indexResult,
       hint: `Skill "${name}" updated. Use autosnippet_skill({ operation: "load", name: "${name}" }) to verify content.`,
     },
@@ -636,9 +695,21 @@ export async function suggestSkills(ctx) {
  */
 function _getRelatedSkills(skillName) {
   const relations = {
-    'autosnippet-coldstart': ['autosnippet-analysis', 'autosnippet-candidates', 'autosnippet-structure'],
-    'autosnippet-analysis': ['autosnippet-candidates', 'autosnippet-coldstart', 'autosnippet-structure'],
-    'autosnippet-candidates': ['autosnippet-analysis', 'autosnippet-create', 'autosnippet-lifecycle'],
+    'autosnippet-coldstart': [
+      'autosnippet-analysis',
+      'autosnippet-candidates',
+      'autosnippet-structure',
+    ],
+    'autosnippet-analysis': [
+      'autosnippet-candidates',
+      'autosnippet-coldstart',
+      'autosnippet-structure',
+    ],
+    'autosnippet-candidates': [
+      'autosnippet-analysis',
+      'autosnippet-create',
+      'autosnippet-lifecycle',
+    ],
     'autosnippet-create': ['autosnippet-candidates', 'autosnippet-lifecycle'],
     'autosnippet-guard': ['autosnippet-recipes', 'autosnippet-analysis'],
     'autosnippet-recipes': ['autosnippet-guard', 'autosnippet-structure', 'autosnippet-concepts'],
@@ -649,6 +720,10 @@ function _getRelatedSkills(skillName) {
     'autosnippet-reference-swift': ['autosnippet-coldstart', 'autosnippet-analysis'],
     'autosnippet-reference-objc': ['autosnippet-coldstart', 'autosnippet-analysis'],
     'autosnippet-reference-jsts': ['autosnippet-coldstart', 'autosnippet-analysis'],
+    'autosnippet-reference-python': ['autosnippet-coldstart', 'autosnippet-analysis'],
+    'autosnippet-reference-java': ['autosnippet-coldstart', 'autosnippet-analysis'],
+    'autosnippet-reference-kotlin': ['autosnippet-coldstart', 'autosnippet-analysis'],
+    'autosnippet-reference-go': ['autosnippet-coldstart', 'autosnippet-analysis'],
   };
   return relations[skillName] || [];
 }