D3 · 生态连接

Skills 技能包:预置技能的加载与使用

2026-07-27

WorkBuddy 的Skills 技能包是一种可插拔的能力扩展机制。与 MCP 连接器侧重"数据通道"不同,Skills 侧重"能力增强"——每个技能包封装了一组相关的工具、提示词模板和知识,让 WorkBuddy 在特定任务上表现更专业。本文将详解 WorkBuddy 预置的核心技能包,以及如何加载、配置和使用它们。

📦技能包是什么

一个 Skills 技能包通常包含三个部分:

🖼️核心技能包详解

agnes-image:AI 图片生成

agnes-image 是 WorkBuddy 内置的文生图技能包,基于腾讯混元大模型的图片生成能力:

🎨

核心能力

文本描述生成图片、图片风格控制、尺寸与分辨率设置、批量生成

⚙️

配置项

model(模型选择)、size(尺寸)、style(风格)、quality(质量)、seed(随机种子)

使用示例

@agnes-image 生成一张科技感的产品发布海报,深蓝色调,1920x1080,
包含"WorkBuddy 2.0"标题,风格:3D 渲染

配置方式

{
  "skills": {
    "agnes-image": {
      "enabled": true,
      "config": {
        "defaultSize": "1024x1024",
        "defaultStyle": "photographic",
        "maxBatchSize": 4
      }
    }
  }
}

agnes-video:AI 视频生成

agnes-video 提供基于文本描述的短视频生成能力:

@agnes-video 生成一段 5 秒的产品展示视频:
镜头从远处推进到 WorkBuddy 界面,展示 AI 对话过程,
背景音乐轻快,风格:科技简约

tencent-docs:腾讯文档操作

tencent-docs 是腾讯生态深度集成的核心技能包,提供对腾讯文档的全套操作能力:

📝

在线文档

创建/读取/编辑在线文档,支持富文本格式、插入图片/表格/链接

📊

在线表格

读写单元格、公式计算、数据透视、条件格式、图表生成

📽️

演示文稿

创建/编辑幻灯片、布局模板、插入图表/媒体、导出 PDF

📋

收集表/问卷

创建收集表、查看统计、导出数据

@tencent-docs 在腾讯文档中创建一份项目周报,包含:
1. 本周完成事项(从 GitHub PR 列表获取)
2. 下周计划(从飞书多维表格读取)
3. 风险项(从 Jira 未解决 Bug 统计)
格式使用公司周报模板

github:GitHub 深度操作

github 技能包封装了 GitHub API 的常用操作,比 MCP 连接器提供更高层的抽象:

@github 帮我完成以下操作:
1. 在 workbuddy-docs 仓库创建分支 feature/api-docs
2. 将这份 API 文档写入 docs/api-reference.md
3. 创建 PR 并指定 @tech-lead 作为 Reviewer
4. 在 PR 描述中关联 Issue #42

其他预置技能包

🔍

web-research

深度联网研究:多源搜索、信息交叉验证、自动生成调研报告

📊

data-analysis

数据分析流水线:数据清洗、统计描述、可视化、结论提炼

✍️

content-writer

内容创作:博客/技术文章/营销文案/邮件,支持风格和语气控制

🧪

test-gen

测试生成:单元测试/集成测试/E2E 测试,支持多框架(Jest/Pytest/Cypress)

🔄

code-refactor

代码重构:提取函数/类、消除重复、改善命名、升级依赖

🌐

i18n

国际化:文本提取、翻译、格式转换(JSON/YAML/POT)、一致性检查

⚙️技能包的加载与配置

全局配置

在 WorkBuddy 设置文件的 skills 节点中配置技能包:

{
  "skills": {
    "agnes-image": { "enabled": true },
    "agnes-video": { "enabled": true },
    "tencent-docs": {
      "enabled": true,
      "config": {
        "defaultPermission": "edit",
        "autoSave": true
      }
    },
    "github": {
      "enabled": true,
      "config": {
        "defaultOwner": "my-org",
        "autoBranch": true
      }
    }
  }
}

项目级配置

在项目根目录的 .workbuddy/skills.json 中配置项目专属技能:

{
  "skills": {
    "test-gen": {
      "enabled": true,
      "config": {
        "framework": "pytest",
        "coverageTarget": 80
      }
    },
    "code-refactor": {
      "enabled": true,
      "config": {
        "styleGuide": "google",
        "language": "python"
      }
    }
  }
}

技能包的优先级

当多个技能包提供相同能力时,按以下优先级决定使用哪个:

  1. 项目级配置:项目 .workbuddy/skills.json 中的设置优先级最高
  2. 用户级配置:用户全局设置文件中的配置
  3. 默认配置:技能包的内置默认值

🛠️自定义技能包开发

当预置技能包不满足需求时,可以开发自定义技能包:

{
  "name": "my-company-report",
  "version": "1.0.0",
  "description": "公司定制报告生成技能",
  "tools": ["mcp:mysql", "mcp:feishu"],
  "prompts": [
    {
      "name": "weekly-report",
      "description": "生成周报",
      "template": "根据以下数据生成本周工作周报..."
    }
  ],
  "knowledge": [
    "公司报告模板规范.md",
    "部门KPI指标体系.md"
  ]
}

自定义技能包放在 .workbuddy/skills/ 目录下,WorkBuddy 启动时自动扫描加载。详见 E1 技能包开发指南

🔗技能包与 MCP 的联动

技能包和 MCP 连接器可以组合使用,实现更强大的工作流:

📊 自动化报告

技能包:data-analysis + tencent-docs
MCP:MySQL + 飞书

从数据库拉数据 → 分析可视化 → 写入腾讯文档 → 推送飞书

🎨 营销素材生成

技能包:agnes-image + content-writer
MCP:企业微信

生成文案 → 配图生成 → 排版 → 推送企业微信群

🧪 质量门禁

技能包:test-gen + code-refactor
MCP:GitHub

PR 触发 → 自动生成测试 → 执行检测 → Review 评论

📚 参考资料

💬 你对 WorkBuddy 有什么疑问?或者已经在用了,有什么心得想分享?欢迎在下方留言讨论!