WorkBuddy怎么安装Skill

WorkBuddy 安装 Skill 的途径有好几条，我按从省事到麻烦的顺序说一下，你可以根据自己的情况选。

动手之前先花一分钟做三件事，能省掉后面不少麻烦。确认客户端已经登录，Skill 的搜索和安装都依赖账号会话，没登录的话搜索接口会直接返回空结果，表现就是怎么搜都搜不到。确认运行环境存在，多数 Skill 最终会调用 Python 或 Node 来执行脚本，装之前先在终端里跑一下 python --version 和 node --version，如果其中一个提示 command not found，先把对应的运行时装好再回来。确认技能目录可写，Skill 文件通常写入 ~/.workbuddy/skills/ 用户级目录，或者当前项目的 .workbuddy/skills/ 项目级目录，确保对应目录有写权限，否则安装会静默失败。

最省事的方式是用自然语言直接安装。打开 WorkBuddy，在对话框里描述你要什么技能就行，比如输入“帮我查找并自动安装 cloudq skill”，它会自动搜索并完成安装，整个过程不需要额外操作。安装完成后技能会出现在技能列表里。你也可以先让它搜再决定装不装，比如说“帮我找一下处理 PDF 的 skill”，它会自动搜索并展示列表，你确认之后再让它安装。

另一个常用方法是通过技能市场安装。WorkBuddy 左侧边栏有一个技能市场，有时叫“专家·技能·连接器”，进去之后能看到推荐技能列表，找到需要的技能，点击卡片上的加号或安装按钮就行。这个过程很快，一键完成，适合大多数内置或官方推荐的技能。

如果自动安装遇到问题，或者你拿到了别人发来的技能包，可以手动上传。先把 .zip 技能包保存到本地，打开 WorkBuddy 左侧的技能页面，点击右上角的添加技能或上传技能，把 .zip 文件拖进上传框，等待自动校验和安装完成。如果弹窗提示第三方技能权限，点允许就行。导入后系统会自动完成配置，不需要额外操作。

熟悉命令行的开发者，可以用 npx skills 工具从 GitHub 安装。搜索技能的格式是 npx skills find "关键词"，安装的格式是 npx skills add <owner/repo@skill> -g -y。其中 -g 表示全局安装，也就是用户级别，-y 跳过确认提示。装完之后用 ls ~/.workbuddy/skills/ 验证一下，能看到新装的技能目录就说明成功了。你也可以直接对 WorkBuddy 说“帮我安装 janjaszczuk/cursor@vanilla-web”，它会自动执行安装命令。

还有一种情况是从 GitHub 仓库克隆之后，把需要的技能目录直接复制到 ~/.workbuddy/skills/ 下面，刷新 WorkBuddy 就能在对话里调用了。这种方式适合批量安装，或者你有自己的技能源仓库要维护。

有几个容易踩的坑需要留意。搜索关键词别太长，搜“备份我电脑上的文档”这种长句往往什么都搜不到，技能市场的检索更像标签匹配，用“备份”“日志”“表格”这类名词短词命中率更高。装完不生效的话，先重新发起对话，有些 Skill 安装后需要新开一个对话才会加载，当前对话里继续说可能没反应，最简单的办法是说一句“接下来用某某 Skill 帮我处理某某”，重新激活一下。注意技能重名，如果你已经有一个叫 backup 的技能，再装一个同名的，后装的会覆盖前者，安装前可以用一句话让 WorkBuddy 列出已装技能，确认没有重名再装。脚本依赖要单独装，技能本体只是说明加脚本，它运行的 Python 脚本可能依赖 requests、openpyxl 这类第三方库，装技能本身不会自动装这些依赖，运行到一半报 ModuleNotFoundError 的时候，看技能目录里的 SKILL.md 或 requirements.txt，手动补装就行。

日常使用最顺手的是自然语言安装和技能市场安装，说句话或者点一下就能装好。手动上传和 GitHub 安装留给自动装不上或者需要特定版本的情况。把上面这些步骤和注意事项过一遍，安装 Skill 基本不会卡住。