Workbuddy技能包导入教程详解

WorkBuddy 提供了灵活高效的技能导入方案，无论你是初次上手的新用户还是追求自动化的高级开发者，都能找到最适合的方式——从直观拖拽单个技能包，到批量导入并实时查看校验日志，再到通过 workbuddy-cli 命令行实现静默部署，全程围绕标准 .skill.json 格式与 MCP 规范展开，确保兼容性与可靠性；尤其适合希望复用 OpenClaw 等现有技能资源的用户，只需几步简单操作，即可快速激活新能力，真正让工作流更智能、更高效。

如果您已拥有 OpenClaw 或其他兼容格式的技能包（Skills），希望在 WorkBuddy 中复用已有能力，则需通过本地导入方式加载技能文件。以下是完成技能导入的具体操作步骤：

一、确认技能包格式与存放路径

WorkBuddy 仅支持标准 JSON 格式的技能定义文件，文件名须以 .skill.json 结尾，且内容结构需符合 MCP 协议规范。导入前请将技能包文件统一存放于本地易访问目录（如桌面或文档文件夹），避免路径含中文、空格或特殊符号。

1、检查技能文件扩展名是否为 .skill.json；

2、用文本编辑器打开该文件，确认根对象包含 "name"、"description"、"triggers" 和 "steps" 四个必填字段；

3、确保文件未被其他程序占用或设置为只读属性。

二、通过主界面拖拽方式导入

此方法适用于单个或少量技能包导入，操作最直观，无需进入设置菜单。WorkBuddy 主窗口支持原生拖放识别，可自动解析并校验技能结构。

1、打开 WorkBuddy 桌面客户端，确保已登录并进入主界面；

2、将准备好的 .skill.json 文件直接拖入 WorkBuddy 主窗口中央空白区域；

3、松开鼠标后，界面弹出绿色提示条显示 “技能校验通过，正在注册…”；

4、约2秒后提示变为 “导入成功：[技能名称] 已启用”，该技能即刻出现在侧边栏“技能库”中。

三、通过设置面板手动选择导入

当需批量导入多个技能或需查看详细导入日志时，应使用设置面板路径。该方式支持一次选择多个文件，并对失败项给出具体错误原因。

1、点击右上角个人头像，选择 “设置”；

2、在左侧菜单中点击 “技能管理”；

3、在右侧区域点击 “+ 导入本地技能” 按钮；

4、在系统文件选择窗口中，按住 Ctrl（Windows）或 Command（macOS）键多选多个 .skill.json 文件，点击“打开”；

5、WorkBuddy 逐个校验并显示每项结果，成功项标记为 ✅ 已激活，失败项显示红色错误码（如 ERR_SCHEMA_MISMATCH）及说明。

四、通过命令行工具导入（高级用户）

适用于自动化部署场景或集成 CI/CD 流程。该方式绕过图形界面，直接调用内置 CLI 模块，支持静默模式与路径通配符。

1、打开终端（Windows 使用 PowerShell，macOS 使用 Terminal）；

2、执行命令：workbuddy-cli skill import --path "/Users/xxx/Skills/*.skill.json"；

3、若当前环境未识别 workbuddy-cli，请先运行 workbuddy --install-cli 安装命令行工具；

4、命令执行完成后，终端输出汇总报告，包括导入总数、成功数、跳过数及首个失败项详情。

文中关于Workbuddy的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Workbuddy技能包导入教程详解》文章吧，也可关注golang学习网公众号了解相关技术文章。