skill-auto-loader-hook-paperfly777 0.1.0 → 0.1.2

package/README.md

@@ -55,14 +55,7 @@ openclaw plugins install skill-auto-loader-hook-paperfly777
 
 ## 发布方式
 
-发布前先在插件目录执行：
-
-```bash
-npm install
-npm run build
-```
-
-然后登录 npm 并发布：
+发布前在插件目录执行：
 
 ```bash
 npm login
@@ -72,13 +65,13 @@ npm publish --access public
 发布成功后，就可以用：
 
 ```bash
-openclaw plugins install @applesay/skill-auto-loader-hook
+openclaw plugins install skill-auto-loader-hook-paperfly777
 ```
 
 说明：
 
 1. 当前包名我先给你定成了 `skill-auto-loader-hook-paperfly777`，如果你后面有自己的 npm scope，再改 `package.json` 即可。
-2. `openclaw.plugin.json` 已经指向 `dist/index.js`，所以发布前必须先构建。
+2. 该插件按 OpenClaw 官方方式，通过 `package.json -> openclaw.extensions -> index.ts` 暴露入口。
 
 ## 配置方式
 

package/index.ts

@@ -0,0 +1,457 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { definePluginEntry } from "openclaw/plugin-sdk/core";
+
+const PLUGIN_ID = "skill-auto-loader-hook";
+
+type RoutingRule = {
+  id: string;
+  enabled?: boolean;
+  description?: string;
+  keywords?: string[];
+  allKeywords?: string[];
+  regexes?: string[];
+  preferSkills?: string[];
+  excludeSkills?: string[];
+  scopeNote?: string;
+  prompt?: string;
+};
+
+type RouterFileConfig = {
+  enabled?: boolean;
+  skillsScanDirs?: string[];
+  includeSkills?: string[];
+  excludeSkills?: string[];
+  maxSkillsInPrompt?: number;
+  defaultScopeNote?: string;
+  rules?: RoutingRule[];
+};
+
+type PluginConfig = {
+  enabled?: boolean;
+  injectMode?: "prependContext" | "prependSystemContext" | "appendSystemContext";
+  routerConfigPath?: string;
+  openclawConfigPath?: string;
+};
+
+type SkillMeta = {
+  name: string;
+  description: string;
+  skillPath: string;
+};
+
+function safeString(value: unknown): string {
+  return typeof value === "string" ? value : "";
+}
+
+function expandHome(inputPath: string): string {
+  if (!inputPath) {
+    return inputPath;
+  }
+  if (inputPath.startsWith("~/")) {
+    return path.join(os.homedir(), inputPath.slice(2));
+  }
+  return inputPath;
+}
+
+function resolvePath(inputPath: string, baseDir: string): string {
+  const expanded = expandHome(inputPath);
+  if (!expanded) {
+    return expanded;
+  }
+  if (path.isAbsolute(expanded)) {
+    return expanded;
+  }
+  return path.resolve(baseDir, expanded);
+}
+
+function readJsonFile(filePath: string): any {
+  try {
+    const raw = fs.readFileSync(filePath, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+function extractTextFromContent(content: unknown): string {
+  if (typeof content === "string") {
+    return content;
+  }
+  if (Array.isArray(content)) {
+    return content
+      .map((item) => {
+        if (typeof item === "string") {
+          return item;
+        }
+        if (item && typeof item === "object") {
+          const obj = item as Record<string, unknown>;
+          if (typeof obj.text === "string") {
+            return obj.text;
+          }
+          if (typeof obj.input === "string") {
+            return obj.input;
+          }
+        }
+        return "";
+      })
+      .filter(Boolean)
+      .join("\n");
+  }
+  return "";
+}
+
+function extractLatestUserText(event: unknown): string {
+  if (!event || typeof event !== "object") {
+    return "";
+  }
+
+  const eventObj = event as Record<string, unknown>;
+  const messages = Array.isArray(eventObj.messages) ? eventObj.messages : [];
+  for (let i = messages.length - 1; i >= 0; i -= 1) {
+    const msg = messages[i];
+    if (!msg || typeof msg !== "object") {
+      continue;
+    }
+    const msgObj = msg as Record<string, unknown>;
+    if (safeString(msgObj.role) !== "user") {
+      continue;
+    }
+    const content = extractTextFromContent(msgObj.content);
+    if (content.trim()) {
+      return content.trim();
+    }
+  }
+
+  const fallbackPrompt = safeString(eventObj.userPrompt);
+  return fallbackPrompt.trim();
+}
+
+function normalizePluginConfig(api: any): PluginConfig {
+  const pluginCfg =
+    api?.config?.plugins?.entries?.[PLUGIN_ID]?.config ??
+    api?.config?.plugins?.entries?.[PLUGIN_ID] ??
+    {};
+
+  return {
+    enabled: pluginCfg.enabled !== false,
+    injectMode: pluginCfg.injectMode || "prependContext",
+    routerConfigPath:
+      safeString(pluginCfg.routerConfigPath) ||
+      path.join(__dirname, "skill-router.config.json"),
+    openclawConfigPath:
+      safeString(pluginCfg.openclawConfigPath) ||
+      path.join(os.homedir(), ".openclaw", "openclaw.json"),
+  };
+}
+
+function readRouterConfig(configPath: string, baseDir: string): RouterFileConfig {
+  const config = readJsonFile(resolvePath(configPath, baseDir));
+  if (!config || typeof config !== "object") {
+    return {};
+  }
+  return config as RouterFileConfig;
+}
+
+function getDefaultModelInfo(openclawConfigPath: string): string {
+  const cfg = readJsonFile(expandHome(openclawConfigPath));
+  if (!cfg || typeof cfg !== "object") {
+    return "未读取到 OpenClaw 默认模型配置";
+  }
+
+  const root = cfg as Record<string, unknown>;
+  const directModel = safeString(root.model);
+  const channelsModel = safeString((root.channels as Record<string, unknown> | undefined)?.model);
+
+  if (directModel) {
+    return directModel;
+  }
+  if (channelsModel) {
+    return channelsModel;
+  }
+  return "openclaw.json 中未显式配置默认模型";
+}
+
+function parseYamlLikeFrontmatter(raw: string): { name: string; description: string } {
+  const result = { name: "", description: "" };
+  if (!raw.startsWith("---")) {
+    return result;
+  }
+
+  const endIndex = raw.indexOf("\n---", 3);
+  if (endIndex === -1) {
+    return result;
+  }
+
+  const frontmatter = raw.slice(3, endIndex).split(/\r?\n/);
+  let inDescription = false;
+  const descriptionLines: string[] = [];
+
+  for (const line of frontmatter) {
+    if (line.startsWith("name:")) {
+      result.name = line.slice(5).trim();
+      inDescription = false;
+      continue;
+    }
+    if (line.startsWith("description:")) {
+      const remainder = line.slice("description:".length).trim();
+      inDescription = true;
+      if (remainder && remainder !== "|") {
+        descriptionLines.push(remainder);
+        inDescription = false;
+      }
+      continue;
+    }
+    if (inDescription) {
+      if (/^\S/.test(line)) {
+        inDescription = false;
+      } else {
+        descriptionLines.push(line.trim());
+      }
+    }
+  }
+
+  result.description = descriptionLines.join(" ").trim();
+  return result;
+}
+
+function extractHeadingFallback(raw: string): string {
+  const lines = raw.split(/\r?\n/);
+  for (const line of lines) {
+    if (line.startsWith("# ")) {
+      return line.slice(2).trim();
+    }
+  }
+  return "";
+}
+
+function extractSkillMeta(skillDir: string): SkillMeta | null {
+  const skillMdPath = path.join(skillDir, "SKILL.md");
+  if (!fs.existsSync(skillMdPath)) {
+    return null;
+  }
+
+  const raw = fs.readFileSync(skillMdPath, "utf8");
+  const fm = parseYamlLikeFrontmatter(raw);
+  const name = fm.name || path.basename(skillDir);
+  const description = fm.description || extractHeadingFallback(raw) || "无描述";
+
+  return {
+    name,
+    description,
+    skillPath: skillDir,
+  };
+}
+
+function scanInstalledSkills(scanDirs: string[]): SkillMeta[] {
+  const results: SkillMeta[] = [];
+  const visited = new Set<string>();
+
+  for (const dir of scanDirs) {
+    const resolved = expandHome(dir);
+    if (!resolved || !fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
+      continue;
+    }
+
+    const entries = fs.readdirSync(resolved, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) {
+        continue;
+      }
+      const fullPath = path.join(resolved, entry.name);
+      if (visited.has(fullPath)) {
+        continue;
+      }
+      const meta = extractSkillMeta(fullPath);
+      if (meta) {
+        visited.add(fullPath);
+        results.push(meta);
+      }
+    }
+  }
+
+  return results.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function matchesRule(text: string, rule: RoutingRule): boolean {
+  const normalized = text.toLowerCase();
+  const keywords = Array.isArray(rule.keywords) ? rule.keywords : [];
+  const allKeywords = Array.isArray(rule.allKeywords) ? rule.allKeywords : [];
+  const regexes = Array.isArray(rule.regexes) ? rule.regexes : [];
+
+  const anyKeywordMatched =
+    keywords.length === 0 ||
+    keywords.some((keyword) => normalized.includes(keyword.toLowerCase()));
+
+  const allKeywordMatched =
+    allKeywords.length === 0 ||
+    allKeywords.every((keyword) => normalized.includes(keyword.toLowerCase()));
+
+  const regexMatched =
+    regexes.length === 0 ||
+    regexes.some((pattern) => {
+      try {
+        return new RegExp(pattern, "i").test(text);
+      } catch {
+        return false;
+      }
+    });
+
+  const hasMatcher = keywords.length > 0 || allKeywords.length > 0 || regexes.length > 0;
+  return hasMatcher && anyKeywordMatched && allKeywordMatched && regexMatched;
+}
+
+function applyRuleFiltering(skills: SkillMeta[], routerCfg: RouterFileConfig, matchedRules: RoutingRule[]): SkillMeta[] {
+  let filtered = [...skills];
+
+  const includeSkills = new Set((routerCfg.includeSkills || []).filter(Boolean));
+  const excludeSkills = new Set((routerCfg.excludeSkills || []).filter(Boolean));
+
+  if (includeSkills.size > 0) {
+    filtered = filtered.filter((skill) => includeSkills.has(skill.name));
+  }
+  if (excludeSkills.size > 0) {
+    filtered = filtered.filter((skill) => !excludeSkills.has(skill.name));
+  }
+
+  const preferred = new Set<string>();
+  const excludedByRule = new Set<string>();
+  for (const rule of matchedRules) {
+    (rule.preferSkills || []).forEach((name) => preferred.add(name));
+    (rule.excludeSkills || []).forEach((name) => excludedByRule.add(name));
+  }
+
+  filtered = filtered.filter((skill) => !excludedByRule.has(skill.name));
+
+  if (preferred.size > 0) {
+    const preferredSkills = filtered.filter((skill) => preferred.has(skill.name));
+    const remainingSkills = filtered.filter((skill) => !preferred.has(skill.name));
+    filtered = [...preferredSkills, ...remainingSkills];
+  }
+
+  const maxSkills = routerCfg.maxSkillsInPrompt && routerCfg.maxSkillsInPrompt > 0 ? routerCfg.maxSkillsInPrompt : 20;
+  return filtered.slice(0, maxSkills);
+}
+
+function renderSkillList(skills: SkillMeta[]): string {
+  if (skills.length === 0) {
+    return "当前未扫描到可用 skill。";
+  }
+  return skills
+    .map((skill, index) => `${index + 1}. ${skill.name}\n说明：${skill.description}\n路径：${skill.skillPath}`)
+    .join("\n\n");
+}
+
+function renderRuleHints(matchedRules: RoutingRule[], routerCfg: RouterFileConfig): string {
+  if (matchedRules.length === 0) {
+    return routerCfg.defaultScopeNote ? `默认范围提示：${routerCfg.defaultScopeNote}` : "未命中任何自定义规则。";
+  }
+
+  return matchedRules
+    .map((rule, index) => {
+      const lines: string[] = [];
+      lines.push(`${index + 1}. 规则ID：${rule.id}`);
+      if (rule.description) {
+        lines.push(`描述：${rule.description}`);
+      }
+      if ((rule.preferSkills || []).length > 0) {
+        lines.push(`优先技能：${rule.preferSkills!.join("、")}`);
+      }
+      if ((rule.excludeSkills || []).length > 0) {
+        lines.push(`排除技能：${rule.excludeSkills!.join("、")}`);
+      }
+      if (rule.scopeNote) {
+        lines.push(`适用范围：${rule.scopeNote}`);
+      }
+      if (rule.prompt) {
+        lines.push(`提示：${rule.prompt}`);
+      }
+      return lines.join("\n");
+    })
+    .join("\n\n");
+}
+
+function buildRoutingPrompt(
+  userText: string,
+  defaultModel: string,
+  scannedSkills: SkillMeta[],
+  matchedRules: RoutingRule[],
+  routerCfg: RouterFileConfig,
+): string {
+  const lines: string[] = [];
+  lines.push("【Skill Auto Loader Hook】请在正式回答前，先完成本轮 skill 路由判断。");
+  lines.push(`当前 OpenClaw 默认模型：${defaultModel}`);
+  lines.push(`本轮用户消息：${userText}`);
+  lines.push("");
+  lines.push("请结合以下信息判断本轮是否需要优先使用某个 skill。");
+  lines.push("");
+  lines.push("一、当前可用 skill 列表");
+  lines.push(renderSkillList(scannedSkills));
+  lines.push("");
+  lines.push("二、本轮命中的自定义规则");
+  lines.push(renderRuleHints(matchedRules, routerCfg));
+  lines.push("");
+  lines.push("三、判断要求");
+  lines.push("1. 先判断本轮是否明显需要 skill。");
+  lines.push("2. 如果需要，只选择最相关的 1-3 个 skill 作为优先候选。");
+  lines.push("3. 若没有合适 skill，就按常规对话处理，不要强行套 skill。");
+  lines.push("4. 不要使用被规则排除的 skill。");
+  lines.push("5. 你的判断依据必须来自：用户消息、skill 描述、自定义 scope。");
+  lines.push("");
+  lines.push("四、执行方式");
+  lines.push("请把路由判断体现在你后续的实际执行中：若需要 skill，则优先按判断结果使用；若不需要，则正常回答。");
+  return lines.join("\n");
+}
+
+export default definePluginEntry({
+  id: PLUGIN_ID,
+  name: "Skill Auto Loader Hook",
+  description: "Intercept each user turn, discover installed skills, and inject routing guidance before prompt build.",
+  register(api: any) {
+    api.logger?.info?.("skill-auto-loader-hook: register()");
+    api.on(
+      "before_prompt_build",
+      (event: unknown) => {
+        const cfg = normalizePluginConfig(api);
+        if (!cfg.enabled) {
+          return undefined;
+        }
+
+        const routerCfg = readRouterConfig(cfg.routerConfigPath!, __dirname);
+        if (routerCfg.enabled === false) {
+          return undefined;
+        }
+
+        const userText = extractLatestUserText(event);
+        if (!userText) {
+          return undefined;
+        }
+
+        const scanDirs =
+          Array.isArray(routerCfg.skillsScanDirs) && routerCfg.skillsScanDirs.length > 0
+            ? routerCfg.skillsScanDirs.map((dir) => resolvePath(dir, __dirname))
+            : [path.join(process.cwd(), "skills"), path.join(process.cwd(), "openclaw-skills", "skills")];
+
+        const allSkills = scanInstalledSkills(scanDirs);
+        const matchedRules = (routerCfg.rules || []).filter((rule) => rule.enabled !== false && matchesRule(userText, rule));
+        const candidateSkills = applyRuleFiltering(allSkills, routerCfg, matchedRules);
+        const defaultModel = getDefaultModelInfo(cfg.openclawConfigPath!);
+        const payload = buildRoutingPrompt(userText, defaultModel, candidateSkills, matchedRules, routerCfg);
+
+        api.logger?.debug?.(
+          `skill-auto-loader-hook: before_prompt_build matchedRules=${matchedRules.length} candidateSkills=${candidateSkills.length}`,
+        );
+
+        if (cfg.injectMode === "prependSystemContext") {
+          return { prependSystemContext: payload };
+        }
+        if (cfg.injectMode === "appendSystemContext") {
+          return { appendSystemContext: payload };
+        }
+        return { prependContext: payload };
+      },
+      { priority: 50 },
+    );
+  },
+});

package/openclaw.plugin.json

@@ -2,8 +2,7 @@
   "id": "skill-auto-loader-hook",
   "name": "Skill Auto Loader Hook",
   "description": "Intercept each user turn, match custom routing rules, and inject skill selection guidance into prompt build.",
-  "version": "0.1.0",
-  "entry": "./dist/index.js",
+  "version": "0.1.2",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,27 +1,24 @@
 {
   "name": "skill-auto-loader-hook-paperfly777",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "OpenClaw hook plugin that routes each user message to the most relevant installed skill.",
   "license": "MIT",
   "type": "module",
-  "main": "dist/index.js",
+  "main": "index.ts",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
   "files": [
-    "dist",
+    "index.ts",
     "openclaw.plugin.json",
     "skill-router.config.json",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
   "engines": {
     "node": ">=18"
   },
-  "devDependencies": {
-    "@types/node": "^22.15.21",
-    "typescript": "^5.8.3"
-  },
   "keywords": [
     "openclaw",
     "plugin",

package/dist/index.js

@@ -1,346 +0,0 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-const PLUGIN_ID = "skill-auto-loader-hook";
-function safeString(value) {
-    return typeof value === "string" ? value : "";
-}
-function expandHome(inputPath) {
-    if (!inputPath) {
-        return inputPath;
-    }
-    if (inputPath.startsWith("~/")) {
-        return path.join(os.homedir(), inputPath.slice(2));
-    }
-    return inputPath;
-}
-function resolvePath(inputPath, baseDir) {
-    const expanded = expandHome(inputPath);
-    if (!expanded) {
-        return expanded;
-    }
-    if (path.isAbsolute(expanded)) {
-        return expanded;
-    }
-    return path.resolve(baseDir, expanded);
-}
-function readJsonFile(filePath) {
-    try {
-        const raw = fs.readFileSync(filePath, "utf8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-function extractTextFromContent(content) {
-    if (typeof content === "string") {
-        return content;
-    }
-    if (Array.isArray(content)) {
-        return content
-            .map((item) => {
-            if (typeof item === "string") {
-                return item;
-            }
-            if (item && typeof item === "object") {
-                const obj = item;
-                if (typeof obj.text === "string") {
-                    return obj.text;
-                }
-                if (typeof obj.input === "string") {
-                    return obj.input;
-                }
-            }
-            return "";
-        })
-            .filter(Boolean)
-            .join("\n");
-    }
-    return "";
-}
-function extractLatestUserText(event) {
-    if (!event || typeof event !== "object") {
-        return "";
-    }
-    const eventObj = event;
-    const messages = Array.isArray(eventObj.messages) ? eventObj.messages : [];
-    for (let i = messages.length - 1; i >= 0; i -= 1) {
-        const msg = messages[i];
-        if (!msg || typeof msg !== "object") {
-            continue;
-        }
-        const msgObj = msg;
-        if (safeString(msgObj.role) !== "user") {
-            continue;
-        }
-        const content = extractTextFromContent(msgObj.content);
-        if (content.trim()) {
-            return content.trim();
-        }
-    }
-    const fallbackPrompt = safeString(eventObj.userPrompt);
-    return fallbackPrompt.trim();
-}
-function normalizePluginConfig(api) {
-    const pluginCfg = api?.config?.plugins?.entries?.[PLUGIN_ID]?.config ??
-        api?.config?.plugins?.entries?.[PLUGIN_ID] ??
-        {};
-    return {
-        enabled: pluginCfg.enabled !== false,
-        injectMode: pluginCfg.injectMode || "prependContext",
-        routerConfigPath: safeString(pluginCfg.routerConfigPath) ||
-            path.join(__dirname, "skill-router.config.json"),
-        openclawConfigPath: safeString(pluginCfg.openclawConfigPath) ||
-            path.join(os.homedir(), ".openclaw", "openclaw.json"),
-    };
-}
-function readRouterConfig(configPath, baseDir) {
-    const config = readJsonFile(resolvePath(configPath, baseDir));
-    if (!config || typeof config !== "object") {
-        return {};
-    }
-    return config;
-}
-function getDefaultModelInfo(openclawConfigPath) {
-    const cfg = readJsonFile(expandHome(openclawConfigPath));
-    if (!cfg || typeof cfg !== "object") {
-        return "未读取到 OpenClaw 默认模型配置";
-    }
-    const root = cfg;
-    const directModel = safeString(root.model);
-    const channelsModel = safeString(root.channels?.model);
-    if (directModel) {
-        return directModel;
-    }
-    if (channelsModel) {
-        return channelsModel;
-    }
-    return "openclaw.json 中未显式配置默认模型";
-}
-function parseYamlLikeFrontmatter(raw) {
-    const result = { name: "", description: "" };
-    if (!raw.startsWith("---")) {
-        return result;
-    }
-    const endIndex = raw.indexOf("\n---", 3);
-    if (endIndex === -1) {
-        return result;
-    }
-    const frontmatter = raw.slice(3, endIndex).split(/\r?\n/);
-    let inDescription = false;
-    const descriptionLines = [];
-    for (const line of frontmatter) {
-        if (line.startsWith("name:")) {
-            result.name = line.slice(5).trim();
-            inDescription = false;
-            continue;
-        }
-        if (line.startsWith("description:")) {
-            const remainder = line.slice("description:".length).trim();
-            inDescription = true;
-            if (remainder && remainder !== "|") {
-                descriptionLines.push(remainder);
-                inDescription = false;
-            }
-            continue;
-        }
-        if (inDescription) {
-            if (/^\S/.test(line)) {
-                inDescription = false;
-            }
-            else {
-                descriptionLines.push(line.trim());
-            }
-        }
-    }
-    result.description = descriptionLines.join(" ").trim();
-    return result;
-}
-function extractHeadingFallback(raw) {
-    const lines = raw.split(/\r?\n/);
-    for (const line of lines) {
-        if (line.startsWith("# ")) {
-            return line.slice(2).trim();
-        }
-    }
-    return "";
-}
-function extractSkillMeta(skillDir) {
-    const skillMdPath = path.join(skillDir, "SKILL.md");
-    if (!fs.existsSync(skillMdPath)) {
-        return null;
-    }
-    const raw = fs.readFileSync(skillMdPath, "utf8");
-    const fm = parseYamlLikeFrontmatter(raw);
-    const name = fm.name || path.basename(skillDir);
-    const description = fm.description || extractHeadingFallback(raw) || "无描述";
-    return {
-        name,
-        description,
-        skillPath: skillDir,
-    };
-}
-function scanInstalledSkills(scanDirs) {
-    const results = [];
-    const visited = new Set();
-    for (const dir of scanDirs) {
-        const resolved = expandHome(dir);
-        if (!resolved || !fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
-            continue;
-        }
-        const entries = fs.readdirSync(resolved, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isDirectory()) {
-                continue;
-            }
-            const fullPath = path.join(resolved, entry.name);
-            if (visited.has(fullPath)) {
-                continue;
-            }
-            const meta = extractSkillMeta(fullPath);
-            if (meta) {
-                visited.add(fullPath);
-                results.push(meta);
-            }
-        }
-    }
-    return results.sort((a, b) => a.name.localeCompare(b.name));
-}
-function matchesRule(text, rule) {
-    const normalized = text.toLowerCase();
-    const keywords = Array.isArray(rule.keywords) ? rule.keywords : [];
-    const allKeywords = Array.isArray(rule.allKeywords) ? rule.allKeywords : [];
-    const regexes = Array.isArray(rule.regexes) ? rule.regexes : [];
-    const anyKeywordMatched = keywords.length === 0 ||
-        keywords.some((keyword) => normalized.includes(keyword.toLowerCase()));
-    const allKeywordMatched = allKeywords.length === 0 ||
-        allKeywords.every((keyword) => normalized.includes(keyword.toLowerCase()));
-    const regexMatched = regexes.length === 0 ||
-        regexes.some((pattern) => {
-            try {
-                return new RegExp(pattern, "i").test(text);
-            }
-            catch {
-                return false;
-            }
-        });
-    const hasMatcher = keywords.length > 0 || allKeywords.length > 0 || regexes.length > 0;
-    return hasMatcher && anyKeywordMatched && allKeywordMatched && regexMatched;
-}
-function applyRuleFiltering(skills, routerCfg, matchedRules) {
-    let filtered = [...skills];
-    const includeSkills = new Set((routerCfg.includeSkills || []).filter(Boolean));
-    const excludeSkills = new Set((routerCfg.excludeSkills || []).filter(Boolean));
-    if (includeSkills.size > 0) {
-        filtered = filtered.filter((skill) => includeSkills.has(skill.name));
-    }
-    if (excludeSkills.size > 0) {
-        filtered = filtered.filter((skill) => !excludeSkills.has(skill.name));
-    }
-    const preferred = new Set();
-    const excludedByRule = new Set();
-    for (const rule of matchedRules) {
-        (rule.preferSkills || []).forEach((name) => preferred.add(name));
-        (rule.excludeSkills || []).forEach((name) => excludedByRule.add(name));
-    }
-    filtered = filtered.filter((skill) => !excludedByRule.has(skill.name));
-    if (preferred.size > 0) {
-        const preferredSkills = filtered.filter((skill) => preferred.has(skill.name));
-        const remainingSkills = filtered.filter((skill) => !preferred.has(skill.name));
-        filtered = [...preferredSkills, ...remainingSkills];
-    }
-    const maxSkills = routerCfg.maxSkillsInPrompt && routerCfg.maxSkillsInPrompt > 0 ? routerCfg.maxSkillsInPrompt : 20;
-    return filtered.slice(0, maxSkills);
-}
-function renderSkillList(skills) {
-    if (skills.length === 0) {
-        return "当前未扫描到可用 skill。";
-    }
-    return skills
-        .map((skill, index) => `${index + 1}. ${skill.name}\n说明：${skill.description}\n路径：${skill.skillPath}`)
-        .join("\n\n");
-}
-function renderRuleHints(matchedRules, routerCfg) {
-    if (matchedRules.length === 0) {
-        return routerCfg.defaultScopeNote ? `默认范围提示：${routerCfg.defaultScopeNote}` : "未命中任何自定义规则。";
-    }
-    return matchedRules
-        .map((rule, index) => {
-        const lines = [];
-        lines.push(`${index + 1}. 规则ID：${rule.id}`);
-        if (rule.description) {
-            lines.push(`描述：${rule.description}`);
-        }
-        if ((rule.preferSkills || []).length > 0) {
-            lines.push(`优先技能：${rule.preferSkills.join("、")}`);
-        }
-        if ((rule.excludeSkills || []).length > 0) {
-            lines.push(`排除技能：${rule.excludeSkills.join("、")}`);
-        }
-        if (rule.scopeNote) {
-            lines.push(`适用范围：${rule.scopeNote}`);
-        }
-        if (rule.prompt) {
-            lines.push(`提示：${rule.prompt}`);
-        }
-        return lines.join("\n");
-    })
-        .join("\n\n");
-}
-function buildRoutingPrompt(userText, defaultModel, scannedSkills, matchedRules, routerCfg) {
-    const lines = [];
-    lines.push("【Skill Auto Loader Hook】请在正式回答前，先完成本轮 skill 路由判断。");
-    lines.push(`当前 OpenClaw 默认模型：${defaultModel}`);
-    lines.push(`本轮用户消息：${userText}`);
-    lines.push("");
-    lines.push("请结合以下信息判断本轮是否需要优先使用某个 skill。");
-    lines.push("");
-    lines.push("一、当前可用 skill 列表");
-    lines.push(renderSkillList(scannedSkills));
-    lines.push("");
-    lines.push("二、本轮命中的自定义规则");
-    lines.push(renderRuleHints(matchedRules, routerCfg));
-    lines.push("");
-    lines.push("三、判断要求");
-    lines.push("1. 先判断本轮是否明显需要 skill。");
-    lines.push("2. 如果需要，只选择最相关的 1-3 个 skill 作为优先候选。");
-    lines.push("3. 若没有合适 skill，就按常规对话处理，不要强行套 skill。");
-    lines.push("4. 不要使用被规则排除的 skill。");
-    lines.push("5. 你的判断依据必须来自：用户消息、skill 描述、自定义 scope。");
-    lines.push("");
-    lines.push("四、执行方式");
-    lines.push("请把路由判断体现在你后续的实际执行中：若需要 skill，则优先按判断结果使用；若不需要，则正常回答。");
-    return lines.join("\n");
-}
-export default function register(api) {
-    api.on("before_prompt_build", (event) => {
-        const cfg = normalizePluginConfig(api);
-        if (!cfg.enabled) {
-            return undefined;
-        }
-        const routerCfg = readRouterConfig(cfg.routerConfigPath, __dirname);
-        if (routerCfg.enabled === false) {
-            return undefined;
-        }
-        const userText = extractLatestUserText(event);
-        if (!userText) {
-            return undefined;
-        }
-        const scanDirs = Array.isArray(routerCfg.skillsScanDirs) && routerCfg.skillsScanDirs.length > 0
-            ? routerCfg.skillsScanDirs.map((dir) => resolvePath(dir, __dirname))
-            : [path.join(process.cwd(), "skills"), path.join(process.cwd(), "openclaw-skills", "skills")];
-        const allSkills = scanInstalledSkills(scanDirs);
-        const matchedRules = (routerCfg.rules || []).filter((rule) => rule.enabled !== false && matchesRule(userText, rule));
-        const candidateSkills = applyRuleFiltering(allSkills, routerCfg, matchedRules);
-        const defaultModel = getDefaultModelInfo(cfg.openclawConfigPath);
-        const payload = buildRoutingPrompt(userText, defaultModel, candidateSkills, matchedRules, routerCfg);
-        if (cfg.injectMode === "prependSystemContext") {
-            return { prependSystemContext: payload };
-        }
-        if (cfg.injectMode === "appendSystemContext") {
-            return { appendSystemContext: payload };
-        }
-        return { prependContext: payload };
-    }, { priority: 50 });
-}