WorkBuddy Skill 安装指南:市场安装、GitHub 导入与不生效排查
发布于 2026-10-29 · 独立第三方评测 · 转载请注明出处
WorkBuddy Skill 的标准安装方式是在官方技能市场(Skills Market)里找到目标技能,点击 Install 一键安装;安装前 WorkBuddy 会自动执行安全扫描。 社区仓库的 skill 则通过导入方式安装。下面按场景展开。
方式一:官方市场一键安装(推荐新手)
- 打开 WorkBuddy,进入技能市场(Skills Market)
- 按名称或场景搜索目标 skill(如 web search、ppt)
- 进入技能详情,点击 Install
- 安装前系统自动执行安全扫描,通过后即可使用
官方市场同时收录官方技能和社区创建的技能,这也是本站必装榜单的主要来源。
方式二:社区/GitHub 仓库导入
GitHub 上的社区 skill(如本站收录的麦当劳省钱点餐助手)主要有三种入口,以仓库 README 为准:
- 对话指令安装:在 WorkBuddy 对话框输入仓库地址或安装指令,由 Agent 引导完成
- 市场源添加(自动同步):部分仓库支持配置为「市场源」——在工作区配置文件中添加
extraKnownMarketplaces指向仓库地址,重启后该仓库的全部技能直接出现在技能市场,随仓库更新自动同步 - 手动下载安装:下载技能包(.zip)解压,复制到本地技能目录(如
~/.workbuddy/plugins/marketplaces/下的对应文件夹),重启生效。落盘目录的完整结构与备份、卸载做法,见技能装在哪:~/.workbuddy 目录详解
选用哪种看需求:想长期跟进一个仓库用市场源;只想装其中一两个技能用手动下载。
手机端能装 Skill 吗?
WorkBuddy 有手机端,但技能的安装与管理建议在桌面端完成——手机端更适合下发任务、查看进度和接收结果。移动侧能力以官方客户端实际版本为准。
卸载 Skill
装错了、不用了,卸载同样简单:
- 官方市场安装的:在技能市场的「已安装」列表中找到目标技能,点击卸载
- 手动导入的:删除技能目录中对应的技能文件夹(或从市场源配置中移除该仓库)
- 卸载后新建会话,确认技能已从可用列表消失
卸载不会影响 WorkBuddy 本体和你的文件;曾授权过连接器的,记得顺手检查授权是否也需要收回。
方式三:自己写的 skill
按照 SKILL.md 开放标准写好技能文件夹后,放入本地技能目录或通过开发者入口加载,详细流程见开发入门。
装了不生效?排查清单
按命中率从高到低逐项检查:
- 重启会话:新装 skill 通常需要新建任务/会话才会被加载
- 触发词不匹配:skill 靠 description 匹配任务意图,试着在指令里明确提到能力关键词(如”用浏览器打开""转成 Excel”)
- 版本兼容:确认 WorkBuddy 为最新版本;老版本的技能目录结构可能不同
- 作用范围:部分 skill 只在特定工作模式或任务类型下可用
- 来源可靠性:非市场渠道安装的 skill,检查文件是否完整、是否缺少 SKILL.md
- 查看官方文档:功能入口和安装细节以官方 Skills Market 文档为准
安全提醒
- 优先从官方市场安装(自动安全扫描)
- 从社区安装前,浏览 SKILL.md 和脚本源码,警惕要求敏感权限(读取无关目录、联网上传本地文件)的技能
- 提交你的 skill 到本站榜单前,我们也会人工复核来源
下一步
装好基础能力后,去 Top 10 必装榜挑几件趁手的工具,或阅读 SKILL.md 开发入门做一个自己的技能。
常见问题
装了 Skill 不生效怎么办?
先新建会话再试;检查指令里是否包含技能关键词;仍不行按正文排查清单逐项核对。
社区 Skill 安全吗?
安装前审查源码与权限;通过官方市场安装会自动执行安全扫描。
可以装多少个 Skill?
无硬性上限,但建议按需安装——技能过多可能互相干扰触发。
装了的 Skill 怎么卸载?
官方市场安装的在市场「已安装」列表卸载;手动导入的删除对应技能文件夹后重启即可,详见正文卸载一节。
GitHub 上的 Skill 怎么装?
三种方式:对话指令安装、配置为市场源(自动同步仓库更新)、或下载技能包手动导入,以仓库 README 为准。