技能包文档

文档导航

什么是 Skills？

Agent Skills 是一种轻量、开放的格式，用专门的知识与工作流来扩展 AI 助手的能力。Skills（技能包）即由说明文档、脚本和资源组成的文件夹，由助手按需动态加载，在特定任务上表现得更稳定、更快、更符合预期。

本质上，一个 skill 就是一个包含 SKILL.md 文件的文件夹。该文件至少包含元数据（name、description）以及指导助手完成特定任务的说明；技能包还可以附带脚本、模板和参考资料。

简单说：Skills 不是给模型装新「能力」的插件，而是教它「怎么做好某类事」的说明书。例如：按公司品牌规范写文档、用团队约定好的方式整理会议纪要、在任务管理工具里按规范创建任务等。你写好一次，助手在相关任务中就会按这套流程执行，结果更一致、可复用。

技能包目录结构

典型结构如下（除 SKILL.md 外其余均为可选）：

my-skill/
├── SKILL.md          # 必需：说明与元数据
├── scripts/          # 可选：可执行代码
├── references/       # 可选：参考文档
└── assets/           # 可选：模板、资源

Skills 如何工作？

Skills 通过渐进式披露（progressive disclosure）高效管理上下文：

发现（Discovery）：启动时，助手只加载每个可用技能的名称和描述，仅足以判断何时可能相关。
激活（Activation）：当任务与某技能的描述匹配时，助手才将完整的 SKILL.md 说明读入上下文。
执行（Execution）：助手按说明执行，必要时加载所引用的文件或运行技能包中的代码。

这样既保持响应速度，又能在需要时获得更多上下文。同一技能包可以在不同对话、不同场景下反复被调用，适合标准化工作流。

SKILL.md 文件

每个技能都以 SKILL.md 为核心，文件由 YAML 前置元数据（frontmatter）和 Markdown 说明正文组成：

---
name: pdf-processing
description: 从 PDF 提取文本与表格、填写表单、合并文档。
---

# PDF 处理

## 何时使用本技能
当用户需要处理 PDF 文件时使用本技能……

## 如何提取文本
1. 使用 pdfplumber 进行文本提取……

## 如何填写表单
……

文件顶部必须包含以下 frontmatter：

name：简短标识符
description：何时使用该技能（供发现阶段匹配用）

Markdown 正文为实际指令内容，结构和写法无硬性限制。这种简单格式带来几点好处：

自描述：作者或用户阅读 SKILL.md 即可理解技能用途，便于审查与迭代。
可扩展：可从纯文字说明扩展到可执行代码、资源文件与模板。
可移植：技能就是普通文件，易于编辑、版本管理与分享。

Skills 的类型

平台官方 Skills

由平台方创建和维护的技能包，例如针对常见文档格式的增强创建与编辑能力。用户均可使用，助手在检测到相关任务时会自动调用，无需手动启用。

自定义 Skills（Custom Skills）

由你或你的组织为特定工作流、领域任务创建的技能包。典型用法包括：

把品牌风格指南应用到文档、演示文稿，保证输出符合公司视觉规范。
按公司邮件模板生成对外沟通内容。
用公司或团队统一的格式整理会议纪要。
在 JIRA、Asana、Linear 等工具中按团队约定创建任务、填写字段。
执行公司内部约定的数据分析流程（口径、图表、结论结构等）。
把个人常用流程固化下来，让助手更贴合你的工作习惯。

简单技能用 Markdown 写说明即可；需要更复杂逻辑时，可以在技能包中附带可执行脚本，由助手在合适时机调用。

组织统一下发的 Skills

在支持组织管理的环境中，管理员可以为全员统一配置技能包。这些技能包会自动出现在每位成员的 Skills 列表中，并可设置默认开启或关闭。价值在于：

在全公司范围内统一推广经过审批的工作流。
让团队使用同一套流程与最佳实践，减少因人而异的偏差。
新能力上线时由管理员一次配置即可，无需每位成员单独上传。

合作伙伴 / 生态 Skills

由第三方或生态伙伴提供的专业技能包，通常与对应的工具连接器（如 MCP）配合使用，实现与外部工具深度集成的自动化工作流（例如从笔记产品拉取结构、按设计工具规范生成说明等）。

核心优势

提升特定任务的表现：在文档生成、数据分析、领域专项等需要「固定套路」的任务上，Skills 能补充模型的通用能力，让输出更稳定、更符合你的标准。
沉淀组织知识：把公司的流程、最佳实践、制度性知识打包成技能包，让助手在团队内一致地使用，避免每个人各说各的、结果不一致。
易于定制：用 Markdown 写说明即可创建简单 Skills，无需编程；需要更强能力时再为技能包附加可执行脚本，兼顾入门与进阶。
组织级统一管理：在支持组织管理的场景下，管理员可一次为全组织配置技能包，保证各团队使用同一套工作流，无需每人单独设置。

Agent Skills 开放规范

Agent Skills 的格式规范以开放标准形式发布在 agentskills.io。你创建的技能包不绑定单一产品——任何采用该标准的 AI 平台或工具都可以使用同一套技能格式。开发者若要在自己的产品中支持 Skills，可参考规范及官方提供的 Python SDK 等实现。

Skills 与相关概念的区别

Skills 与「项目 / 工作区」

项目（或工作区）通常提供「静态背景知识」：在该项目内发起对话时，这些知识会一直被加载。Skills 提供的是「按需触发的流程与规范」：只有在任务相关时才会加载对应技能包，且不限于某个项目，可在多处复用。适合「跨对话、跨场景复用同一套做法」。

Skills 与 MCP（Model Context Protocol）

MCP 负责把助手连接到外部服务与数据源（API、数据库、工具等），解决的是「能力从哪来」。Skills 负责的是「怎么用这些能力」——把完成某类任务的步骤、规范、模板写成说明，让助手在需要时按流程执行。两者可以一起用：MCP 提供工具与数据，Skills 教助手如何高效、规范地使用这些工具。

Skills 与全局自定义指令

全局自定义指令会作用在所有对话上，是全局偏好。Skills 是「任务级」的：只有任务与某技能包相关时才会加载，更适合「只在特定场景下需要固定流程」的情况，不会把无关说明塞进每次对话。

延伸阅读与下一步

规范与实现参考：agentskills.io（Agent Skills 开放标准及 Python SDK 等）。

建议下一步：

查看规范以了解完整格式。
为你的 agent 集成 Skills 支持，实现兼容的客户端。
在 GitHub 上查看示例技能与参考库，用于校验技能、生成 prompt 等。

← 返回技能包文档

注册会员	172
主题	47
回复	7
节点	134
模型	1982

新用户	2
新主题	1