WorkBuddy Skill 实战指南：从提示词到自动化工作台

把 WorkBuddy 从“一个能聊天的 AI 客户端”升级成“真正能代替你完成重复工作的个人工作台”，关键往往不在模型本身，而在于 Skill。Skill 在 WorkBuddy 里的角色，类似 Claude Code 的 skill、Codex 的 AGENTS.md 规则，也类似很多 Agent 框架里的插件，它把一组稳定的指令、规则、示例和脚本打包成一个可以被 AI 反复调用的能力单元。下面从安装配置、Skill 工作原理讲起，给出一份适合日常开发和工作场景的 15 个 Skill 推荐清单，再演示如何手写一个自己的 Skill，最后处理加载失败、乱码、规则不生效等常见维护问题。

1. 先理解 WorkBuddy Skill 到底是什么

Skill 是 WorkBuddy 里最容易上手、也最容易用错的功能。很多人把它理解成“一段很长的提示词”，实际上 Skill 是一个更完整的工程单元：它包含给模型的指令、触发的场景说明、可选的示例文件，甚至还能带上可执行的脚本。理解这一点，后面写 Skill 和排查问题都会顺利很多。

1.1 从 AI 助手的固定指令到可复用技能包

普通的自定义指令适合解决一次性问题。比如“以后给我写周报时，语气改成简洁一点”，这就是一条指令。但如果你想稳定复现一套完整流程，比如“读取今日工作记录，生成复盘报告，再根据复盘内容拆出明日计划”，每次靠对话重新描述会很累，而且模型不一定每次都按同样顺序执行。

Skill 的价值在于把流程固化。一个 Skill 至少包含三样东西：

• 一段结构化的指令，告诉模型遇到什么场景时使用这个技能。
• 一组规则，规定输入、输出格式和执行顺序。
• 可选的参考文件或脚本，用来处理复杂计算、读取本地文件或调用外部命令。

这样每次调用同一个 Skill，模型得到的上下文是稳定的，输出结构也更容易保持一致。这与在提示词里临时写一段要求有本质区别，前者是在构建可复用的能力包，后者只是一次性对话约定。

1.2 SKILL.md 是一份写给 AI 的工作手册

WorkBuddy 的 Skill 通常以一个文件夹为单位，文件夹里最重要的文件叫 SKILL.md。这个文件可以理解为“写给 AI 的工作手册”，它不是给你看的说明文档，而是会被模型读取并作为执行依据的规则文件。

一个典型的 Skill 目录结构是这样：

其中 SKILL.md 负责描述这个技能什么时候用、怎么用、输出什么。examples 目录用来放输入输出示例，供模型参考格式。scripts 目录放可执行脚本，适合做模型不擅长的精确计算或文件处理。

需要特别注意：SKILL.md 不是 README。README 是给人类看的，SKILL.md 是给模型看的。两者的写作思路完全不同，写 SKILL.md 时要假设读者是一个能力很强但需要明确约束的 AI 助手。

1.3 Skill、自定义指令、插件和 MCP 的关系

这几个概念经常被混在一起，它们作用的层次不同。

自定义指令是全局约束，通常伴随每次对话生效，适合写身份、语气、默认习惯。Skill 是按场景触发的能力包，只在模型判断需要时加载，适合写流程和规则。插件是更完整的软件扩展，通常会提供界面组件或本地服务能力。MCP（Model Context Protocol）则负责打通外部工具和数据源，比如让模型访问数据库、读取文件、调用 API。

可以这样理解：MCP 解决“ AI 能不能碰到数据”的问题，Skill 解决“碰到的数据用什么流程处理”的问题。实际项目中两者经常配合使用。一个数据库 Skill 里可以写清楚查询规则，而真正连接数据库的动作交给 MCP 完成。

2. 安装 WorkBuddy 并准备技能运行环境

在推荐具体 Skill 之前，先把运行环境准备好。Skill 依赖 WorkBuddy 客户端本身，也依赖模型服务、技能目录和脚本运行环境。任何一环缺失，后面导入技能都会出问题。

2.1 系统要求与安装检查

WorkBuddy 是本地客户端形态的 AI 工作台，安装前先确认操作系统符合要求。官方的具体支持范围可能随版本变化，但一般需要注意这几点：

需要提醒的是，Windows 7 是否能使用 WorkBuddy，取决于官方客户端是否仍兼容该系统，不要假设所有版本都支持。安装后如果界面空白，优先检查 WebView2 是否安装；如果提示缺少 DLL，再检查 .NET 运行库。

2.2 接入 DeepSeek 等模型服务

WorkBuddy 本身不提供模型，它需要连接一个模型服务。本地工作台最常接入的是各家大模型 API，DeepSeek 是其中比较常见的选择。配置模型服务时，通常需要填三个字段：

• API 地址（base_url），例如 OpenAI 兼容接口的地址。
• API Key，由模型