@blueking/bkui-knowledge 0.0.1-beta.12 → 0.0.1-beta.13

package/bin/bkui-knowledge.js

@@ -208,6 +208,35 @@ function scanSkillDir(dirPath, relativePath) {
   return results;
 }
 
+/**
+ * 重写 SKILL.md 的 frontmatter 以符合 Claude Code 格式要求
+ * Claude Code 要求 name 字段必须是小写字母、数字和连字符
+ * @param {string} content - 原始内容
+ * @param {string} skillId - skill ID (用作 name)
+ * @param {object} skill - manifest 中的 skill 信息
+ * @returns {string} 重写后的内容
+ */
+function rewriteFrontmatterForClaudeCode(content, skillId, skill) {
+  // 解析 frontmatter
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!frontmatterMatch) {
+    // 没有 frontmatter，添加一个
+    return `---\nname: ${skillId}\ndescription: ${skill.description || skill.name}\n---\n\n${content}`;
+  }
+
+  const frontmatter = frontmatterMatch[1];
+  const body = frontmatterMatch[2];
+
+  // 提取 description（从原始 frontmatter 或 skill 信息）
+  const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+  const description = descMatch ? descMatch[1].trim() : (skill.description || skill.name);
+
+  // 创建新的 Claude Code 兼容 frontmatter
+  const newFrontmatter = `---\nname: ${skillId}\ndescription: ${description}\n---`;
+
+  return `${newFrontmatter}\n${body}`;
+}
+
 /**
  * 生成 skill 的可用资源列表
  * @param {string} skillDir - skill 目录路径
@@ -267,6 +296,8 @@ function syncSkills(projectRoot, ideConfig) {
 
     // 同步推荐的 skills
     let count = 0;
+    const isClaudeCode = ideConfig.name === 'Claude Code';
+    
     for (const skillId of recommendedIds) {
       const skill = manifest.skills.items.find(s => s.id === skillId);
       if (!skill) continue;
@@ -282,7 +313,20 @@ function syncSkills(projectRoot, ideConfig) {
       const resourcesList = generateResourcesList(skillDir, skillId);
       content += resourcesList;
 
-      fs.writeFileSync(path.join(skillsDir, `${skillId}.md`), content, 'utf-8');
+      if (isClaudeCode) {
+        // Claude Code 要求每个 skill 在独立子目录，文件名为 SKILL.md
+        // 并且 name 字段必须是小写字母、数字和连字符
+        const skillSubDir = path.join(skillsDir, skillId);
+        fs.mkdirSync(skillSubDir, { recursive: true });
+        
+        // 重写 frontmatter 以符合 Claude Code 格式要求
+        content = rewriteFrontmatterForClaudeCode(content, skillId, skill);
+        
+        fs.writeFileSync(path.join(skillSubDir, 'SKILL.md'), content, 'utf-8');
+      } else {
+        // Cursor / CodeBuddy 直接放在 skills 目录
+        fs.writeFileSync(path.join(skillsDir, `${skillId}.md`), content, 'utf-8');
+      }
 
       log(`  ✓ ${skillId}`);
       count++;
@@ -315,22 +359,32 @@ async function startMcpServer() {
       // 从 initialize 请求中提取项目路径
       const params = message.params || {};
 
-      // 尝试从 rootUri 或 workspaceFolders 获取项目路径
+      // 打印 initialize 参数用于调试
+      log(`initialize params: ${JSON.stringify({ rootUri: params.rootUri, workspaceFolders: params.workspaceFolders, roots: params.roots })}`);
+
+      // 尝试从 rootUri 或 workspaceFolders 或 roots 获取项目路径
       if (params.rootUri) {
         mcpRootUri = uriToPath(params.rootUri);
-        log(`从 MCP initialize 获取项目路径: ${mcpRootUri}`);
+        log(`从 MCP initialize.rootUri 获取项目路径: ${mcpRootUri}`);
       } else if (params.workspaceFolders && params.workspaceFolders.length > 0) {
         mcpRootUri = uriToPath(params.workspaceFolders[0].uri);
-        log(`从 MCP workspaceFolders 获取项目路径: ${mcpRootUri}`);
+        log(`从 MCP initialize.workspaceFolders 获取项目路径: ${mcpRootUri}`);
+      } else if (params.roots && params.roots.length > 0) {
+        // Claude Code 使用 roots 字段
+        mcpRootUri = uriToPath(params.roots[0].uri);
+        log(`从 MCP initialize.roots 获取项目路径: ${mcpRootUri}`);
       }
 
       // 延迟同步 skills（在获取到项目路径后）
-      if (!skillsSynced && mcpRootUri) {
+      // 如果没有获取到 mcpRootUri，回退到 cwd
+      if (!skillsSynced) {
         const projectRoot = getProjectRoot();
         const ideConfig = getIDEConfig();
-        log(`[延迟同步] 工作目录: ${projectRoot}, IDE: ${ideConfig.name}`);
-        syncSkills(projectRoot, ideConfig);
-        skillsSynced = true;
+        if (projectRoot) {
+          log(`[延迟同步] 工作目录: ${projectRoot}, IDE: ${ideConfig.name}`);
+          syncSkills(projectRoot, ideConfig);
+          skillsSynced = true;
+        }
       }
 
       return {

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@blueking/bkui-knowledge",
-  "version": "0.0.1-beta.12",
+  "version": "0.0.1-beta.13",
   "description": "蓝鲸前端知识库 MCP 服务 - 自动同步 skills，支持 Cursor/CodeBuddy",
   "main": "server/mcp-core.js",
   "bin": {
-    "bkui-knowledge": "./bin/bkui-knowledge.js"
+    "bkui-knowledge": "./bin/bkui-knowledge.js",
+    "bkui-knowledge-mcp": "./bin/bkui-knowledge.js"
   },
   "files": [
     "bin/",