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 的路径：

方式一：图形化界面新建（推荐新手）

无需编写任何代码，通过可视化配置即可完成：

1. 启动 WorkBuddy 客户端，使用腾讯系账号（微信/企业微信/QQ）登录
2. 点击右上角「个人中心」图标，依次选择「Claw设置」→「Skills管理」
3. 点击「+ 新建技能」按钮
4. 在弹出窗口中填写：
   • 技能名称（如「自动重命名下载文件」）
   • 触发关键词（如「整理下载」）
   • 执行动作类型（选择本地文件操作）
5. 配置完成后保存

这种方式适用于：文件归档、文本改写、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}}"

导入步骤：

1. 在 Skills 管理界面点击「导入」
2. 选择 YAML 文件或粘贴配置内容
3. 系统自动解析并生成技能预览
4. 确认无误后点击「安装」

方式三：指令反向生成（智能且便捷）

这是最具 AI 感的方式。当你向 WorkBuddy 发送三次结构相似的指令时，系统会智能识别其中的模式，主动提示并帮你生成一个带变量参数的 Skill。

示例操作流程：

1. 第一次：向 WorkBuddy 发送「把 D:\文档\2026-01-01.docx 转成 PDF」
2. 第二次：发送「把 D:\文档\2026-02-15.docx 转成 PDF」
3. 第三次：发送「把 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 文档

上海华万通信是腾讯系企业软件生态服务商，专注于腾讯会议、企业微信、腾讯电子签等产品的选型咨询与集成部署，帮助企业构建高效的数字化协同工作平台。如有需求，欢迎联系沟通。