#4. 技能 · 连接器 · 伙伴

「技能 · 连接器 · 伙伴」是豆包工作任务模式的统一能力扩展入口，涵盖技能、连接器和工作伙伴三类功能。技能可将特定的工作方法固化为可复用能力，连接器负责接入外部账号及数据源，工作伙伴则面向不同专业领域提供针对性的协作支持。

用户可根据实际需求单独调用任一能力，也可将三者组合使用，以满足不同任务场景下的信息获取、流程执行和专业协作需求。各类能力的定位与用途如下：

#技能

技能是经过封装的标准化流程包，其中载明处理步骤、参考模板与输出标准，相当于预先为豆包备妥的一套工作方法，调用时无须再逐条陈述要求。平台现已上架逾二百个技能与连接器，覆盖办公处理、数据统计、内容创作、财务分析等常见方向，用户亦可自行新建。

点击页面右上角的「新建」，可见三个选项，分别对应三种扩展途径：

#对话新建

对话新建适用于反复出现且体例固定的工作。用户以对话形式将某项任务的适用情形、材料来源、处理步骤与交付标准完整陈述一次，由豆包整理成技能保存；此后仅需选中该技能并提供当期材料，即可获得体例一致的产出，无须每次重写长篇指令。

描述宜按固定框架分项写明，以免遗漏关键约束。下为通用模板，其中花括号内的内容为需替换项，用户按实际情形填入即可：

新建一个技能，名称为「{技能名称}」。

适用情形：当我{触发场景}时使用。
输入材料：{材料来源与范围}。
处理步骤：
1. {第一步做什么}
2. {第二步做什么}
3. {第三步做什么}
输出格式：{分几部分、每部分含哪些字段、篇幅限制}。
交付方式：{保存位置与文件命名规则}。
禁止事项：{不得改动或不得出现的内容}。

以下示例按此框架填写，可直接照用，亦可据此改写：

竞品动态整理

新建一个技能，名称为「竞品动态整理」。

适用情形：当我需要汇总竞品近期公开动向时使用。
输入材料：指定竞品名单，来源限于其官网、公众号与官方发布渠道。
处理步骤：
1. 按名单逐家检索指定时间区间内的公开信息
2. 剔除转载稿与无实质进展的通稿，仅保留首发内容
3. 按新品与功能、营销活动、价格调整、人事与融资四类归入
输出格式：分四类列出，每条含日期、事项、来源链接，并附一句影响判断；某类无内容时注明「本期无变动」。
交付方式：输出为 Markdown 文档，文件名为「竞品动态-年月日」。
禁止事项：不得对未见诸公开报道的事项作推测，不得省略来源链接。

合同要点审阅

新建一个技能，名称为「合同要点审阅」。

适用情形：当我上传合同文本并要求梳理要点或核查风险时使用。
输入材料：单份合同全文，含附件与补充协议。
处理步骤：
1. 提取当事人、标的、金额、期限、付款节点五项基本信息
2. 逐条核查违约责任、争议解决、保密与知识产权归属条款
3. 标出表述含混、义务不对等或缺失的条款，并注明所在条款号
输出格式：分「基本信息」「重点条款」「疑点与建议」三部分，疑点逐条列出，每条含条款号、原文摘录、问题说明、修改建议。
交付方式：输出为表格，随附一段不超过两百字的总体结论。
禁止事项：不得改写合同原文，不得给出确定性的法律结论。

电商详情页文案

新建一个技能，名称为「电商详情页文案」。

适用情形：当我提供商品资料并要求撰写详情页文案时使用。
输入材料：商品参数表、卖点说明与目标人群描述。
处理步骤：
1. 从参数中筛出三至五个可感知的核心卖点
2. 将每个卖点转写为一句利益点表述，避免堆砌参数
3. 按标题、卖点分栏、使用场景、参数表、常见问题的顺序成稿
输出格式：标题不超过二十字，每个卖点配一句小标题与不超过五十字的说明，常见问题不少于五组。
交付方式：按 SKU 分文件输出，文件名为「商品编号-详情页文案」。
禁止事项：不得使用最高级与绝对化表述，不得出现未经确认的功效承诺。

数据表清洗

新建一个技能，名称为「数据表清洗」。

适用情形：当我提交原始表格并要求整理成可用数据时使用。
输入材料：指定文件夹内的 Excel 或 CSV 文件，可为多份。
处理步骤：
1. 统一表头名称与字段顺序，合并多份表格为一张总表
2. 删除完全重复的行，日期统一为「年-月-日」，金额保留两位小数
3. 将缺失关键字段或格式异常的行单独抽出并标黄
输出格式：产出总表与异常表两张工作表，异常表附一列注明异常原因。
交付方式：另存为新文件，文件名在原名后加「-已清洗」。
禁止事项：不得修改原始文件，不得自行推测补全缺失数据。

客户答复拟稿

新建一个技能，名称为「客户答复拟稿」。

适用情形：当我转来客户来函或投诉记录并要求拟写回复时使用。
输入材料：客户原文，以及我方已知的事实与处理口径。
处理步骤：
1. 归纳客户诉求，逐条列明其所提问题
2. 对照我方口径判断可答复、需核实、不便答复三类情形
3. 按此分类拟写回复，需核实者给出明确的回复时限
输出格式：先列问题清单，再出回复正文；正文用书面语，不超过四百字，逐条对应问题清单。
交付方式：直接输出正文，另附一段内部备注说明尚待核实的事项。
禁止事项：不得承诺赔偿或时限之外的事项，不得在正文中出现内部备注内容。

#上传技能

「上传技能」主要用于导入已在其他工具或环境中编写完成的技能包，也适用于需要在团队成员之间共享和复用的场景。用户既可将技能文件夹或压缩包拖入弹窗，也可通过「选择文件夹」或「选择文件」从本地完成导入。

为确保技能能够被正确识别，导入内容须符合以下要求：压缩包或文件夹中应包含 SKILL.md 文件，且文件内须使用 YAML 格式定义技能名称和描述。该格式源自 Anthropic 于 2025 年 12 月发布的 Agent Skills 开放规范，目前已被多家平台采用。因此，遵循该规范创建的技能包可在支持此规范的平台间通用。

一个技能即一个文件夹，其中以 SKILL.md 为入口文件，该文件由结构化的 YAML 元数据与自由撰写的 Markdown 正文两部分构成，另可附带脚本、参考文档等资源。典型结构如下：

skill-name/
├── SKILL.md          必需，YAML 元数据 + Markdown 正文
├── references/       可选，需要时才读取的参考资料
├── scripts/          可选，可直接执行的脚本
└── assets/           可选，成品所用的模板、图标、字体等

技能包采用分层组织方式，与系统逐级加载内容的机制相对应。系统启动时，首先读取各技能的名称和描述；仅当当前任务与某项技能相匹配时，才进一步加载该技能的 SKILL.md 正文；对于脚本和参考文件，则会依据正文中的明确指引，在需要时进行调用。

基于这一机制，SKILL.md 正文不宜过于冗长，应重点说明技能的执行流程和关键规则。详细资料、示例内容及辅助脚本可独立存放于附属文件中，并由正文清晰标明适用场景和调用方式。

SKILL.md 写法

SKILL.md 须以 YAML 元数据开篇，其后接 Markdown 正文。元数据中仅 name 与 description 两项为必填，其余字段皆为可选，且合规的运行环境会忽略其无法识别的字段。各字段的写法要求如下：

其中 description 一项最为关键，技能能否在恰当时机被调用，全系于此。该字段是动态加载与触发的依据，故不宜只写用途，须一并写明适用场景与常见提法。正文部分则承载具体做法，宜采用编号分步的祈使句，逐条写明步骤、边界情形与可略过之处，并以代码模板取代文字描述，正文篇幅控制在 500 行以内，超出者应将细节移入 references、scripts 或 assets。

示例

以下为一份完整的 SKILL.md 示例，用户可照此结构改写自用：

---
name: weekly-project-report
description: 依据项目文件夹内的最新文件生成体例统一的项目周报，含进展、风险与下周计划三项，并输出为 Word 文档。用户提及周报、周会材料、本周进展汇总时调用此技能。
license: Apache-2.0
metadata:
  author: your-name
  version: "1.0"
---

# 项目周报

## 适用情形

用户要求汇总本周工作进展，或需按固定体例产出周报文档时，使用本技能。

## 执行步骤

1. 读取项目文件夹内本周新增及修改过的文档与表格，列出文件名与修改时间。
2. 按项目名称分组，同一项目的材料归入一处。
3. 逐项目提取三类信息：已完成事项、存在的风险、下周计划。
4. 事项后以括号标注其出处文件名，无出处者标注「口头同步」。
5. 按下方模板成文，输出为 Word 文档，文件名为「周报-年月日.docx」。

## 输出模板

## <项目名称>
- 本周进展：<不超过五条，每条一句话>
- 风险与阻塞：<无则填「无」>
- 下周计划：<不超过三条，注明负责人>

## 注意事项

- 仅统计本周区间内的变动，历史内容不予纳入。
- 数据类结论须注明来源文件，不作推测性表述。
- 原始文件一律不作改动，周报另存为新文件。

注意：技能可指示豆包调用工具与执行代码，宜只用自行编写或来源可信者；来源不明的技能包，须先逐一审阅其 SKILL.md 与所附脚本资源。

#连接器

连接器用于接通第三方服务。经用户授权后，豆包可访问飞书、钉钉、邮箱及各类财经平台账号，直接读写其中的文档与表格，就此完成信息拉取、资料归档与数据同步，无须再行手动导出文件或于多个页面之间往复切换。页面内的连接器依行业归类，常见条目如下：

添加连接器须完成一次账号授权，其可及范围以该连接器所声明的权限为准。授权完成后，于对话输入框选中相应连接器，即可下达指令：

文档往返：

用飞书连接器找到「产品需求」文件夹内最新的三份文档，提取其中的待办事项，汇总成一张表格并回写到同一文件夹

邮件处理：

收取今天的未读邮件，筛出带附件的报价单，把附件保存到「报价」文件夹，并按供应商、金额、有效期整理成一张对照表

行情取数：

查询关注列表内十只个股近一个月的涨跌幅与主力资金流向，按涨幅排序列表，并对涨跌幅前三名各写一段原因说明

工商核查：

按这份名单逐一核查企业的注册资本、成立时间、经营状态与涉诉情况，存在异常的单独标出并注明异常项

法规检索：

检索现行有效的劳动合同解除相关条款，列出法条原文出处与生效时间，并附两则同类裁判要旨

新建自定义连接器

平台预置的连接器覆盖常见服务，若所需服务不在其列——如企业自建系统、内部知识库，或尚未上架的第三方工具——可通过「新建 → 新建自定义连接器」自行接入。该功能以 MCP 服务地址为接入方式：用户填入服务方公布的服务器地址与鉴权信息，保存后该连接器即出现在对话输入框的连接器选单中，与预置条目一同调用。弹窗各字段如下：

提示：自定义连接器仅支持在本地电脑中使用，运行环境选为云电脑的任务无法调用。

填写示例

以下为几项已公开远程服务地址的 MCP 服务，其中花括号内为需自行替换的凭据。

高德地图开放平台提供地理编码、路径规划、天气与周边搜索等服务，官方文档所载的 Streamable HTTP 地址形如 https://mcp.amap.com/mcp?key= 加自行申请的 key，鉴权信息随地址传递，无须另填请求头：

# 服务器名称：高德地图
# 传输类型：HTTP
# 服务器 URL：https://mcp.amap.com/mcp?key={在高德开放平台申请的 key}
# 自定义 Headers：无

DeepWiki 用于检索 GitHub 仓库的文档与结构，便于查阅开源项目的用法。其公开服务地址为 https://mcp.deepwiki.com/mcp，公开仓库无须鉴权；如需访问私有仓库，则改用 https://mcp.devin.ai/mcp 并附 Authorization 请求头。

# 服务器名称：DeepWiki
# 传输类型：HTTP
# 服务器 URL：https://mcp.deepwiki.com/mcp
# 自定义 Headers：无

Context7 用于取用各类开发框架与库的最新文档，可避免模型依据过时版本作答。其远程地址为 https://mcp.context7.com/mcp，API 密钥经请求头传递；不填密钥亦可使用，惟每小时请求次数受限。

# 服务器名称：Context7
# 传输类型：HTTP
# 服务器 URL：https://mcp.context7.com/mcp
# 自定义 Headers：CONTEXT7_API_KEY: {在 Context7 控制台生成的密钥}

企业自建或本机运行的服务同样可以接入，地址填写实际监听的端口与路径即可：

# 服务器名称：内部知识库
# 传输类型：HTTP
# 服务器 URL：http://127.0.0.1:8000/mcp
# 自定义 Headers：Authorization: Bearer {服务方签发的访问令牌}

调用示例

保存后，于对话输入框选中该连接器即可下达指令，写法与预置连接器一致：

用「高德地图」连接器规划从重庆北站到解放碑的公交与驾车两种方案，分别列出耗时、换乘次数与大致里程，并附当日天气
用「DeepWiki」连接器查阅 fastapi 仓库中关于依赖注入的说明，梳理其基本用法与常见误区，并附对应文档位置
用「Context7」连接器取 React 最新版本中 useEffect 的官方文档，说明其与旧版写法的差异，并给出一段可运行的示例代码

注意事项：

• 核对文档：传输类型与地址须与服务方文档一致，二者不符时连接器无法建立。
• 最小授权：请求头中所填令牌应取用权限最小者，避免以管理员凭据直接接入。
• 定期轮换：密钥应按所在平台的规定定期更换，人员变动后须及时作废原有凭据。
• 先读后写：初次接入宜先下达查询类指令验证连通与返回范围，确认无误后再行涉及写入的操作。

注意：自定义连接器可在授权范围内读写对应系统的真实数据，接入前应确认该服务的权限边界与合规要求。所填令牌与密钥属敏感信息，不宜写入文档、截图或技能包中随任务分发。

#工作伙伴 · 小队

工作伙伴是依专业方向划分的智能体角色，内置数据分析、开发、设计、撰稿等不同定位，各自带有相应领域的工作方法与输出习惯。用户可视任务需要选用单个角色，亦可选取多个角色协同推进；多个角色组合，即构成一支工作小队。入口位于页面顶部的「工作伙伴 · 小队」标签页，添加后即出现在对话输入框的相应选单之中。

同一项任务，交由单一模型执行与交由小队执行，差别不在于能力高低，而在于组织方式。单一模型以一条链路自始至终推进，链路越长，前段的偏差越易被后段沿用；小队则将任务拆为若干环节，各由相应角色承担，环节之间以产出交接，某一环不合要求时只需重跑该环，无须整体返工。二者的取舍如下：

伙伴对话设置

进入伙伴详情页后，可以对人设、技能和安全三个标签进行配置。

人设

每个伙伴的人设由四份 Markdown 文件组成，均支持手动编辑。

可以简单理解为：

AGENTS.md：应该怎样工作？
IDENTITY.md：伙伴是谁？
SOUL.md：伙伴如何理解“你”？
USER.md：默认用户是什么样的人？

例如，内容创作伙伴可将「不编造数据、先列提纲再写正文」写入 AGENTS.md，将「面向内容运营人员的图文编辑助手」写入 IDENTITY.md。

提示：四份文件应尽量分工明确，避免重复或互相冲突。人设只能约束伙伴的行为，不能替代实际技能和工具。

技能

技能页分为「技能」和「工具」两部分。

技能 可以根据伙伴的用途增加或停用。例如，为内容创作伙伴增加标题生成、图文策划和卡片生成等技能。只建议保留与伙伴职责相关的技能，避免能力过多导致任务边界不清。**工具 **由伙伴对话内置，用于完成语音、图片或飞书相关操作。用户可以查看伙伴现有工具，但不能自行增加或停用。

注意：添加技能不代表所有任务都能自动完成。实际效果仍取决于用户提供的资料、任务要求以及伙伴拥有的权限。

安全

安全设置用于控制伙伴执行操作时的权限和聊天规则，主要包括「权限管理」和「聊天策略」。

权限管理提供两种授权模式：

• 默认允许：自动允许使用常用飞书操作所需权限，使用更加顺畅。
• 部分限制：限制指定权限，其余权限默认允许。

如果伙伴只用于普通内容创作，可以采用默认设置；如果伙伴会接触任务、会议记录或其他工作数据，建议按实际需要限制权限。

聊天策略用于设置伙伴在对话中需要遵守的安全边界，例如敏感信息处理、外部操作确认和高风险内容限制。配置时建议遵循以下原则：

1. 只开放完成任务所必需的权限；
2. 涉及发送、修改或删除内容时，先由用户确认；
3. 不在人设文件中保存密码、身份证号等敏感信息；
4. 对无法确认的事实明确说明，不编造数据；
5. 定期检查伙伴的人设、技能和权限是否仍符合当前用途。

提示：人设决定伙伴「怎样做」，技能和工具决定伙伴「能做什么」，安全设置则决定伙伴「在什么范围内可以做」。三者配合配置，才能让伙伴的表现更加稳定、可控。