WorkBuddy 技能系统深度指南：搜索、安装、创建自定义技能全流程

一、前言

WorkBuddy 的技能（Skill）系统是其最强大的功能之一——它让 WorkBuddy 从一个通用 AI 助手变成拥有专业领域知识的"专家"。但很多新手卡在第一步：技能到底在哪找？怎么装？装不上怎么办？

这篇文章从零开始，完整走一遍搜索技能 → 安装技能 → 本地创建技能的全流程，附带我在公司内网环境下的踩坑记录和解决方案。

二、技能是什么

WorkBuddy 的技能是一个 SKILL.md 文件（加上可选的脚本/参考资料/资源文件），存放在 ~/.workbuddy/skills/<技能名>/ 目录下。当你触发某个任务时，WorkBuddy 会自动加载匹配的技能，按照其中的流程指引来工作。

技能提供了三样东西：

1. 专业领域知识——让 WorkBuddy 懂行
2. 标准化工作流——每一步该做什么
3. 可复用资源——模板、脚本、参考文档

三、搜索技能

3.1 在 WorkBuddy 对话中搜索

直接对 WorkBuddy 说：

"帮我找制作网页的技能" "有没有能做 UI 设计的技能"

WorkBuddy 会自动匹配并调用 find-skills 技能，搜索开源技能生态。

3.2 使用 skills CLI 搜索（推荐）

打开终端，运行：

npx skills find "web design"

输出示例：

Install with npx skills add <owner/repo@skill>

ulpi-io/skills@frontend-design-ui-ux 899 installs
└ https://skills.sh/ulpi-io/skills/frontend-design-ui-ux

giuseppe-trisciuoglio/developer-kit@tailwind-css-patterns 12.4K installs
└ https://skills.sh/giuseppe-trisciuoglio/developer-kit/tailwind-css-patterns

搜索技巧： 用具体关键词比泛关键词好。搜 "react testing" 比 "testing" 更精准。

3.3 搜索关键词参考

四、安装技能

4.1 标准安装（需能访问 GitHub）

npx skills add <owner/repo@skill> -g -y

参数说明：

• -g：全局安装（用户级别）
• -y：跳过确认提示

示例：

npx skills add janjaszczak/cursor@vanilla-web -g -y

装完验证：

ls ~/.workbuddy/skills/
# 应该能看到新装的技能目录

4.2 通过 WorkBuddy 对话安装

对 WorkBuddy 说：

"帮我安装 janjaszczak/cursor@vanilla-web"

WorkBuddy 会自动执行安装命令。

五、踩坑实录：GitHub 连不上怎么办

问题现象

在公司内网环境下，npx skills install 卡在 Cloning repository... 然后报错：

Failed to clone https://github.com/xxx/xxx.git:
Failed to connect to github.com port 443 after 75001 ms:
Couldn't connect to server

原因

公司防火墙屏蔽了 GitHub 的 443 端口。

解决方案 A：使用 VPN 或代理

配置代理后重试：

# 设置 Git 代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

# 安装技能
npx skills add janjaszczak/cursor@vanilla-web -g -y

安装完后记得取消代理：

git config --global --unset http.proxy
git config --global --unset https.proxy

解决方案 B：WorkBuddy 本地创建技能（免 GitHub）

这是最彻底的方案——利用 WorkBuddy 自带的 skill-creator 技能在本地直接创建，完全不依赖外网。

操作步骤如下。

六、本地创建自定义技能（核心教程）

以下是我实测完整流程，以创建"原生网页开发（vanilla-web）"技能为例。

6.1 加载 skill-creator

在 WorkBuddy 对话中输入：

"帮我创建一个技能"

WorkBuddy 会自动加载内置的 skill-creator 技能。

6.2 初始化技能目录

# skill-creator 脚本路径
python3 /Applications/WorkBuddy.app/Contents/Resources/app.asar.unpacked/resources/builtin-skills/skill-creator/scripts/init_skill.py vanilla-web --path ~/.workbuddy/skills/

输出：

✅ Created skill directory: ~/.workbuddy/skills/vanilla-web
✅ Created SKILL.md
✅ Created scripts/example.py
✅ Created references/api_reference.md
✅ Created assets/example_asset.txt

6.3 编写 SKILL.md

这是技能的核心文件。使用标准的 YAML frontmatter + Markdown 格式：

---
name: vanilla-web
description: 纯 HTML/CSS/JS 网页开发技能。使用 ES Module 模块化、无框架依赖，适用于静态页面、小 UI 组件、快速原型。
agent_created: true
---

关键点： agent_created: true 必须加上，否则 WorkBuddy 后续无法修改这个技能。

然后按以下结构编写内容：

# 技能名称

## 适用场景
列出触发条件，让 WorkBuddy 知道什么时候用这个技能。

## 核心约束
设定不可变规则，比如"只用 HTML/CSS/JS，不用框架"。

## 工作流
分步骤描述执行流程，比如：
1. 确认需求
2. 按规范拆分文件
3. 生成代码
4. 验证清单

## 验证清单
交付前必须检查的项目。

6.4 清理示例文件

初始化脚本生成了示例脚本和资源文件，不需要的话直接删掉：

rm -rf ~/.workbuddy/skills/vanilla-web/scripts
rm -rf ~/.workbuddy/skills/vanilla-web/references
rm -rf ~/.workbuddy/skills/vanilla-web/assets

6.5 验证安装

ls ~/.workbuddy/skills/

你应该能看到新创建的技能目录。现在在对话中说相关需求，WorkBuddy 就会自动加载这个技能了。

七、真实案例：我创建的三把斧头

结合我的实际项目（澳门中小企业本地化 AI 业务终端），我创建了三个互补的技能：

工作流示例：

1. 先调用 frontend-design-ui-ux 输出设计规范
2. 再调用 vanilla-web 按规范写代码
3. 最后用 tailwind-css-patterns 优化样式

三个技能各司其职，代码 + 设计 + 样式全覆盖。

八、技能使用技巧

8.1 自动触发 vs 手动触发

WorkBuddy 会自动匹配你的需求到最合适的技能，但你也可以用 @技能名 手动指定：

用 vanilla-web 帮我做一个产品展示页
# 这样 WorkBuddy 会自动匹配 vanilla-web 技能

8.2 查看已安装的技能

ls ~/.workbuddy/skills/

8.3 修改已有技能

直接编辑 SKILL.md 文件即可。WorkBuddy 下次触发时会自动读取最新内容。

九、总结

WorkBuddy 的技能系统让 AI 助手具备了领域专家的能力。无论你是从开源社区安装现成技能，还是根据自己的项目自定义创建，流程都很清晰：

搜索 → 安装（或本地创建）→ 使用 → 迭代优化

踩坑总结：

• GitHub 连不上？用 VPN 代理或本地创建
• agent_created: true 别忘了加
• SKILL.md 的 description 字段决定技能被自动匹配的概率，写得越准确越好
• 简单任务不需要装技能，WorkBuddy 本身就能做