foliko 1.1.69 → 1.1.71

package/cli/src/ui/chat-ui.js

@@ -90,28 +90,25 @@ class ChatUI {
     this.sessionId = options.sessionId || 'cli_default';
     this.sessionPlugin = null;
 
-    // 获取 skill 命令列表
-    const skillCommands = [];
-    if (agent.framework) {
-      const extExecutor = agent.framework.pluginManager?.get('extension-executor');
-      if (extExecutor && typeof extExecutor.getSkillCommands === 'function') {
-        skillCommands.push(...extExecutor.getSkillCommands());
-      }
-    }
+    // 获取 skill 命令列表（保存到 this，供后续刷新）
+    this.skillCommands = [];
+    this._refreshSkillCommands(agent.framework);
 
-    const baseCommands = [
+    const baseCommands = this.baseCommands = [
       { name: "compress", description: "压缩记录" },
       { name: "clear", description: "清除记录" },
       { name: "exit", description: "退出" },
+      { name: "help", description: "显示帮助信息" },
+      { name: "reload", description: "重载技能" },
     ];
 
-    const autocompleteProvider = new CombinedAutocompleteProvider(
-      [...baseCommands, ...skillCommands],
+    this.autocompleteProvider = new CombinedAutocompleteProvider(
+      [...baseCommands, ...this.skillCommands],
       process.cwd(),
     );
-    
+
     const editor=this.editor = new Editor(this.tui, editorTheme,{paddingX:1});
-    editor.setAutocompleteProvider(autocompleteProvider);
+    this.editor.setAutocompleteProvider(this.autocompleteProvider);
     this.editor.onSubmit=this.handleOnSubmit.bind(this)
     this.tui.addChild(this.editor);
     this.tui.setFocus(this.editor);
@@ -230,6 +227,13 @@ class ChatUI {
         }
       };
       agent.framework.on('agent:usage', this._usageHandler);
+
+      // 监听 skill 热重载事件，刷新 autocomplete
+      this._skillReloadedHandler = () => {
+        this._refreshSkillCommands(agent.framework);
+        this._refreshAutocomplete();
+      };
+      agent.framework.on('skill:reloaded', this._skillReloadedHandler);
     }
   }
 
@@ -254,6 +258,10 @@ class ChatUI {
       this.agent.framework.off('agent:usage', this._usageHandler);
       this._usageHandler = null;
     }
+    if (this._skillReloadedHandler && this.agent.framework) {
+      this.agent.framework.off('skill:reloaded', this._skillReloadedHandler);
+      this._skillReloadedHandler = null;
+    }
   }
 
   clear_message_done(){
@@ -305,6 +313,20 @@ class ChatUI {
       return true;
     }
 
+    if (cmd === '/reload') {
+      try {
+        const result = await this.agent.framework.executeTool('reloadSkills', {});
+        if (result.success !== false) {
+          this.create_message(`${colored('[提示]', CYAN)} 技能已重载\n`,chalk.dim('● '))
+        } else {
+          this.create_message(`${colored('[错误]', RED)} 重载失败: ${result.error}\n`,chalk.dim('● '))
+        }
+      } catch (err) {
+        this.create_message(`${colored('[错误]', RED)} 重载失败: ${err.message}\n`,chalk.dim('● '))
+      }
+      return true;
+    }
+
     // /help 命令显示所有注册的命令
     if (cmd === '/help') {
       const { getCommandRegistry } = require('../../../src/core/command-registry');
@@ -312,17 +334,18 @@ class ChatUI {
       const commands = registry.getAllCommands();
 
       let helpText = `${colored('[帮助]', CYAN)} 可用命令:\n`;
-      helpText += `  ${colored('/clear', CYAN)} - 清除对话上下文\n`;
-      helpText += `  ${colored('/compress', CYAN)} - 压缩上下文\n`;
-      helpText += `  ${colored('/exit', CYAN)} - 退出\n`;
+      this.baseCommands.forEach(c => {
+        helpText += `  ${colored('/' + c.name, CYAN)} - ${c.description}\n`;
+      })
+
 
       // 添加 skill 命令
       const extExecutor = this.agent.framework?.pluginManager?.get('extension-executor');
-      if (extExecutor && typeof extExecutor.getSkillCommandsHelp === 'function') {
-        const skillHelp = extExecutor.getSkillCommandsHelp();
-        if (skillHelp) {
+      if (extExecutor && typeof extExecutor.getSkillCommands === 'function') {
+        const skillCommands = extExecutor.getSkillCommands();
+        if (skillCommands.length > 0) {
           helpText += `\n${colored('[技能命令]', CYAN)}\n`;
-          helpText += skillHelp.split('\n').map(line => `  ${line}`).join('\n') + '\n';
+          helpText += skillCommands.map(cmd => `  ${colored('/' + cmd.name, CYAN)} - ${cmd.description || '无描述'}`).join('\n') + '\n';
         }
       }
 
@@ -350,7 +373,10 @@ class ChatUI {
             args: { args: cmdArgs }
           });
           if (result.success !== false) {
-            this.create_message(`${colored('[结果]', CYAN)} ${result.data || result}\n`, chalk.dim('● '));
+            this.create_message(`${colored('[指令] '+cmdName, CYAN)}\n\n ${result.data || result}\n`, chalk.green('● '));
+            return true;
+          }else{
+            this.create_message(`${colored('[指令] '+cmdName, RED)}\n\n ${result.error || '未知错误'}\n`, chalk.red('● '));
             return true;
           }
         } catch (err) {
@@ -371,10 +397,10 @@ class ChatUI {
             framework: this.agent.framework,
           };
           registry.execute(cmdName, cmdArgs, context).catch(err => {
-            this.create_message(`${colored('[命令错误]', 'red')} ${err.message}\n`, chalk.dim('● '));
+            this.create_message(`${colored('[命令错误]', 'red')} ${err.message}\n`, chalk.red('● '));
           });
         } catch (err) {
-          this.create_message(`${colored('[命令错误]', 'red')} ${err.message}\n`, chalk.dim('● '));
+          this.create_message(`${colored('[命令错误]', 'red')} ${err.message}\n`, chalk.red('● '));
         }
         return true;
       }
@@ -557,6 +583,32 @@ class ChatUI {
       this.statusBar.tooler.setText(`${colored('[错误]', RED)} 无 AgentChatHandler`);
     }
   }
+  /**
+   * 刷新 skill 命令列表（用于热重载）
+   */
+  _refreshSkillCommands(framework) {
+    this.skillCommands = [];
+    if (!framework) return;
+    const extExecutor = framework.pluginManager?.get('extension-executor');
+    if (extExecutor && typeof extExecutor.getSkillCommands === 'function') {
+      this.skillCommands.push(...extExecutor.getSkillCommands());
+    }
+  }
+
+  /**
+   * 刷新自动补全提供者（skill 命令热重载时调用）
+   */
+  _refreshAutocomplete() {
+    if (!this.editor) return;
+;
+    // 重新构建 CombinedAutocompleteProvider 并更新引用
+    const { CombinedAutocompleteProvider } = require('@earendil-works/pi-tui');
+    this.autocompleteProvider = new CombinedAutocompleteProvider(
+      [...this.baseCommands, ...this.skillCommands],
+      process.cwd()
+    );
+    this.editor.setAutocompleteProvider(this.autocompleteProvider);
+  }
   /**
    * 刷新流式输出缓冲区：合并高频 chunk 后统一渲染，减少 Markdown 重复解析
    */

package/package.json

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

package/plugins/extension-executor-plugin.js

@@ -42,6 +42,11 @@ class ExtensionExecutorPlugin extends Plugin {
       log.debug('Framework ready, rescanning all plugin tools...');
       const plugins = framework.pluginManager.getAll();
       for (const { instance: plugin } of plugins) {
+        // skill-manager 插件的工具已通过 Skill.registerCommands 直接注册，
+        // 不需要再通过 _scanPluginTools 扫描，避免重复注册
+        if (plugin.name === 'skill-manager') {
+          continue;
+        }
         this._scanPluginTools(plugin);
       }
       // 刷新所有 Agent 的扩展提示词
@@ -53,8 +58,10 @@ class ExtensionExecutorPlugin extends Plugin {
 
   /**
    * 扫描插件的 this.tools 并注册到扩展系统
+   * @param {Object} plugin - 插件实例
+   * @param {string} [extName] - 可选的扩展名（用于统一命名）
    */
-  _scanPluginTools(plugin) {
+  _scanPluginTools(plugin, extName) {
     if (!plugin || !plugin.tools || typeof plugin.tools !== 'object') {
       return;
     }
@@ -62,9 +69,12 @@ class ExtensionExecutorPlugin extends Plugin {
     const pluginName = plugin.name;
     if (!pluginName) return;
 
+    // 确定扩展名：优先使用 extName，否则使用 pluginName
+    const useExtName = extName || pluginName;
+
     // 获取插件信息
     const pluginInfo = {
-      name: plugin.name,
+      name: useExtName,
       description: plugin.description || '',
       version: plugin.version || '1.0.0',
     };
@@ -73,7 +83,7 @@ class ExtensionExecutorPlugin extends Plugin {
     for (const [toolName, toolDef] of Object.entries(plugin.tools)) {
       if (!toolDef || typeof toolDef !== 'object') continue;
 
-      this.registerTool(pluginName, pluginInfo, {
+      this.registerTool(useExtName, pluginInfo, {
         name: toolName,
         description: toolDef.description || '',
         inputSchema: toolDef.inputSchema,
@@ -81,7 +91,7 @@ class ExtensionExecutorPlugin extends Plugin {
       });
     }
 
-    log.debug(` Scanned ${Object.keys(plugin.tools).length} tools from plugin '${pluginName}'`);
+    log.debug(` Scanned ${Object.keys(plugin.tools).length} tools from plugin '${pluginName}' (as '${useExtName}')`);
 
     // 刷新所有 Agent 的扩展提示词
     if (this._framework && this._framework._ready) {
@@ -100,21 +110,27 @@ class ExtensionExecutorPlugin extends Plugin {
     const pluginName = plugin.name;
     if (!pluginName) return;
 
-    // 先移除旧工具
-    if (this._extensions.has(pluginName)) {
-      const ext = this._extensions.get(pluginName);
-      for (const tool of ext.tools || []) {
-        // 从 toolRouter 移除
-        if (this._framework?.toolRouter) {
-          this._framework.toolRouter.unregister(`ext_${tool.name}`);
+    // skill-manager 插件使用 'skill' 作为扩展名（保持与 Skill.registerCommands 一致）
+    const extName = pluginName === 'skill-manager' ? 'skill' : pluginName;
+
+    // 先移除旧工具（同时检查 'skill' 和 'skill-manager' 两个扩展名）
+    const keysToRemove = [extName, pluginName];
+    for (const key of keysToRemove) {
+      if (this._extensions.has(key)) {
+        const ext = this._extensions.get(key);
+        for (const tool of ext.tools || []) {
+          // 从 toolRouter 移除
+          if (this._framework?.toolRouter) {
+            this._framework.toolRouter.unregister(`ext_${tool.name}`);
+          }
         }
+        this._extensions.delete(key);
       }
-      this._extensions.delete(pluginName);
     }
 
-    // 重新扫描工具
-    this._scanPluginTools(plugin);
-    log.info(` Rescanned tools from plugin '${pluginName}'`);
+    // 重新扫描工具，使用正确的扩展名
+    this._scanPluginTools(plugin, extName);
+    log.info(` Rescanned tools from plugin '${pluginName}' (as '${extName}')`);
   }
 
   async start(framework) {
@@ -237,7 +253,7 @@ class ExtensionExecutorPlugin extends Plugin {
             name,
             description: ext.description,
             version: ext.version,
-            tools: ext.tools.map((t) => ({ name: t.name, description: t.description })),
+            tools: ext.tools.filter(t => t && t.name).map((t) => ({ name: t.name, description: t.description })),
           });
         }
         return { success: true, data: extensions };
@@ -275,6 +291,11 @@ class ExtensionExecutorPlugin extends Plugin {
   }
 
   registerTool(pluginName, pluginInfo, toolDef) {
+    if (!toolDef || !toolDef.name) {
+      log.warn(`[ExtensionExecutor] Invalid tool definition for '${pluginName}'`);
+      return;
+    }
+
     if (!this._extensions.has(pluginName)) {
       this._extensions.set(pluginName, {
         name: pluginInfo.name || pluginName,
@@ -392,7 +413,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';
 
@@ -401,6 +422,8 @@ class ExtensionExecutorPlugin extends Plugin {
           // Skill 命令按技能名分组显示
           const toolsBySkill = {};
           for (const tool of ext.tools) {
+            // 跳过无效工具
+            if (!tool || !tool.name) continue;
             // 命令格式: skillname:cmdname
             const parts = tool.name.split(':');
             const skillName = parts[0];
@@ -425,7 +448,8 @@ class ExtensionExecutorPlugin extends Plugin {
         } else {
           desc += `### ${ext.name || name}\n`;
           desc += `${ext.description || '无描述'}\n`;
-          desc += `**工具:** ${ext.tools.map(t => `\`${t.name}\``).join(', ')}\n\n`;
+          const validTools = ext.tools.filter(t => t && t.name);
+          desc += `**工具:** ${validTools.map(t => `\`${t.name}\``).join(', ')}\n\n`;
         }
       }
 
@@ -437,7 +461,7 @@ class ExtensionExecutorPlugin extends Plugin {
       }
 
       desc += '\n## 禁止事项\n';
-      desc += '- 不先调用 `ext_skill` 获取参数就直接使用 `ext_call`\n';
+      desc += '- 不先调用 `ext_skill/loadSkill` 获取参数就直接使用 `ext_call`\n';
     }
 
     if (!desc) {
@@ -568,10 +592,12 @@ class ExtensionExecutorPlugin extends Plugin {
   getSkillCommands() {
     const ext = this._extensions.get('skill');
     if (!ext) return [];
-    return ext.tools.map(t => ({
-      name: t.name.replace(/^([^:]+):(.*)$/, '$1:$2'),
-      description: t.description || t.name,
-    }));
+    return ext.tools
+      .filter(t => t && t.name)
+      .map(t => ({
+        name: t.name.replace(/^([^:]+):(.*)$/, '$1:$2'),
+        description: t.description || t.name,
+      }));
   }
 
   /**
@@ -583,6 +609,7 @@ class ExtensionExecutorPlugin extends Plugin {
 
     const lines = [];
     for (const tool of ext.tools) {
+      if (!tool || !tool.name) continue;
       const parts = tool.name.split(':');
       if (parts.length === 2) {
         lines.push(`/${parts[0]}:${parts[1]} - ${tool.description || '无描述'}`);

package/plugins/feishu-plugin.js

@@ -210,6 +210,14 @@ class FeishuPlugin extends Plugin {
       case 'compress':
         await this._compressSessionContext(openId)
         break
+      case 'reload':
+        try {
+          await this._framework.executeTool('reloadSkills', {})
+          await this._sendMessage(openId, '✅ 技能已重载', originalMsg)
+        } catch (err) {
+          await this._sendMessage(openId, '❌ 重载失败: ' + err.message, originalMsg)
+        }
+        break
       case 'history':
         if (this._sessionPlugin) {
           const session = this._sessionPlugin.getSession(`feishu_${openId}`)
@@ -512,7 +520,7 @@ class FeishuPlugin extends Plugin {
     const extExecutor = this._framework?.pluginManager?.get('extension-executor')
     const skillHelp = extExecutor?.getSkillCommandsHelp?.() || ''
 
-    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/start - 显示帮助\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/history - 查看历史消息数'
+    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/start - 显示帮助\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/reload - 重载技能\n/history - 查看历史消息数'
 
     if (skillHelp) {
       helpText += '\n\n【技能命令】\n' + skillHelp.split('\n').map(line => line.replace(/^\//, '/')).join('\n')

package/plugins/qq-plugin.js

@@ -701,6 +701,14 @@ class QQPlugin extends Plugin {
       case 'compress':
         await this._compressSessionContext(openid)
         break
+      case 'reload':
+        try {
+          await this._framework.executeTool('reloadSkills', {})
+          await this._sendMessage(openid, '✅ 技能已重载')
+        } catch (err) {
+          await this._sendMessage(openid, '❌ 重载失败: ' + err.message)
+        }
+        break
       case 'history':
         const sessionInfo = this._getSessionAgent(openid)
         if (sessionInfo && this._framework) {
@@ -752,7 +760,7 @@ class QQPlugin extends Plugin {
     const extExecutor = this._framework?.pluginManager?.get('extension-executor')
     const skillHelp = extExecutor?.getSkillCommandsHelp?.() || ''
 
-    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/history - 查看历史消息数'
+    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n\n可用命令：\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/reload - 重载技能\n/history - 查看历史消息数'
 
     if (skillHelp) {
       helpText += '\n\n【技能命令】\n' + skillHelp.split('\n').map(line => line.replace(/^\//, '/')).join('\n')

package/plugins/subagent-plugin.js

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

package/plugins/telegram-plugin.js

@@ -322,6 +322,14 @@ class TelegramPlugin extends Plugin {
       case 'compress':
         await this._compressSessionContext(chatId, msg.message_id)
         break
+      case 'reload':
+        try {
+          await this._framework.executeTool('reloadSkills', {})
+          await this._sendMessage(chatId, '✅ 技能已重载', msg.message_id)
+        } catch (err) {
+          await this._sendMessage(chatId, '❌ 重载失败: ' + err.message, msg.message_id)
+        }
+        break
       case 'history':
         const sessionInfo = this._getSessionAgent(chatId)
         if (sessionInfo && this._framework) {
@@ -525,7 +533,7 @@ class TelegramPlugin extends Plugin {
     const extExecutor = this._framework?.pluginManager?.get('extension-executor')
     const skillHelp = extExecutor?.getSkillCommandsHelp?.() || ''
 
-    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/history - 查看历史消息数'
+    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/reload - 重载技能\n/history - 查看历史消息数'
 
     if (skillHelp) {
       helpText += '\n\n【技能命令】\n' + skillHelp.split('\n').map(line => line.replace(/^\//, '/')).join('\n')

package/plugins/weixin-plugin.js

@@ -601,6 +601,14 @@ class WeixinPlugin extends Plugin {
       case 'compress':
         await this._compressSessionContext(userId)
         break
+      case 'reload':
+        try {
+          await this._framework.executeTool('reloadSkills', {})
+          await this._sendMessageBatch(originalMsg, userId, '✅ 技能已重载', true)
+        } catch (err) {
+          await this._sendMessageBatch(originalMsg, userId, '❌ 重载失败: ' + err.message, true)
+        }
+        break
       case 'history':
         const sessionInfo = this._getSessionAgent(userId)
         if (sessionInfo && this._framework) {
@@ -634,7 +642,7 @@ class WeixinPlugin extends Plugin {
     const extExecutor = this._framework?.pluginManager?.get('extension-executor')
     const skillHelp = extExecutor?.getSkillCommandsHelp?.() || ''
 
-    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/history - 查看历史消息数'
+    let helpText = '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/clean - 清除对话上下文\n/compress - 压缩上下文\n/reload - 重载技能\n/history - 查看历史消息数'
 
     if (skillHelp) {
       helpText += '\n\n【技能命令】\n' + skillHelp.split('\n').map(line => line.replace(/^\//, '/')).join('\n')

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,8 +196,7 @@ class Skill {
           };
         }
 
-        // 注册到 extension 系统，通过 ext_call 调用
-        extExecutor.registerTool('skill', skillInfo, {
+        const toolDef = {
           name: fullName,
           description: cmd.description || `Skill command: ${fullName}`,
           inputSchema: z.object({
@@ -215,7 +215,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 +253,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 +633,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 +832,13 @@ class SkillManagerPlugin extends Plugin {
     this._loaded = false;
     this._framework = framework;
     this._loadAllSkills();
+
+    // 通知 extension-executor 重载 skill 命令（通过监听器自动处理）
+    // 注意：skill 命令已经在 registerCommands() 中直接注册到 extension-executor，
+    // 不需要再调用 _rescanPluginTools
+
+    // 通知 UI 刷新 skill 命令（用于 autocomplete 热重载）
+    framework.emit('skill:reloaded', { skills: Array.from(this._skills.keys()) });
   }
 
   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`