Appearance
Skill 从入门到精通 · 图解指南
作者:张东豪 · 2026-10-22 · 分类:AI 办公 / 效率工具
技能(Skill)是可复用的能力模块,把特定领域的知识、标准工作流程和工具使用方式封装在一起,帮助 Agent 更稳定地完成专业任务。这份图解带你走完「认识 → 会用 → 会选 → 会造 → 会优化」的全路径。
一个任务如何被「技能」完成
01 先认识:Skill 是什么
官方定义是:技能是可复用的能力模块,将特定领域的知识、标准工作流程和工具使用方式封装在一起,帮助豆包更稳定地完成专业任务。它不教 Agent「更聪明」,而是给 Agent「专业做法」。
技能在 Agent 能力体系中的位置
图 01 · 技能在 Agent 能力体系中的位置:技能管「方法」,插件管「数据」,连接器管「外部系统」,伙伴管「角色分工」,共同扩展能力边界。
两类技能
| 类型 | 说明 | 覆盖领域 |
|---|---|---|
| 平台内置技能 | 运行时原生提供、无需安装 | 办公协作、编程、互联网、新媒体创作等 |
| 豆包推荐技能 | 按专业领域组织、可一键安装 | 金融、法律、新媒体创作、互联网、编程、学术、电商、医疗、办公协作、出行生活等 |
官方文档指出推荐技能「覆盖多个领域,具体数量与可用范围随功能迭代动态调整」。
关键入口速记
- 入口:侧边栏「技能 · 连接器 · 伙伴」进入技能专区
- 安装:点击技能卡片右侧「安装」,可随时在「我安装的」中删除
- 免安装:技能无需安装也可在任务中直接使用
- 来源:官方技能 · 企业技能 · 自定义技能 · 本地技能
02 看机制:一个 Skill 的内部构造
技能的本质是一个**「文件夹 + 说明文档」:用一份 SKILL.md 告诉 Agent 什么时候该用它、具体怎么执行;按需携带脚本、参考文档和模板资源。加载遵循渐进披露**原则,只把必要的信息放进上下文。
SKILL.md 解剖
text
skill-name/ 技能根目录
├─ SKILL.md 必需:元信息 + 使用说明
│ ├─ YAML frontmatter name + description
│ └─ Markdown 正文 流程 · 规则 · 提示
├─ scripts/ 可选:可执行脚本
│ └─ rotate_pdf.py 确定性操作示例
├─ references/ 可选:按需加载的参考文档
│ └─ schema.md 数据库结构 · API 规范
└─ assets/ 可选:产出用模板与素材
└─ logo.png 模板 · 字体 · 图标一份 SKILL.md 的骨架:
yaml
---
name: docx-skill
description: 专业文档创建与编辑…用于 .docx 文件:新建 / 修改 / 批注 / 保留格式…
---
## 正文(触发后才加载)
1. 用 python-docx 创建文档…
2. 复杂场景读 FORMS.md…
3. 交付前校验格式…
## 要点
• description 是「触发开关」
• 正文用祈使句写步骤
• 细节拆进 references/渐进披露:三层加载
| 层级 | 何时进入上下文 | 内容 |
|---|---|---|
| ① 元信息 | 常驻上下文 | name + description(约 100 词),Agent 每轮都能看到,用来判断技能是否匹配当前任务——「何时使用」必须写在这里,写进正文则 Agent 触发前看不到 |
| ② SKILL.md 正文 | 触发后加载 | 技能被选中后加载(正文控制在 500 行以内),含工作流、规则、命令,是 Agent 执行任务的「操作手册」 |
| ③ 捆绑资源 | 按需加载 | scripts / references / assets 按需读取,脚本可直接运行而不占用上下文 |
三层递进让每个技能「省 token、快匹配、稳执行」。
技能执行流水线
| 环节 | 做什么 |
|---|---|
| TRIGGER · 触发 | 豆包工作根据任务描述或需求详情自动匹配合适技能;也可以手动指定 |
| DISCOVERY · 发现 | 从常驻的 name + description 判断技能是否适用 |
| LOAD · 加载 | 技能被选中后加载正文与必要资源,进入执行上下文 |
| EXECUTE · 执行 | 运行脚本、参考文档、调用工具,一步步完成任务 |
| DELIVER · 交付 | 交付文档、表格、PPT、网页或分析结论,可继续修改 |
03 入门 · 会用:找到、安装、调用
入门的目标只有一个:让技能出现在任务里。三条路——去技能专区安装、在对话框里直接指定、或什么都不做让系统自动匹配。
图 04 · 技能使用三步走:进入专区 → 安装 → 在任务中调用;也可跳过安装直接使用。
两种调用方式
方式一:手动指定
- 对话框输入
/或@,搜索并选择目标技能 - 支持拼音全拼 / 简拼 / 关键词搜索
- 点击对话框下方「更多技能」,弹窗浏览并点选
- 点击「企业知识」:直接使用企业知识查询技能
方式二:自动匹配
- 直接描述需求,豆包工作会根据任务描述或需求详情自动匹配合适的技能
- 无需记住技能名称,也无需手动安装
- 适合「不知道用什么技能」的场景:把目标说清楚即可
04 进阶 · 会选:看懂技能生态,组合使用
当你能熟练「用」技能,下一步是**「选」对技能、并让技能与插件、伙伴协同**。先看官方技能生态地图,再理解四个角色的分工。
技能生态地图(示例)
官方推荐技能覆盖金融、法律、新媒体创作、互联网、编程、学术、电商、医疗、办公协作、出行生活等专业领域;平台内置技能覆盖办公协作、编程、互联网、新媒体创作等基础领域。以下是常见领域的典型技能示例:
| 领域 | 典型技能示例 |
|---|---|
| 办公协作 | 表格、Word 文档、幻灯片、在线文档、日历、即时通讯、会议 |
| 金融投资 | 个股日报、财报分析、选股工具、多股对比、估值建模、财富规划、公告解读 |
| 法律合规 | 合同审查、合同起草、补充协议、数据处理协议、合规评估、个保审计 |
| 学术研究 | 文献调研、论文润色、论文精读、研究计划书、文献核查、期刊排版 |
| 医疗健康 | 报告解读、循证问答、临床决策、文献检索 |
| 电商营销 | 选品分析、商品文案、活动策划、营销方案、跨境内容、客服方案 |
| 内容创作 | 创意设计、文生图、视频创作、新媒体写作、多平台改写、标题日历 |
| 编程与效率 | 应用构建、网页、定时任务、事件监听、音视频处理、日程待办摘要 |
提示:技能分类随平台迭代动态调整,具体以「技能」页面为准。以上为常见技能示例。
四个角色怎么分工 · 怎么配合
| 角色 | 官方定义 | 管什么 / 场景 | 示例 |
|---|---|---|---|
| 技能 Skill | 可复用能力模块,封装知识、提示词和工作流程 | 教 Agent 完成一类专业任务——「做事方法」 | 个股研究 · 合同审查 · PPT 生成 |
| 插件 Plugin | 通过 CLI 或 MCP 连接外部系统与数据源 | 让 Agent 能读取 / 写入外部资源——「数据读写」 | 企业微信 · 数据库 · 第三方软件 |
| 连接器 | 对接外部系统和数据源的工具,完成授权后读取或操作 | 企业信息、出行、地图、快递、天气、开发工具等外部接入 | 企业系统 · 自有服务 · 第三方平台 |
| 工作伙伴 | 预置或自定义的专业 AI 角色,可配置技能与连接器 | 把任务按角色分工,多个伙伴可组小队并行 / 接力 | 内容创作 · 产品研发 · 数据分析 |
图 05 · 四角色分工矩阵:「技能 × 插件」是最常用搭配——技能负责分析和执行方法,插件负责获取或写入外部数据,两者协同扩展能力边界。
05 精通 · 会造:创建你自己的技能
官方提供两种创建方式:① 与豆包对话新建(描述清楚即可);② 上传技能文件(本地已有的技能文件夹)。会造技能 = 把重复的专业活儿固化成可复用模块。
方式一:与豆包对话新建
在「技能 · 连接器 · 伙伴」→ 技能 → + 添加 → 「与豆包对话新建技能」,描述三要素:
- 技能名称:一句话说清做什么
- 触发场景描述:什么任务该用它(即 SKILL.md 的 description)
- 执行指令:具体怎么做,可附脚本 / 参考文档 / 模板资源
官方示例:「输入竞品名称后,自动抓取其官网核心信息,并从功能、定价、目标用户三个维度生成对比分析报告。」
方式二:上传技能文件
- 本地已有的技能文件夹 / 压缩包直接上传
- 至少包含 SKILL.md,且文件开头是 YAML 格式的技能名称和描述
- 格式不确定?可让豆包工作帮忙检查或补充
创建完成后可在「我安装的」查看、替换或删除;也可在任务对话框「更多技能 → 技能管理」管理。
一份好 SKILL.md 的四个写作要点
- description = 触发开关:「何时使用」必须写在 description 里,因为它常驻 Agent 上下文,是技能能否被正确匹配的关键。写清技能做什么 + 什么场景触发,不写进正文。
- 正文用祈使句:SKILL.md 正文是给 Agent 看的操作手册:用命令式写步骤,给出流程、规则与命令(如「1. 用 python-docx 创建文档…」)。
- 保持精简 · 渐进披露:上下文是公共品:正文控制在 500 行内,细节拆进 references / scripts,需要时再加载。
- 迭代优化:创建 ≠ 结束:在真实任务上使用,发现问题就更新 SKILL.md 与资源,再测试再优化(用 → 观察 → 修改 → 再用)。
06 一张图:从入门到精通
把前面的四章收拢成一条成长路径。每个阶段都有明确的能力目标——对照看看你正处在哪一级。
L1 认识 —— 知道技能是什么
理解技能 = 可复用能力模块,能说清「方法 vs 数据」:技能管做事方法,插件管数据读写,连接器管外部系统,伙伴管角色分工。
- [x] 看懂官方定义
- [x] 分清四个角色
- [x] 知道去哪里找
L2 会用 —— 安装并调用技能
能从技能专区安装官方技能,在对话框用 / 或 @ 指定技能,或直接描述需求让系统自动匹配;能一次说清任务五要素(目标 / 受众 / 材料 / 格式 / 验收标准)。
- [x] 安装与卸载
- [x] / @ 指定技能
- [x] 自动匹配
- [x] 五要素描述
L3 会选 —— 按领域选对技能并组合
熟悉技能生态分类(金融 / 法律 / 学术 / 医疗 / 电商 / 内容创作…),能按任务选最合适的技能;掌握「技能 + 插件」搭配,让方法类能力与数据读写协同。
- [x] 生态地图
- [x] 按场景选型
- [x] 技能 × 插件协同
- [x] 伙伴组队
L4 会造 —— 创建自己的技能
用「对话新建」或「上传文件夹」两种方式创建技能;能写出规范的 SKILL.md——description 写清触发场景、正文用祈使句、资源按需放置。
- [x] 对话新建
- [x] 上传技能
- [x] SKILL.md 规范
- [x] 三层渐进披露
L5 会优化 —— 迭代打磨 · 沉淀专业能力
在真实任务中反复使用自己的技能,根据结果修改 SKILL.md、补充脚本与参考,把个人 / 团队的专业流程沉淀为可复用资产,甚至与伙伴、插件组合成自动化流程。
- [x] 真实任务验证
- [x] 持续迭代
- [x] 专业流程沉淀
- [x] 自动化组合
一句话总结
技能把「专业领域的做法」从模型能力中解放出来:会识别任务 → 会调用技能 → 会组合生态 → 会编写技能,就是完整的 Skill 成长路径。越往后,你越能把重复的复杂工作,变成一句话就能启动的自动化能力。
附录 · 资料来源
- 豆包工作帮助中心《在豆包工作中使用技能》——功能简介、操作流程(安装 / 创建 / 调用)、技能与插件区别:https://www.doubao.com/work/docs/zh-cn/articles/081010973544-skills
- 豆包工作帮助中心《豆包工作介绍》——Agent 产品定位、核心功能、使用入口:https://www.doubao.com/work/docs/zh-cn/articles/095732655658-about-doubao-work
- 豆包官方产品说明(豆包订阅·豆包工作)——「豆包技能是什么 / 豆包连接器 / 豆包工作伙伴 / 工作任务模式」等官方口径。
- 《豆包工作任务功能须知》——技能(官方技能 / 企业技能 / 自定义技能 / 本地技能)使用规则:https://www.doubao.com/legal/DoubaoAgentModeNotice
- 技能创作通用规范(Skill Creator)——SKILL.md 结构与渐进披露原则(公开技能规范文档)。
注:正文图解中的技能分类与实例为基于官方领域分类的说明性整理;实际可用技能与数量以「技能」页面实时展示为准。本文内容整理自豆包官方公开帮助文档与产品说明,版权归原机构所有,仅供学习参考;文中「豆包」「技能」等名称及其功能描述以官方最新发布为准。
