foliko 1.1.69 → 1.1.70

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.1.69",
+  "version": "1.1.70",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",

package/plugins/extension-executor-plugin.js

@@ -392,7 +392,7 @@ class ExtensionExecutorPlugin extends Plugin {
     if (this._extensions.size > 0 || (this._mcpExecutor && Object.keys(this._mcpExecutor.tools || {}).length > 0)) {
       desc += '## 【Extensions】扩展插件\n\n';
       desc += '**使用流程（必须按顺序执行）：**\n';
-      desc += '1. 调用 `ext_skill({ plugin: "skill" })` 获取技能命令的详细参数\n';
+      desc += '1. 调用 `ext_skill({ plugin: "<plugin_name>" })` 或 `loadSkill({ skill: "<skill_name>" })` 获取技能命令的详细参数\n';
       desc += '2. 根据返回的参数定义，使用 `ext_call({ plugin: "skill", tool: "技能名:命令名", args: {...} })` 调用\n\n';
       desc += '> **警告**：禁止在未执行第1步获取参数的情况下直接调用 `ext_call`！\n\n';
 
@@ -437,7 +437,7 @@ class ExtensionExecutorPlugin extends Plugin {
       }
 
       desc += '\n## 禁止事项\n';
-      desc += '- 不先调用 `ext_skill` 获取参数就直接使用 `ext_call`\n';
+      desc += '- 不先调用 `ext_skill/loadSkill` 获取参数就直接使用 `ext_call`\n';
     }
 
     if (!desc) {

package/plugins/subagent-plugin.js

@@ -206,7 +206,7 @@ class SubAgentPlugin extends Plugin {
 - 处理本职外的任务
 - 代替其他子Agent执行操作
 - 在回复中透露你的内部实现细节
-- 不先调用 ext_skill 就直接使用 ext_call`
+- 不先调用 ext_skill/loadSkill 就直接使用 ext_call`
   }
 
   /**

package/skills/skill-guide/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: skill-guide
-description: 技能安装与开发指南。当用户询问"如何添加技能"、"自定义技能"、"安装技能"时立即调用。
+description: 技能安装与开发指南。当用户询问"如何添加技能"、"自定义技能"、"安装技能"、"创建技能"时立即调用。如果技能有命令，必须在 SKILL.md 中添加 ## 命令 章节详细说明。
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 ---
 
@@ -84,7 +84,146 @@ frontmatter 之后是技能的正文内容，支持 Markdown 格式，包含：
 1. 在 `.foliko/skills/` 下创建技能文件夹
 2. 创建 `SKILL.md` 文件，包含完整的 frontmatter
 3. 在正文中详细描述技能的功能和使用方法
-4. 调用 `reloadSkills` 工具重载所有技能
+4. **如有命令**，在 SKILL.md 正文中添加 `## 命令` 章节，详细说明每个命令的用法
+5. 创建 `index.js` 文件导出命令（可选）
+6. 调用 `reloadSkills` 工具重载所有技能
+
+### SKILL.md 命令章节示例
+
+如果技能有命令，必须在 SKILL.md 正文添加 `## 命令` 章节：
+
+```markdown
+## 命令
+
+### /my-skill:greet
+
+打招呼命令。
+
+**参数：**
+- `args`（可选）：名字，如 `/my-skill:greet Alice`
+
+**示例：**
+- `/my-skill:greet` → "Hello World"
+- `/my-skill:greet Alice` → "Hello Alice"
+
+### /my-skill:split
+
+切割会话命令。
+
+**参数：**
+- `-t, --tokens <value>`：保留 token 数（默认 4000）
+- `-k, --keep-recent <value>`：保留最近 token（默认 1000）
+- `[args...]`：位置参数
+
+**示例：**
+- `/my-skill:split` → 使用默认参数
+- `/my-skill:split -t 8000 extra` → tokens=8000，extra 作为位置参数
+```
+
+### index.js 格式
+
+```javascript
+module.exports = [
+  {
+    name: 'greet',           // 命令名
+    description: '打招呼',   // 命令描述
+    execute: async (args, ctx) => {
+      // args: 传入的参数（字符串）
+      // ctx: 上下文对象 { sessionId, agent, framework }
+      return 'Hello ' + (args || 'World');
+    }
+  },
+  {
+    name: 'split',
+    description: '切割会话',
+    // 简洁方式：定义选项数组，自动使用 Commander.js 解析
+    options: [
+      { flags: '-t, --tokens <value>', description: '保留 token 数', defaultValue: '4000' },
+      { flags: '-k, --keep-recent <value>', description: '保留最近 token', defaultValue: '1000' }
+    ],
+    execute: async (parsedArgs, ctx) => {
+      // parsedArgs: { tokens: "4000", keepRecent: "1000", args: [...] }
+      return `Split: tokens=${parsedArgs.tokens}`;
+    }
+  },
+  {
+    name: 'status',
+    description: '显示状态',
+    execute: async (args, ctx) => {
+      return JSON.stringify({ session: ctx.sessionId });
+    }
+  }
+];
+```
+
+**参数解析说明：**
+
+- 不提供 `options` 时，`args` 是原始参数字符串
+- 提供 `options` 数组时，自动使用 Commander.js 解析，`execute` 收到解析后的对象
+- 对象格式：`{ tokens, keepRecent, args: [...] }`
+
+### 命令调用方式
+
+技能命令通过 `ext_call` 工具调用，格式为 `/skillname:commandname`：
+
+| 渠道 | 调用方式 |
+|------|---------|
+| CLI | 输入 `/skillname:cmdname` |
+| 飞书 | 发送 `/skillname:cmdname` |
+| 微信 | 发送 `/skillname:cmdname` |
+| Telegram | 发送 `/skillname:cmdname` |
+| QQ | 发送 `/skillname:cmdname` |
+
+### 使用流程
+
+1. **查看可用命令**：发送 `/help` 或 `/start` 查看帮助，其中列出所有技能命令
+2. **执行命令**：发送 `/skillname:cmdname` 即可执行命令
+
+### 示例：test-skill
+
+假设有 `test-skill` 技能，其 `index.js` 导出：
+
+```javascript
+module.exports = [
+  { name: 'greet', description: '打招呼', execute: async (args) => 'Hello ' + (args || 'World') },
+  { name: 'echo', description: '回声命令', execute: async (args) => 'Echo: ' + args }
+];
+```
+
+对应的 SKILL.md 应包含：
+
+```markdown
+## 命令
+
+### /test-skill:greet
+
+打招呼命令。
+
+**参数：**
+- `args`（可选）：名字
+
+**示例：**
+- `/test-skill:greet` → "Hello World"
+- `/test-skill:greet Alice` → "Hello Alice"
+
+### /test-skill:echo
+
+回声命令，将输入原样返回。
+
+**参数：**
+- `args`：要回显的文本
+
+**示例：**
+- `/test-skill:echo Hello` → "Echo: Hello"
+```
+
+### 自动注册
+
+技能命令会在以下时机自动注册：
+- 框架启动时加载技能
+- 调用 `reloadSkills` 工具重载后
+
+注册后即可在所有渠道使用 `/技能名:命令名` 格式调用。
 
 ## 技能重载
 

package/src/capabilities/skill-manager.js

@@ -115,6 +115,7 @@ class Skill {
     this.content = content;
     this._framework = null;
     this._commands = [];
+    this.tools = {}; // 用于 extension-executor 扫描
   }
 
   /**
@@ -195,9 +196,7 @@ class Skill {
           };
         }
 
-        // 注册到 extension 系统，通过 ext_call 调用
-        extExecutor.registerTool('skill', skillInfo, {
-          name: fullName,
+        const toolDef = {
           description: cmd.description || `Skill command: ${fullName}`,
           inputSchema: z.object({
             args: z.string().optional().describe('命令参数'),
@@ -215,7 +214,13 @@ class Skill {
             }
             return await handler(parsedArgs, ctx);
           },
-        });
+        };
+
+        // 注册到 extension 系统，通过 ext_call 调用
+        extExecutor.registerTool('skill', skillInfo, toolDef);
+
+        // 同时添加到 this.tools，供 extension-executor 的 _scanPluginTools 扫描
+        this.tools[fullName] = toolDef;
 
         this._commands.push(fullName);
       }
@@ -247,6 +252,7 @@ class SkillManagerPlugin extends Plugin {
       : [config.skillsDir || '.foliko/skills', 'skills'];
     this._skills = new Map();
     this._loaded = false;
+    this.tools = {}; // 用于 extension-executor 扫描（由 Skill.registerCommands 填充）
   }
 
   install(framework) {
@@ -626,6 +632,9 @@ class SkillManagerPlugin extends Plugin {
     skill.install(this._framework);
     skill.registerCommands(); // 注册 skill 的命令
 
+    // 将 skill 的命令添加到 SkillManagerPlugin.tools，供 extension-executor 扫描
+    Object.assign(this.tools, skill.tools);
+
     // 扫描 references 子目录（按需加载的附加文档）
     const references = this._scanReferences(skillPath);
 
@@ -822,6 +831,15 @@ class SkillManagerPlugin extends Plugin {
     this._loaded = false;
     this._framework = framework;
     this._loadAllSkills();
+
+    // 通知 extension-executor 重载 skill 命令
+    const extExecutor = framework.pluginManager?.get('extension-executor');
+    if (extExecutor && typeof extExecutor._rescanPluginTools === 'function') {
+      const skillPlugin = framework.pluginManager?.get('skill-manager');
+      if (skillPlugin) {
+        extExecutor._rescanPluginTools(skillPlugin);
+      }
+    }
   }
 
   uninstall(framework) {

package/src/core/subagent.js

@@ -40,7 +40,7 @@ class Subagent extends EventEmitter {
     this.providerOptions = config.providerOptions || {};
     this.framework = config.framework || null;
 
-    this.defaulTools = ['ext_skill','ext_call','subagent_call','mcp_call','mcp_tool_schema'];
+    this.defaulTools = ['ext_skill','loadSkill','ext_call','subagent_call','mcp_call','mcp_tool_schema'];
 
     this.bindTools = {
       read: 'read_file',
@@ -282,7 +282,7 @@ class Subagent extends EventEmitter {
     lines.push(`- 处理本职外的任务`);
     lines.push(`- 代替其他子Agent执行操作`);
     lines.push(`- 在回复中透露你的内部实现细节`);
-    lines.push(`- 不先调用 ext_skill 就直接使用 ext_call`);
+    lines.push(`- 不先调用 ext_skill/loadSkill 就直接使用 ext_call`);
 
     return lines.join('\n');
   }

package/subagent.md

@@ -111,7 +111,7 @@
 ## 【Extensions】扩展插件
 
 **使用流程（必须按顺序执行）：**
-1. 调用 `ext_skill({ skill: "插件名" })` 获取目标扩展的详细工具参数
+1. 调用  `ext_skill({ plugin: "<plugin_name>" })` 或 `loadSkill({ skill: "<skill_name>" })` 获取目标扩展的详细工具参数
 2. 根据返回的参数定义，使用 `ext_call({ plugin, tool, args })` 调用扩展
 
 > **警告**：禁止在未执行第1步获取参数的情况下直接调用 `ext_call`！
@@ -167,4 +167,4 @@ MCP (Model Context Protocol) 执行器
 **工具:** `designmd_search_design_kits`, `designmd_get_design_kit`, `designmd_download_design_kit`, `designmd_upload_design_kit`, `designmd_delete_design_kit`, `designmd_list_popular_kits`, `designmd_list_tags`
 
 ## 禁止事项
-- 不先调用 `ext_skill` 获取参数就直接使用 `ext_call`
+- 不先调用 `ext_skill/loadSkill` 获取参数就直接使用 `ext_call`