foliko 1.0.73 → 1.0.75

package/skills/foliko-dev/SKILL.md

@@ -34,6 +34,7 @@ Foliko 是一个基于插件的 Agent 框架，核心简单，通过插件扩展
 ```
 
 **文件夹结构的优势：**
+
 - 支持 `package.json` 的 `main` 字段自定义入口
 - 支持 `node_modules` 存放插件私有依赖
 - 更适合复杂插件的代码组织
@@ -66,85 +67,87 @@ Foliko 是一个基于插件的 Agent 框架，核心简单，通过插件扩展
 
 ```javascript
 // .agent/plugins/my-plugin/index.js
-module.exports = function(Plugin) {
+module.exports = function (Plugin) {
   return class MyPlugin extends Plugin {
     constructor(config = {}) {
-      super()
-      this.name = 'my-plugin'
-      this.version = '1.0.0'
-      this.description = '我的工具插件'
-      this.priority = 10
+      super();
+      this.name = 'my-plugin';
+      this.version = '1.0.0';
+      this.description = '我的工具插件';
+      this.priority = 10;
     }
 
     install(framework) {
-      const { z } = require('zod')
+      const { z } = require('zod');
       framework.registerTool({
         name: 'my_tool',
         description: '我的工具',
         inputSchema: z.object({
-          param: z.string().describe('参数描述')
+          param: z.string().describe('参数描述'),
         }),
         execute: async (args, framework) => {
-          return { success: true, result: args.param }
-        }
-      })
-      return this
+          return { success: true, result: args.param };
+        },
+      });
+      return this;
     }
 
     uninstall(framework) {
       // 清理资源
     }
-  }
-}
+  };
+};
 ```
 
 ### 单文件结构（仍支持）
 
 ```javascript
 // .agent/plugins/my-plugin.js
-module.exports = function(Plugin) {
+module.exports = function (Plugin) {
   return class MyPlugin extends Plugin {
     // ... 与上面相同
-  }
-}
+  };
+};
 ```
 
 **注意**：如果文件夹和同名 `.js` 文件同时存在，**文件夹优先**。
 
 ```javascript
 // .agent/plugins/my-plugin.js
-module.exports = function(Plugin) {
+module.exports = function (Plugin) {
   return class MyPlugin extends Plugin {
     constructor(config = {}) {
-      super()
-      this.name = 'my-plugin'
-      this.version = '1.0.0'
-      this.description = '我的工具插件'
-      this.priority = 10
+      super();
+      this.name = 'my-plugin';
+      this.version = '1.0.0';
+      this.description = '我的工具插件';
+      this.priority = 10;
     }
 
     install(framework) {
-      const { z } = require('zod')
+      const { z } = require('zod');
       framework.registerTool({
         name: 'my_tool',
         description: '我的工具',
         inputSchema: z.object({
-          param: z.string().describe('参数描述')
+          param: z.string().describe('参数描述'),
         }),
         execute: async (args, framework) => {
-          return { success: true, result: args.param }
-        }
-      })
-      return this
+          return { success: true, result: args.param };
+        },
+      });
+      return this;
     }
 
     uninstall(framework) {
       // 清理资源
     }
-  }
-}
+  };
+};
 ```
+
 **插件开发流程：**
+
 1. **创建插件**（优先使用文件夹结构）
 2. **安装依赖**：
    - 文件夹插件：`install { package: "包名", path: ".agent/plugins/插件名" }`
@@ -152,8 +155,8 @@ module.exports = function(Plugin) {
 3. **热重载**：`reload_plugins`
 4. **检查加载状态**
 
-
 **关键点：**
+
 - `Plugin` 基类由系统自动传入（无需 require）
 - 函数直接返回插件类
 - 在 `install(framework)` 中通过 `framework` 注册工具
@@ -164,10 +167,10 @@ module.exports = function(Plugin) {
 
 当插件需要使用第三方 npm 包（如 `zod`、`axios` 等）时，根据插件类型选择安装位置：
 
-| 插件类型 | 安装位置 | 说明 |
-|----------|----------|------|
+| 插件类型       | 安装位置                              | 说明                   |
+| -------------- | ------------------------------------- | ---------------------- |
 | **文件夹插件** | `.agent/plugins/插件名/node_modules/` | 插件自包含，可独立迁移 |
-| **单文件插件** | `.agent/node_modules/` | 共享依赖 |
+| **单文件插件** | `.agent/node_modules/`                | 共享依赖               |
 
 ### 自动安装工具
 
@@ -175,30 +178,30 @@ module.exports = function(Plugin) {
 
 ```javascript
 // 安装到默认位置 .agent/node_modules
-install({ package: "zod" })
+install({ package: 'zod' });
 
 // 安装到指定目录（用于文件夹插件）
-install({ package: "axios", path: ".agent/plugins/my-plugin" })
+install({ package: 'axios', path: '.agent/plugins/my-plugin' });
 
 // 从 package.json 安装所有依赖到默认位置
-install({ file: "./package.json" })
+install({ file: './package.json' });
 
 // 从 package.json 安装所有依赖到指定目录
-install({ file: "./my-plugin/package.json", path: ".agent/plugins/my-plugin" })
+install({ file: './my-plugin/package.json', path: '.agent/plugins/my-plugin' });
 
 // 仅指定路径，安装该目录下的 package.json 依赖
-install({ path: ".agent/plugins/my-plugin" })
+install({ path: '.agent/plugins/my-plugin' });
 ```
 
 ### 文件夹插件的依赖安装示例
 
 ```javascript
 // .agent/plugins/my-plugin/index.js
-module.exports = function(Plugin) {
+module.exports = function (Plugin) {
   return class MyPlugin extends Plugin {
     constructor(config = {}) {
-      super()
-      this.name = 'my-plugin'
+      super();
+      this.name = 'my-plugin';
     }
 
     install(framework) {
@@ -206,26 +209,26 @@ module.exports = function(Plugin) {
         name: 'fetch_data',
         description: '获取远程数据',
         inputSchema: z.object({
-          url: z.string().describe('API URL')
+          url: z.string().describe('API URL'),
         }),
         execute: async (args, framework) => {
           // 安装到插件自己的目录
-          const pluginDir = '.agent/plugins/my-plugin'
+          const pluginDir = '.agent/plugins/my-plugin';
           await framework.callTool('install', {
             package: 'axios',
-            path: pluginDir
-          })
+            path: pluginDir,
+          });
 
           // 引入插件目录下的 node_modules
-          const axios = require(`${pluginDir}/node_modules/axios`)
-          const response = await axios.get(args.url)
-          return { success: true, data: response.data }
-        }
-      })
-      return this
+          const axios = require(`${pluginDir}/node_modules/axios`);
+          const response = await axios.get(args.url);
+          return { success: true, data: response.data };
+        },
+      });
+      return this;
     }
-  }
-}
+  };
+};
 ```
 
 ### 安装步骤
@@ -238,6 +241,7 @@ module.exports = function(Plugin) {
 4. **返回状态** 给用户
 
 示例流程（文件夹插件）：
+
 ```
 错误: Cannot find module 'axios'
 ↓
@@ -265,16 +269,16 @@ module.exports = function(Plugin) {
 
 ```javascript
 // plugins/my-plugin.js
-const { Plugin } = require('../src/core/plugin-base')
-const { z } = require('zod')
+const { Plugin } = require('../src/core/plugin-base');
+const { z } = require('zod');
 
 class MyPlugin extends Plugin {
   constructor(config = {}) {
-    super()
-    this.name = 'my-plugin'
-    this.version = '1.0.0'
-    this.description = '我的工具插件'
-    this.priority = 10
+    super();
+    this.name = 'my-plugin';
+    this.version = '1.0.0';
+    this.description = '我的工具插件';
+    this.priority = 10;
   }
 
   install(framework) {
@@ -282,42 +286,42 @@ class MyPlugin extends Plugin {
       name: 'my_tool',
       description: '我的工具',
       inputSchema: z.object({
-        param: z.string().describe('参数描述')
+        param: z.string().describe('参数描述'),
       }),
       execute: async (args, framework) => {
-        return { success: true, result: args.param }
-      }
-    })
-    return this
+        return { success: true, result: args.param };
+      },
+    });
+    return this;
   }
 
-  uninstall(framework) { }
+  uninstall(framework) {}
 }
 
-module.exports = { MyPlugin }
+module.exports = MyPlugin;
 ```
 
 ---
 
 ## 插件属性
 
-| 属性 | 类型 | 必须 | 说明 |
-|------|------|------|------|
-| `name` | string | ✅ | 唯一名称 |
-| `version` | string | ❌ | 版本号，默认 '1.0.0' |
-| `description` | string | ❌ | 插件描述 |
-| `priority` | number | ❌ | 加载优先级，默认 10 |
+| 属性          | 类型   | 必须 | 说明                 |
+| ------------- | ------ | ---- | -------------------- |
+| `name`        | string | ✅   | 唯一名称             |
+| `version`     | string | ❌   | 版本号，默认 '1.0.0' |
+| `description` | string | ❌   | 插件描述             |
+| `priority`    | number | ❌   | 加载优先级，默认 10  |
 
 ---
 
 ## 生命周期
 
-| 方法 | 调用时机 | 必须实现 |
-|------|----------|---------|
-| `install(framework)` | 插件安装时 | ✅ |
-| `start(framework)` | 插件启动时 | 推荐 |
-| `reload(framework)` | 热重载时 | 可选 |
-| `uninstall(framework)` | 卸载时 | 推荐 |
+| 方法                   | 调用时机   | 必须实现 |
+| ---------------------- | ---------- | -------- |
+| `install(framework)`   | 插件安装时 | ✅       |
+| `start(framework)`     | 插件启动时 | 推荐     |
+| `reload(framework)`    | 热重载时   | 可选     |
+| `uninstall(framework)` | 卸载时     | 推荐     |
 
 ---
 
@@ -344,13 +348,13 @@ install(framework) {
 
 ## 核心规则
 
-| 规则 | 说明 |
-|------|------|
-| **优先使用文件夹结构** | 复杂插件推荐用文件夹，便于管理依赖和代码 |
-| **必须用 inputSchema** | `inputSchema: z.object({})`（不是 parameters!） |
-| **必须用 zod 定义参数** | `param: z.string().describe('描述')` |
-| **install 必须返回 this** | 确保链式调用 |
-| **文件夹与文件重名时** | 文件夹优先，同名 `.js` 文件会被忽略 |
+| 规则                      | 说明                                            |
+| ------------------------- | ----------------------------------------------- |
+| **优先使用文件夹结构**    | 复杂插件推荐用文件夹，便于管理依赖和代码        |
+| **必须用 inputSchema**    | `inputSchema: z.object({})`（不是 parameters!） |
+| **必须用 zod 定义参数**   | `param: z.string().describe('描述')`            |
+| **install 必须返回 this** | 确保链式调用                                    |
+| **文件夹与文件重名时**    | 文件夹优先，同名 `.js` 文件会被忽略             |
 
 ## 开发完成后注意事项
 
@@ -366,6 +370,7 @@ install(framework) {
 4. **检查加载状态**
 
 示例：
+
 ```
 创建插件 my-plugin.js（需要 zod）
 ↓
@@ -377,6 +382,7 @@ reload_plugins
 ```
 
 ### 其他注意事项
+
 --**开发完成重载成功后检测有没有加载新的插件，不需要进行过多测试步骤，直接告知用户状态即可**
 
 ---
@@ -385,14 +391,14 @@ reload_plugins
 
 Agent 支持 `sharedPrompt` 中的占位符替换：
 
-| 占位符 | 说明 |
-|--------|------|
-| `{{WORK_DIR}}` | 工作目录 |
-| `{{HOME_DIR}}` | 主目录 |
-| `{{HOST_NAME}}` | 主机名 |
-| `{{PLATFORM}}` | 平台 |
-| `{{TIME}}` | 当前时间 |
-| `{{DATE}}` | 当前日期 |
+| 占位符          | 说明     |
+| --------------- | -------- |
+| `{{WORK_DIR}}`  | 工作目录 |
+| `{{HOME_DIR}}`  | 主目录   |
+| `{{HOST_NAME}}` | 主机名   |
+| `{{PLATFORM}}`  | 平台     |
+| `{{TIME}}`      | 当前时间 |
+| `{{DATE}}`      | 当前日期 |
 
 ---
 
@@ -405,9 +411,9 @@ const agent = framework.createAgent({
   sharedPrompt: '工作目录: {{WORK_DIR}}\n项目: {{projectName}}',
   metadata: {
     projectName: 'MyProject',
-    version: '1.0.0'
-  }
-})
+    version: '1.0.0',
+  },
+});
 ```
 
 ---
@@ -416,10 +422,10 @@ const agent = framework.createAgent({
 
 ```javascript
 // 重载单个插件
-await framework.reloadPlugin('my-plugin')
+await framework.reloadPlugin('my-plugin');
 
 // 重载所有插件
-await framework.reloadAllPlugins()
+await framework.reloadAllPlugins();
 ```
 
 ---
@@ -432,14 +438,14 @@ await framework.reloadAllPlugins()
 
 ```javascript
 // plugins/my-plugin.js
-const { Plugin } = require('../src/core/plugin-base')
-const { tool } = require('ai')
-const { z } = require('zod')
+const { Plugin } = require('../src/core/plugin-base');
+const { tool } = require('ai');
+const { z } = require('zod');
 
 class MyPlugin extends Plugin {
   constructor(config = {}) {
-    super()
-    this.name = 'my-plugin'
+    super();
+    this.name = 'my-plugin';
   }
 
   // 配置式注册子Agent，插件启动时自动创建
@@ -453,14 +459,14 @@ class MyPlugin extends Plugin {
           description: '编译代码',
           parameters: z.object({
             language: z.string(),
-            code: z.string()
+            code: z.string(),
           }),
-          execute: async (args) => ({ success: true })
-        })
+          execute: async (args) => ({ success: true }),
+        }),
       },
-      parentTools: ['read_file', 'write_file']
-    }
-  ]
+      parentTools: ['read_file', 'write_file'],
+    },
+  ];
 }
 ```
 
@@ -485,10 +491,10 @@ start(framework) {
 
 ### 子Agent配置说明
 
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `name` | string | 子Agent名称（唯一标识） |
-| `role` | string | 角色描述 |
-| `description` | string | 详细描述 |
-| `tools` | object | 自定义工具 `{ name: toolDef }`，只属于此子Agent |
-| `parentTools` | array | 从父Agent继承的工具名称列表 |
+| 字段          | 类型   | 说明                                            |
+| ------------- | ------ | ----------------------------------------------- |
+| `name`        | string | 子Agent名称（唯一标识）                         |
+| `role`        | string | 角色描述                                        |
+| `description` | string | 详细描述                                        |
+| `tools`       | object | 自定义工具 `{ name: toolDef }`，只属于此子Agent |
+| `parentTools` | array  | 从父Agent继承的工具名称列表                     |

package/skills/mcp-usage/SKILL.md

@@ -21,12 +21,11 @@ mcp_list_servers()
 ```
 
 返回示例：
+
 ```json
 {
   "success": true,
-  "servers": [
-    { "name": "fetch", "tools": [{ "name": "fetch", "description": "..." }] }
-  ]
+  "servers": [{ "name": "fetch", "tools": [{ "name": "fetch", "description": "..." }] }]
 }
 ```
 
@@ -39,6 +38,7 @@ mcp_tool_schema({ server: "服务器名", tool: "工具名" })
 ```
 
 返回示例：
+
 ```json
 {
   "success": true,
@@ -65,6 +65,7 @@ mcp_call({
 ```
 
 **重要**：
+
 - `args_json` 必须是有效的 JSON 字符串
 - 必填参数不能为空
 - 如果不知道参数结构，先用 `mcp_tool_schema` 查询
@@ -86,10 +87,10 @@ mcp_reload()
 ```javascript
 // 调用 fetch 工具获取网页
 mcp_call({
-  server: "fetch",
-  tool: "fetch",
-  args_json: '{"url": "https://news.baidu.com"}'
-})
+  server: 'fetch',
+  tool: 'fetch',
+  args_json: '{"url": "https://news.baidu.com"}',
+});
 ```
 
 ### 多个参数调用
@@ -97,10 +98,10 @@ mcp_call({
 ```javascript
 // 调用搜索工具
 mcp_call({
-  server: "bing-cn-mcp-server",
-  tool: "bing_search",
-  args_json: '{"query": "关键词", "count": 10}'
-})
+  server: 'bing-cn-mcp-server',
+  tool: 'bing_search',
+  args_json: '{"query": "关键词", "count": 10}',
+});
 ```
 
 ### 复杂参数调用
@@ -108,6 +109,7 @@ mcp_call({
 对于复杂参数（嵌套对象、数组等）：
 
 1. 先查询参数结构：
+
 ```
 mcp_tool_schema({ server: "服务器", tool: "工具" })
 ```
@@ -186,12 +188,12 @@ MCP 服务器配置在 `.agent/mcp_config.json`：
 
 ## 6. Quick Reference
 
-| 场景 | 操作 |
-|------|------|
-| 查看可用服务器 | `mcp_list_servers()` |
-| 查询参数结构 | `mcp_tool_schema({ server: "x", tool: "y" })` |
-| 调用工具 | `mcp_call({ server: "x", tool: "y", args_json: '{}' })` |
-| 重载配置 | `mcp_reload()` |
+| 场景           | 操作                                                    |
+| -------------- | ------------------------------------------------------- |
+| 查看可用服务器 | `mcp_list_servers()`                                    |
+| 查询参数结构   | `mcp_tool_schema({ server: "x", tool: "y" })`           |
+| 调用工具       | `mcp_call({ server: "x", tool: "y", args_json: '{}' })` |
+| 重载配置       | `mcp_reload()`                                          |
 
 ---
 

package/skills/python-plugin-dev/SKILL.md

@@ -83,17 +83,18 @@ def calc_tool(params):
 ```
 
 **重要**：`tools` 字段定义了插件提供的所有工具。框架会自动：
+
 1. 将这些工具注册到系统中
 2. 附加到系统提示词，LLM 可以直接调用
 
 ## 工具函数规范
 
-| 规范 | 说明 |
-|------|------|
-| 返回 dict | 必须是 Python 字典 |
-| success 字段 | `true` 或 `false` |
-| result 字段 | 成功时返回的结果 |
-| error 字段 | 失败时返回的错误信息 |
+| 规范         | 说明                 |
+| ------------ | -------------------- |
+| 返回 dict    | 必须是 Python 字典   |
+| success 字段 | `true` 或 `false`    |
+| result 字段  | 成功时返回的结果     |
+| error 字段   | 失败时返回的错误信息 |
 
 ## 返回值格式
 
@@ -254,12 +255,12 @@ def install_package(params):
 
 插件中可以使用的常用库：
 
-| 库 | 用途 | 导入方式 |
-|-----|------|---------|
-| requests | HTTP 请求 | `import requests` |
-| json | JSON 处理 | `import json` |
-| os | 系统操作 | `import os` |
-| pathlib | 路径处理 | `from pathlib import Path` |
-| datetime | 日期时间 | `from datetime import datetime` |
-| re | 正则表达式 | `import re` |
-| csv | CSV 处理 | `import csv` |
+| 库       | 用途       | 导入方式                        |
+| -------- | ---------- | ------------------------------- |
+| requests | HTTP 请求  | `import requests`               |
+| json     | JSON 处理  | `import json`                   |
+| os       | 系统操作   | `import os`                     |
+| pathlib  | 路径处理   | `from pathlib import Path`      |
+| datetime | 日期时间   | `from datetime import datetime` |
+| re       | 正则表达式 | `import re`                     |
+| csv      | CSV 处理   | `import csv`                    |

package/skills/skill-guide/SKILL.md

@@ -27,13 +27,12 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 
 ```yaml
 ---
-name: my-skill           # 技能名称（必需，唯一标识）
+name: my-skill # 技能名称（必需，唯一标识）
 description: 这是一个自定义技能的描述。当用户说"..."时调用此技能。（必需）
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash  # 可选，允许使用的工具列表
-license: MIT             # 可选，许可证
-compatibility: v1.0.0    # 可选，兼容版本
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash # 可选，允许使用的工具列表
+license: MIT # 可选，许可证
+compatibility: v1.0.0 # 可选，兼容版本
 ---
-
 # 技能标题
 
 这里是技能的详细说明内容，可以使用 Markdown 格式。
@@ -41,17 +40,18 @@ compatibility: v1.0.0    # 可选，兼容版本
 
 ### frontmatter 字段说明
 
-| 字段 | 必需 | 说明 |
-|------|------|------|
-| `name` | 是 | 技能唯一标识，字母、数字、下划线、横杠，1-64字符 |
-| `description` | 是 | 技能描述，当用户意图匹配时会被调用 |
-| `allowed-tools` | 否 | 允许使用的工具列表，逗号分隔 |
-| `license` | 否 | 许可证类型 |
-| `compatibility` | 否 | 兼容的框架版本 |
+| 字段            | 必需 | 说明                                             |
+| --------------- | ---- | ------------------------------------------------ |
+| `name`          | 是   | 技能唯一标识，字母、数字、下划线、横杠，1-64字符 |
+| `description`   | 是   | 技能描述，当用户意图匹配时会被调用               |
+| `allowed-tools` | 否   | 允许使用的工具列表，逗号分隔                     |
+| `license`       | 否   | 许可证类型                                       |
+| `compatibility` | 否   | 兼容的框架版本                                   |
 
 ### 正文格式
 
 frontmatter 之后是技能的正文内容，支持 Markdown 格式，包含：
+
 - 详细的功能说明
 - 使用示例
 - 最佳实践