WorkBuddy技能包配置文件默认位于用户主工作区的skills/子目录下,Windows路径为C:\Users{用户名}\WorkBuddy\Claw\skills\,macOS路径为/Users/{用户名}/WorkBuddy/Claw/skills/,每个子文件夹对应一个技能,核心配置由SKILL.md定义。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您在使用 WorkBuddy 时需要自定义或调试技能包(Skill),但无法定位其配置文件路径,可能是由于安装结构或权限设置导致目录未被直观显示。以下是定位与修改 WorkBuddy 技能包配置文件的具体操作路径和方法:
一、默认技能包配置文件所在路径
WorkBuddy 的技能包以独立目录形式组织,所有用户可安装的 Skill 均存放于本地工作目录下的 skills/ 子目录中。该路径并非固定于安装目录,而是绑定于 WorkBuddy 初始化时设定的主工作区。
1、Windows 系统默认路径为:C:\Users\{用户名}\WorkBuddy\Claw\skills\
2、macOS 系统默认路径为:/Users/{用户名}/WorkBuddy/Claw/skills/
3、该目录下每个子文件夹即为一个 Skill,例如 paper-check/ 对应论文格式检查技能,其核心配置由 SKILL.md 文件定义。
二、通过 WorkBuddy 界面快速打开技能目录
此方法无需手动拼写路径,避免因用户名含空格或特殊字符导致访问失败,且自动适配当前授权工作区。
1、启动 WorkBuddy 并完成登录与文件夹授权
2、在侧边栏点击「技能中心」或「Skills」标签页
3、找到已安装的目标技能(如“论文格式检查”),鼠标悬停后点击右侧出现的「打开文件夹」图标
4、系统文件管理器将直接定位至该 Skill 对应的完整目录,包括 check_format.py、fix_format.py、generate_report.py 及 SKILL.md
三、修改技能配置文件的两种安全方式
直接编辑 SKILL.md 可调整触发关键词、执行流程顺序及参数默认值;修改 Python 脚本则影响底层行为逻辑。必须确保文件编码为 UTF-8 且无 BOM,否则可能引发解析异常。
1、使用 VS Code 或其他支持行号与语法高亮的编辑器打开 SKILL.md
2、查找 trigger_keywords: 字段,可在其下方添加中文关键词,例如增加 - 自动排版
3、若需变更修复逻辑,编辑 fix_format.py 中的 apply_font_rule() 函数体,例如将字号从小四改为五号
4、保存文件后,在 WorkBuddy 对话框中输入 重载技能 paper-check,AI 将重新加载配置并反馈校验结果
四、自定义技能包的存放位置规范
WorkBuddy 仅识别位于主工作区 skills/ 目录下的合法 Skill 结构。任意层级嵌套或命名不合规(如含空格、大写字母开头、无 SKILL.md)均会导致加载失败。
1、新建技能目录时,名称须全小写、用短横线分隔,例如:meeting-notes-cleaner
2、该目录内必须包含且仅包含以下四个文件:SKILL.md、main.py、requirements.txt、icon.png
3、在 SKILL.md 中,name: 字段值将作为技能在界面中显示的名称,支持中文
4、完成创建后,在 WorkBuddy 中输入 安装本地技能 ./skills/meeting-notes-cleaner 即可启用
五、验证配置文件是否生效的操作步骤
修改完成后,必须通过实际指令触发并观察响应内容,以确认新配置已被正确加载与解析,而非仅依赖文件保存动作。
1、在对话区域输入该技能的任一已配置触发词,例如:检查论文格式
2、WorkBuddy 将展示执行计划,其中第一步应明确列出所读取的 SKILL.md 路径
3、若计划中显示路径为 /skills/paper-check/SKILL.md,说明加载成功
4、若提示 未找到匹配技能 或路径指向旧版本缓存,则需检查是否遗漏重载指令或存在同名冲突技能










