foliko 1.0.87 → 1.1.0

package/skills/skill-guide/SKILL.md

@@ -1,108 +1,130 @@
----
-name: skill-guide
-description: 技能安装与开发指南。当用户询问"如何添加技能"、"自定义技能"、"安装技能"时立即调用。
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
----
-
-# 技能（Skill）安装与开发指南
-
-## 概述
-
-技能（Skill）是 Agent 的扩展能力模块，存放在 `.agent/skills/` 目录下。
-
-## 技能存放位置
-
-```
-项目目录/
-└── .agent/
-    └── skills/
-        └── my-skill/          # 技能文件夹
-            ├── SKILL.md        # 必需，技能定义文件
-            └── ...             # 其他资源文件（可选）
-```
-
-## SKILL.md 格式
-
-每个技能必须包含 `SKILL.md` 文件，使用 YAML frontmatter 定义元数据：
-
-```yaml
----
-name: my-skill # 技能名称（必需，唯一标识）
-description: 这是一个自定义技能的描述。当用户说"..."时调用此技能。（必需）
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash # 可选，允许使用的工具列表
-license: MIT # 可选，许可证
-compatibility: v1.0.0 # 可选，兼容版本
----
-# 技能标题
-
-这里是技能的详细说明内容，可以使用 Markdown 格式。
-```
-
-### frontmatter 字段说明
-
-| 字段            | 必需 | 说明                                             |
-| --------------- | ---- | ------------------------------------------------ |
-| `name`          | 是   | 技能唯一标识，字母、数字、下划线、横杠，1-64字符 |
-| `description`   | 是   | 技能描述，当用户意图匹配时会被调用               |
-| `allowed-tools` | 否   | 允许使用的工具列表，逗号分隔                     |
-| `license`       | 否   | 许可证类型                                       |
-| `compatibility` | 否   | 兼容的框架版本                                   |
-
-### 正文格式
-
-frontmatter 之后是技能的正文内容，支持 Markdown 格式，包含：
-
-- 详细的功能说明
-- 使用示例
-- 最佳实践
-- 注意事项
-
-## 创建自定义技能
-
-1. 在 `.agent/skills/` 下创建技能文件夹
-2. 创建 `SKILL.md` 文件，包含完整的 frontmatter
-3. 在正文中详细描述技能的功能和使用方法
-4. 调用 `reloadSkills` 工具重载所有技能
-
-## 技能重载
-
-创建或修改技能后，需要调用 `reloadSkills` 工具重载：
-
-```json
-{
-  "tool": "reloadSkills",
-  "args": {}
-}
-```
-
-## 示例：创建天气查询技能
-
-```
-.agent/skills/weather/
-└── SKILL.md
-```
-
-SKILL.md 内容：
-
-```yaml
----
-name: weather
-description: 查询天气信息。当用户说"天气怎么样"、"今天多少度"时调用。
-allowed-tools: Bash, Read
----
-
-# 天气查询技能
-
-## 功能
-
-查询指定城市的天气信息。
-
-## 使用方式
-
-用户发送 "北京天气" 或 "今天上海多少度"
-
-## 注意事项
-
-- 使用免费的天气 API
-- 响应需要简洁明了
-```
+---
+name: skill-guide
+description: 技能安装与开发指南。当用户询问"如何添加技能"、"自定义技能"、"安装技能"时立即调用。
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# 技能（Skill）安装与开发指南
+
+## 概述
+
+技能（Skill）是 Agent 的扩展能力模块，存放在 `.agent/skills/` 目录下。
+
+## 技能存放位置
+
+### 方式一：.agent/skills/ 目录
+
+```
+项目目录/
+└── .agent/
+    └── skills/
+        └── my-skill/          # 技能文件夹
+            ├── SKILL.md        # 必需，技能定义文件
+            └── ...             # 其他资源文件（可选）
+```
+
+### 方式二：插件目录下
+
+插件目录下的 `SKILL.md` 也会被自动加载为技能：
+
+```
+项目目录/
+└── .agent/
+    └── plugins/
+        └── my-plugin/         # 插件文件夹
+            ├── index.js        # 插件入口文件
+            ├── SKILL.md        # 可选，技能定义文件（自动加载）
+            └── ...
+```
+
+**规则：**
+
+- 插件目录下的 `SKILL.md` 会被自动发现并加载为技能
+- 技能名称与插件名称相同
+- 插件启用/重载时会自动更新关联的技能
+
+## SKILL.md 格式
+
+每个技能必须包含 `SKILL.md` 文件，使用 YAML frontmatter 定义元数据：
+
+```yaml
+---
+name: my-skill # 技能名称（必需，唯一标识）
+description: 这是一个自定义技能的描述。当用户说"..."时调用此技能。（必需）
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash # 可选，允许使用的工具列表
+license: MIT # 可选，许可证
+compatibility: v1.0.0 # 可选，兼容版本
+---
+# 技能标题
+
+这里是技能的详细说明内容，可以使用 Markdown 格式。
+```
+
+### frontmatter 字段说明
+
+| 字段            | 必需 | 说明                                             |
+| --------------- | ---- | ------------------------------------------------ |
+| `name`          | 是   | 技能唯一标识，字母、数字、下划线、横杠，1-64字符 |
+| `description`   | 是   | 技能描述，当用户意图匹配时会被调用               |
+| `allowed-tools` | 否   | 允许使用的工具列表，逗号分隔                     |
+| `license`       | 否   | 许可证类型                                       |
+| `compatibility` | 否   | 兼容的框架版本                                   |
+
+### 正文格式
+
+frontmatter 之后是技能的正文内容，支持 Markdown 格式，包含：
+
+- 详细的功能说明
+- 使用示例
+- 最佳实践
+- 注意事项
+
+## 创建自定义技能
+
+1. 在 `.agent/skills/` 下创建技能文件夹
+2. 创建 `SKILL.md` 文件，包含完整的 frontmatter
+3. 在正文中详细描述技能的功能和使用方法
+4. 调用 `reloadSkills` 工具重载所有技能
+
+## 技能重载
+
+创建或修改技能后，需要调用 `reloadSkills` 工具重载：
+
+```json
+{
+  "tool": "reloadSkills",
+  "args": {}
+}
+```
+
+## 示例：创建天气查询技能
+
+```
+.agent/skills/weather/
+└── SKILL.md
+```
+
+SKILL.md 内容：
+
+```yaml
+---
+name: weather
+description: 查询天气信息。当用户说"天气怎么样"、"今天多少度"时调用。
+allowed-tools: Bash, Read
+---
+
+# 天气查询技能
+
+## 功能
+
+查询指定城市的天气信息。
+
+## 使用方式
+
+用户发送 "北京天气" 或 "今天上海多少度"
+
+## 注意事项
+
+- 使用免费的天气 API
+- 响应需要简洁明了
+```

package/src/capabilities/skill-manager.js

@@ -286,6 +286,7 @@ class SkillManagerPlugin extends Plugin {
 
     let totalLoaded = 0;
 
+    // 1. 扫描 skillsDirs
     for (const skillsDir of this._skillsDirs) {
       const resolvedDir = path.resolve(process.cwd(), skillsDir);
 
@@ -322,10 +323,108 @@ class SkillManagerPlugin extends Plugin {
       }
     }
 
+    // 2. 扫描插件目录下的 SKILL.md
+    this._loadSkillsFromPlugins();
+
     log.info(` Loaded ${this._skills.size} skills`);
     this._loaded = true;
   }
 
+  /**
+   * 从已加载插件的目录中扫描 SKILL.md 并加载为技能
+   */
+  _loadSkillsFromPlugins() {
+    if (!this._framework) return;
+
+    try {
+      // 获取所有已注册插件的 sourcePath
+      const pluginManager = this._framework.pluginManager;
+      const plugins = pluginManager._plugins || new Map();
+
+      for (const [pluginName, entry] of plugins) {
+        const sourcePath = entry.sourcePath;
+        if (!sourcePath) continue;
+
+        // 获取插件所在目录
+        const pluginDir = path.dirname(sourcePath);
+
+        // 检查插件目录下是否有 SKILL.md（尝试大小写）
+        let skillMdPath = path.join(pluginDir, 'SKILL.md');
+        if (!fs.existsSync(skillMdPath)) {
+          skillMdPath = path.join(pluginDir, 'SKILL.MD');
+        }
+        if (!fs.existsSync(skillMdPath)) {
+          // 使用 _findSkillMarkdown 递归查找
+          const found = this._findSkillMarkdown(pluginDir);
+          if (found) {
+            skillMdPath = found;
+          } else {
+            continue;
+          }
+        }
+
+        // 使用插件名作为 skill 名（如果已存在则跳过）
+        const skillName = pluginName;
+        if (this._skills.has(skillName)) {
+          continue;
+        }
+
+        try {
+          this._loadSkillFromFile(skillName, skillMdPath, pluginDir);
+          log.info(` Loaded skill from plugin '${pluginName}': ${skillName}`);
+        } catch (err) {
+          log.warn(` Failed to load skill from plugin '${pluginName}':`, err.message);
+        }
+      }
+    } catch (err) {
+      log.warn('Failed to scan plugins for skills:', err.message);
+    }
+  }
+
+  /**
+   * 从文件加载技能（用于插件目录的 SKILL.md）
+   * @param {string} name - 技能名称
+   * @param {string} filePath - SKILL.md 文件路径
+   * @param {string} baseDir - 技能基础目录
+   */
+  _loadSkillFromFile(name, filePath, baseDir) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const frontmatter = parseFrontmatter(content);
+
+    if (!frontmatter) {
+      throw new Error('No valid frontmatter found');
+    }
+
+    const metadata = new SkillMetadata({
+      name: frontmatter.name || name,
+      description: frontmatter.description || '',
+      license: frontmatter.license,
+      compatibility: frontmatter.compatibility,
+      metadata: frontmatter.metadata || {},
+      allowedTools: frontmatter['allowed-tools'] || [],
+    });
+
+    const skill = new Skill(metadata, stripFrontmatter(content));
+    skill.install(this._framework);
+
+    // 扫描 references 子目录
+    const references = this._scanReferences(baseDir);
+
+    // 扫描 scripts 子目录
+    const scripts = this._scanScripts(baseDir);
+
+    this._skills.set(name, {
+      name,
+      metadata,
+      content: skill.content,
+      instance: skill,
+      path: baseDir,
+      references,
+      scripts,
+      fromPlugin: true, // 标记为来自插件
+    });
+  }
+
   /**
    * 递归查找 SKILL.md 或 AGENTS.md（支持多层嵌套目录）
    * @param {string} dir - 要搜索的目录