news 2026/4/22 9:28:34

WorkBuddy Skills 开发实战:从自定义技能到企业级应用

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
WorkBuddy Skills 开发实战:从自定义技能到企业级应用

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 文档

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

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/22 9:24:26

把 NAS 从角落翻出来,我用它搭了一套问卷系统

前言 我先坦白:我是个典型的"设备爱好者",买的时候想的特别好,买回来用的次数一只手数得过来。 NAS 就是最典型的例子——当年研究了半天,买了台绿联 DX4600,花了两千多。想着以后搭这个建那个,结…

作者头像 李华
网站建设 2026/4/22 9:21:48

R语言实战:从PCA双标图到变量贡献图的完整可视化流程

1. PCA分析入门:从数据准备到结果解读 主成分分析(PCA)是数据分析中最常用的降维技术之一,它能将高维数据转化为低维表示,同时保留数据的主要特征。在R语言中实现完整的PCA分析流程,不仅能帮助我们理解数据…

作者头像 李华
网站建设 2026/4/22 9:20:57

猫抓浏览器扩展:轻松获取M3U8流媒体和在线视频的终极指南

猫抓浏览器扩展:轻松获取M3U8流媒体和在线视频的终极指南 【免费下载链接】cat-catch 猫抓 浏览器资源嗅探扩展 / cat-catch Browser Resource Sniffing Extension 项目地址: https://gitcode.com/GitHub_Trending/ca/cat-catch 你是否经常遇到想下载在线视频…

作者头像 李华
网站建设 2026/4/22 9:18:15

告别数据洪流:用PCIe 5.0组播(Multicast)优化你的视频处理与AI推理系统

突破带宽瓶颈:PCIe 5.0组播技术在视频处理与AI推理中的实战应用 当你在处理8K视频流或部署多GPU推理集群时,是否经常遇到这样的场景——主机需要将相同的模型权重或视频帧数据反复推送到多个加速卡,导致PCIe通道拥堵不堪?这种数据…

作者头像 李华