@templmf/temp-solf-lmf 0.0.40 → 0.0.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@templmf/temp-solf-lmf",
-  "version": "0.0.40",
+  "version": "0.0.42",
   "description": "",
   "main": "index.js",
   "scripts": {

package/skill-mcp/README.md

@@ -0,0 +1,74 @@
+# Skills MCP
+
+让 Roo Code 通过 MCP 工具管理和读取 Skills，彻底解决 Windows 路径环境变量问题。
+
+## 安装
+
+```bash
+# 1. 进入项目目录
+cd skills-mcp
+
+# 2. 安装依赖
+npm install
+
+# 3. 编译 TypeScript
+npm run build
+```
+
+## 配置到 Roo Code
+
+在 Roo Code 的 MCP 配置文件中添加（`%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json`）：
+
+```json
+{
+  "mcpServers": {
+    "skills-mcp": {
+      "command": "node",
+      "args": ["C:\\path\\to\\skills-mcp\\dist\\index.js"],
+      "env": {
+        "SKILLS_EXTRA_DIRS": "C:\\Users\\你的用户名\\.roo\\skills"
+      }
+    }
+  }
+}
+```
+
+> `SKILLS_EXTRA_DIRS` 是可选的，用于追加额外的 Skills 目录，多个目录用分号 `;` 分隔。
+
+## 可用工具
+
+| 工具名 | 说明 | 参数 |
+|--------|------|------|
+| `list_skills` | 列出所有可用 Skills | 无 |
+| `read_skill` | 读取指定 Skill 的完整内容 | `name`: skill名称 |
+| `search_skills` | 模糊搜索 Skills（匹配名称或描述） | `query`: 搜索词 |
+| `list_skill_files` | 列出 Skill 目录下的所有附属文件 | `name`: skill名称 |
+
+## Skills 路径查找顺序
+
+1. `%USERPROFILE%\.roo\skills\`（全局，自动解析，不再依赖环境变量字面量）
+2. `<当前工作目录>\.roo\skills\`（项目级，优先级更高，会覆盖同名全局 Skill）
+3. `SKILLS_EXTRA_DIRS` 环境变量中指定的路径（补充）
+
+## 与 Slash Commands 配合使用
+
+在 `.roo\commands\skill.md` 中：
+
+```markdown
+---
+description: 调用指定 Skill 的指引来完成任务
+argument-hint: <skill-name>
+---
+
+请使用 MCP 工具 read_skill 读取名为 {参数} 的 Skill 内容，然后按其指引执行任务。
+```
+
+在 `.roo\commands\skills.md` 中：
+
+```markdown
+---
+description: 列出所有可用的 Skills
+---
+
+请使用 MCP 工具 list_skills 列出所有可用的 Skills。
+```

package/skill-mcp/index.ts

@@ -0,0 +1,352 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import matter from "gray-matter";
+
+// ──────────────────────────────────────────────
+// 路径解析：支持项目级 + 全局两个 Skills 目录
+// ──────────────────────────────────────────────
+
+function getSkillDirs(): string[] {
+  const dirs: string[] = [];
+
+  // 全局路径：%USERPROFILE%\.roo\skills （Windows）或 ~/.roo/skills（Linux/macOS）
+  const globalDir = path.join(os.homedir(), ".roo", "skills");
+  if (fs.existsSync(globalDir)) dirs.push(globalDir);
+
+  // 项目路径：cwd()\.roo\skills
+  const projectDir = path.join(process.cwd(), ".roo", "skills");
+  if (fs.existsSync(projectDir) && projectDir !== globalDir) {
+    dirs.push(projectDir);
+  }
+
+  // 支持通过环境变量追加自定义路径，多个路径用分号分隔
+  // 例：SKILLS_EXTRA_DIRS=C:\my-skills;D:\shared-skills
+  if (process.env.SKILLS_EXTRA_DIRS) {
+    for (const d of process.env.SKILLS_EXTRA_DIRS.split(";")) {
+      const trimmed = d.trim();
+      if (trimmed && fs.existsSync(trimmed) && !dirs.includes(trimmed)) {
+        dirs.push(trimmed);
+      }
+    }
+  }
+
+  return dirs;
+}
+
+// ──────────────────────────────────────────────
+// Skill 数据结构
+// ──────────────────────────────────────────────
+
+interface SkillMeta {
+  name: string;
+  description: string;
+  skillDir: string;   // SKILL.md 所在文件夹
+  skillFile: string;  // SKILL.md 完整路径
+  source: string;     // "global" | "project" | 自定义路径标签
+}
+
+// ──────────────────────────────────────────────
+// 核心：扫描所有 Skills
+// ──────────────────────────────────────────────
+
+function scanSkills(): SkillMeta[] {
+  const skillDirs = getSkillDirs();
+  const skillMap = new Map<string, SkillMeta>(); // name → meta，项目级覆盖全局
+
+  for (const baseDir of skillDirs) {
+    // 判断来源标签
+    const globalDir = path.join(os.homedir(), ".roo", "skills");
+    const projectDir = path.join(process.cwd(), ".roo", "skills");
+    let source = "custom";
+    if (baseDir === globalDir) source = "global";
+    else if (baseDir === projectDir) source = "project";
+
+    if (!fs.existsSync(baseDir)) continue;
+
+    const entries = fs.readdirSync(baseDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+
+      const skillDir = path.join(baseDir, entry.name);
+      const skillFile = path.join(skillDir, "SKILL.md");
+      if (!fs.existsSync(skillFile)) continue;
+
+      try {
+        const raw = fs.readFileSync(skillFile, "utf-8");
+        const { data } = matter(raw);
+
+        const name = (data.name as string | undefined)?.trim() ?? entry.name;
+        const description = (data.description as string | undefined)?.trim() ?? "";
+
+        // 项目级 > 全局（后扫描的覆盖先扫描的，skillDirs 里项目在后）
+        skillMap.set(name, { name, description, skillDir, skillFile, source });
+      } catch {
+        // 解析失败跳过
+      }
+    }
+  }
+
+  return Array.from(skillMap.values()).sort((a, b) =>
+    a.name.localeCompare(b.name)
+  );
+}
+
+// ──────────────────────────────────────────────
+// 工具函数
+// ──────────────────────────────────────────────
+
+/** 列出所有文件（含子目录），返回相对路径列表 */
+function listFilesRecursive(dir: string, base: string = dir): string[] {
+  const result: string[] = [];
+  if (!fs.existsSync(dir)) return result;
+
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    const rel = path.relative(base, full);
+    if (entry.isDirectory()) {
+      result.push(...listFilesRecursive(full, base));
+    } else {
+      result.push(rel);
+    }
+  }
+  return result;
+}
+
+/** 模糊匹配：检查 haystack 是否包含 needle 的所有字符（按序） */
+function fuzzyMatch(needle: string, haystack: string): boolean {
+  needle = needle.toLowerCase();
+  haystack = haystack.toLowerCase();
+  let i = 0;
+  for (const ch of haystack) {
+    if (ch === needle[i]) i++;
+    if (i === needle.length) return true;
+  }
+  return false;
+}
+
+// ──────────────────────────────────────────────
+// MCP Server
+// ──────────────────────────────────────────────
+
+const server = new Server(
+  { name: "skills-mcp", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+// 注册工具列表
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "list_skills",
+      description:
+        "列出所有可用的 Skills（来自全局 ~/.roo/skills 和项目 .roo/skills）",
+      inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+      },
+    },
+    {
+      name: "read_skill",
+      description: "读取指定 Skill 的完整 SKILL.md 内容",
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: {
+            type: "string",
+            description: "Skill 名称（目录名或 frontmatter 中的 name）",
+          },
+        },
+        required: ["name"],
+      },
+    },
+    {
+      name: "search_skills",
+      description: "模糊搜索 Skills，匹配名称或描述",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "搜索关键词",
+          },
+        },
+        required: ["query"],
+      },
+    },
+    {
+      name: "list_skill_files",
+      description: "列出指定 Skill 目录下的所有附属文件（脚本、模板等）",
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: {
+            type: "string",
+            description: "Skill 名称",
+          },
+        },
+        required: ["name"],
+      },
+    },
+  ],
+}));
+
+// 处理工具调用
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  // ── list_skills ──
+  if (name === "list_skills") {
+    const skills = scanSkills();
+    if (skills.length === 0) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "未找到任何 Skill。\n\n请检查以下目录是否存在 SKILL.md 文件：\n" +
+              getSkillDirs().map((d) => `  - ${d}`).join("\n"),
+          },
+        ],
+      };
+    }
+
+    const rows = skills.map((s) => {
+      const desc = s.description.length > 80
+        ? s.description.slice(0, 77) + "..."
+        : s.description;
+      return `| \`${s.name}\` | ${desc} | ${s.source} |`;
+    });
+
+    const text =
+      `## 可用 Skills（共 ${skills.length} 个）\n\n` +
+      `| 名称 | 描述 | 来源 |\n` +
+      `|------|------|------|\n` +
+      rows.join("\n");
+
+    return { content: [{ type: "text", text }] };
+  }
+
+  // ── read_skill ──
+  if (name === "read_skill") {
+    const skillName = (args as { name: string }).name.trim();
+    const skills = scanSkills();
+    const skill = skills.find(
+      (s) => s.name === skillName || s.skillDir.endsWith(path.sep + skillName)
+    );
+
+    if (!skill) {
+      const available = skills.map((s) => `\`${s.name}\``).join(", ");
+      return {
+        content: [
+          {
+            type: "text",
+            text: `未找到 Skill \`${skillName}\`。\n\n可用的 Skills：${available || "（无）"}`,
+          },
+        ],
+      };
+    }
+
+    const content = fs.readFileSync(skill.skillFile, "utf-8");
+    return {
+      content: [
+        {
+          type: "text",
+          text: `## Skill: ${skill.name}\n**来源**: ${skill.source} (${skill.skillFile})\n\n---\n\n${content}`,
+        },
+      ],
+    };
+  }
+
+  // ── search_skills ──
+  if (name === "search_skills") {
+    const query = (args as { query: string }).query.trim();
+    const skills = scanSkills();
+
+    const matched = skills.filter(
+      (s) =>
+        fuzzyMatch(query, s.name) ||
+        s.name.toLowerCase().includes(query.toLowerCase()) ||
+        s.description.toLowerCase().includes(query.toLowerCase())
+    );
+
+    if (matched.length === 0) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `未找到匹配 "${query}" 的 Skill。`,
+          },
+        ],
+      };
+    }
+
+    const rows = matched.map((s) => {
+      const desc = s.description.length > 100
+        ? s.description.slice(0, 97) + "..."
+        : s.description;
+      return `| \`${s.name}\` | ${desc} | ${s.source} |`;
+    });
+
+    const text =
+      `## 搜索结果：${matched.length} 个匹配 "${query}"\n\n` +
+      `| 名称 | 描述 | 来源 |\n` +
+      `|------|------|------|\n` +
+      rows.join("\n");
+
+    return { content: [{ type: "text", text }] };
+  }
+
+  // ── list_skill_files ──
+  if (name === "list_skill_files") {
+    const skillName = (args as { name: string }).name.trim();
+    const skills = scanSkills();
+    const skill = skills.find(
+      (s) => s.name === skillName || s.skillDir.endsWith(path.sep + skillName)
+    );
+
+    if (!skill) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `未找到 Skill \`${skillName}\`。`,
+          },
+        ],
+      };
+    }
+
+    const files = listFilesRecursive(skill.skillDir);
+    const text =
+      `## Skill \`${skill.name}\` 的附属文件\n` +
+      `**路径**: ${skill.skillDir}\n\n` +
+      (files.length === 0
+        ? "_（无附属文件）_"
+        : files.map((f) => `- \`${f}\``).join("\n"));
+
+    return { content: [{ type: "text", text }] };
+  }
+
+  return {
+    content: [{ type: "text", text: `未知工具: ${name}` }],
+    isError: true,
+  };
+});
+
+// 启动
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Skills MCP server started");
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/skill-mcp/package (1).json

@@ -0,0 +1,19 @@
+{
+  "name": "skills-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for managing and reading Roo Code Skills",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "gray-matter": "^4.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/skill-mcp/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}