WorkBuddy 的 Skills 系统是其核心扩展能力,支持通过自定义技能满足企业特定场景需求。本文从实际使用角度,详细介绍 Skills 的创建方式和开发流程。
Skills 系统概述
什么是 Skills?
如果说 WorkBuddy 是一部智能手机,那么 Skills 就是它的「App」。Skills 是 WorkBuddy 的能力扩展模块,相当于给 AI 安装了不同的「专业工具包」。
Skills 的核心价值:
- 专业化能力:让通用 AI 助手变成特定领域的专家
- 流程自动化:将复杂的多步骤任务封装成一键指令
- 可复用性:一次开发,多次使用,还能分享给其他用户
- 无限扩展:支持 HTTP 调用、JavaScript 脚本、Python 脚本等多种实现方式
Skills 与 Plugins 的区别
很多用户容易混淆这两个概念:
| 对比项 | Skills(技能) | Plugins(插件) |
|---|---|---|
| 定位 | 定义任务范式,让AI更擅长「怎么做」 | 提供运行时能力,让AI能「做什么」 |
| 作用 | 流程封装和任务模板 | 工具接口和系统连接 |
| 类比 | 手机上的App功能 | 手机上的硬件能力扩展 |
简单来说:技能让 AI 更聪明,插件让 AI 更有能力。
Skills 的三种创建方式
WorkBuddy 为不同技术背景的用户提供了三种创建 Skills 的路径:
方式一:图形化界面新建(推荐新手)
无需编写任何代码,通过可视化配置即可完成:
- 启动 WorkBuddy 客户端,使用腾讯系账号(微信/企业微信/QQ)登录
- 点击右上角「个人中心」图标,依次选择「Claw设置」→「Skills管理」
- 点击「+ 新建技能」按钮
- 在弹出窗口中填写:
- 技能名称(如「自动重命名下载文件」)
- 触发关键词(如「整理下载」)
- 执行动作类型(选择本地文件操作)
- 配置完成后保存
这种方式适用于:文件归档、文本改写、Excel字段提取等高频标准化场景。
方式二:导入 YAML 模板(适合复杂逻辑)
对于有定制化需求或希望复用已有逻辑的用户,可以基于标准 YAML 语法编写 Skill 定义文件,然后一键导入:
name: "企业微信工单查询" version: "1.0.0" description: "查询企业微信工单状态" author: "your-company" triggers: - keywords: ["查工单", "工单状态", "ticket"] description: "工单查询触发词" actions: - name: "查询工单详情" type: "http_request" config: method: "GET" url: "https://qyapi.weixin.qq.com/cgi-bin/ticket/get" headers: Content-Type: "application/json" parameters: - name: "ticket_id" type: "string" required: true description: "工单ID" output: format: "card" template: "工单 {{ticket_id}} 状态:{{status}}"导入步骤:
- 在 Skills 管理界面点击「导入」
- 选择 YAML 文件或粘贴配置内容
- 系统自动解析并生成技能预览
- 确认无误后点击「安装」
方式三:指令反向生成(智能且便捷)
这是最具 AI 感的方式。当你向 WorkBuddy 发送三次结构相似的指令时,系统会智能识别其中的模式,主动提示并帮你生成一个带变量参数的 Skill。
示例操作流程:
- 第一次:向 WorkBuddy 发送「把
D:\文档\2026-01-01.docx转成 PDF」 - 第二次:发送「把
D:\文档\2026-02-15.docx转成 PDF」 - 第三次:发送「把
D:\文档\2026-03-20.docx转成 PDF」
系统识别到「把 [文件路径] 转成 PDF」的模式,自动弹出提示:「检测到重复操作模式,是否生成自动化技能?」
点击确认后,系统自动生成 Skill,可复用处理任意 Word 文件的 PDF 转换。
企业级部署注意事项
权限控制
企业环境中,Skill 的权限需要精细控制,避免数据泄露:
permissions: - name: "file_read" scope: "specified_folders" # 仅允许访问指定文件夹 - name: "web_request" allowed_domains: # 仅允许访问白名单域名 - "qyapi.weixin.qq.com" - "api.company.com" - name: "enterprise_api" requires_approval: true # 企业API需管理员审批日志与审计
WorkBuddy 支持 Skill 操作日志导出,便于企业合规审计:
| 日志字段 | 说明 |
|---|---|
| 调用时间 | 精确到秒的时间戳 |
| 执行结果 | success/error/timeout |
| 消耗资源 | Token数量、响应时间 |
| 操作人员 | 执行操作的账号 |
管理员可在企业控制台查看所有 Skill 的调用记录。
多版本管理
当 Skill 需要更新时,建议使用版本管理:
# v1.0.0 name: "工单查询" version: "1.0.0" # v1.1.0(新增批量查询) name: "工单查询" version: "1.1.0" changelog: "新增批量查询功能"建议在正式环境使用前,先在测试环境验证新版本功能。
常见问题排查
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 技能列表看不到新条目 | SKILL.md 格式不标准 | 确保文件放在正确路径:~/.workbuddy/skills/{skill-name}/SKILL.md |
| 技能无法触发 | 触发词未配置或被占用 | 检查触发关键词是否与其他技能冲突 |
| 执行时提示 skill not found | 路径配置错误 | Windows 系统检查%APPDATA%\WorkBuddy\skills\目录 |
| 返回格式异常 | 返回类型不匹配 | 确保输出格式与配置一致(card/text/json) |
参考资源
- WorkBuddy 官方下载
- 腾讯云开发者社区 - WorkBuddy 知识库
- 企业微信 API 文档
上海华万通信是腾讯系企业软件生态服务商,专注于腾讯会议、企业微信、腾讯电子签等产品的选型咨询与集成部署,帮助企业构建高效的数字化协同工作平台。如有需求,欢迎联系沟通。