WorkBuddy 技能装在哪:~/.workbuddy 目录结构与备份卸载

发布于 2026-11-16 · 独立第三方评测 · 转载请注明出处

直接回答:一个装好的 WorkBuddy Skill,就是一个顶层带 SKILL.md 的文件夹——官方市场一键安装的由客户端统一管理,社区导入的则落在你用户主目录下的 .workbuddy 相关目录里。本文讲清它的结构、位置和手动管理(备份/卸载/清理)的做法。路径信息基于公开社区资料与真实检索信号交叉印证,核实于 2026-11-16;不同客户端版本可能调整,删除或移动前请先备份,以你机器上的实际情况为准。

技能包长什么样

无论是官方市场还是社区仓库,技能包的形态是一致的:一个文件夹,顶层必须有 SKILL.md(说明技能是什么、何时触发、怎么执行),旁边放脚本和资源文件。这是开放格式,也是你能用文本编辑器读懂每一个技能的原因——写法详见 SKILL.md 制作流程。

公开市场归档仓库 infometa/workbuddyskills 从 WorkBuddy/CodeBuddy 公开市场打包了 295 个技能包,全部是这种”顶层 SKILL.md”结构,可以离线翻看学习(仅作学习用途,注意其版权声明)。

落盘位置

系统常见位置
macOS / Linux~/.workbuddy/(用户主目录下)
Windows%USERPROFILE%\.workbuddy\(如 C:\Users\你的用户名\.workbuddy\)

目录内的组织随安装方式不同:通过市场源自动同步的技能在 plugins/marketplaces/ 下的对应仓库文件夹;手动导入的则在技能目录下单独成文件夹。以你客户端的实际版本为准——如果目录结构和本文不一致,优先相信你机器上的,并在客户端技能详情里核对来源。

三个常见场景

备份与迁移(换电脑):整个 .workbuddy 目录拷到新机器同位置,重启客户端即可;官方市场安装的那部分不用拷,登录后重装更快。

手动卸载:官方市场安装的在市场「已安装」列表里卸载;手动导入的删除对应技能文件夹后重启生效,操作细节见安装指南的卸载一节。

排查不生效:先看技能文件夹在不在、SKILL.md 是否完好,再按装了不生效排查清单逐项核对;更细的故障现象(触发错乱、权限拒绝)查故障字典。

GitHub 仓库里的 skills/ ≠ 本地目录

搜索 ~/.workbuddy/skills 的人,不少是被 GitHub 仓库结构带偏的:社区仓库(如 bitcjm/workbuddy-skills)把几十个技能按分类放在仓库的 skills/ 目录里,那是仓库自己的归档结构。从仓库安装时按它的 README 指引走——常见做法是对话框贴仓库地址由 Agent 引导安装,或配置为市场源自动同步;复制到本地的,始终是一个个技能文件夹,而不是整个仓库。

清理与安全提醒

  1. 删文件夹前先备份:技能目录里可能混着你改过的配置和多个来源的技能,批量删除前整目录打包一份
  2. 来历不明的技能文件夹先读后用:打开 SKILL.md 和脚本扫一眼,警惕要求读取无关目录、联网上传本地文件的技能,完整避坑清单见技能下载攻略
  3. 别把 .workbuddy 当配置备份的唯一副本:换机、重装前先整体备份,客户端内的账号数据(积分、会员)不在技能目录里

常见问题

WorkBuddy 技能文件夹可以直接改吗?

技术上可以(SKILL.md 就是文本),但官方市场安装的技能在更新时会被覆盖,改动前先备份;改完重启客户端生效。

~/.workbuddy 目录找不到怎么办?

先确认已安装过技能;Windows 在 %USERPROFILE%\.workbuddy,macOS/Linux 在 ~/.workbuddy。仍找不到就在客户端技能详情里查看来源,以客户端展示为准。

能跳过市场手动装技能吗?

可以,三种方式:对话指令安装、配置为市场源自动同步、下载技能包复制到技能目录后重启,详见安装指南。

GitHub 仓库里的 skills/ 目录是什么?

那是仓库自己的归档结构,不是客户端落盘目录;从仓库安装时按 README 指引走,复制的是一个个含 SKILL.md 的技能文件夹。