Agent Skills 完整解读：一篇 FAQ 讲清楚

10 分钟阅读

2026 年 1 月 26 日

了解什么是 agent skills、如何安装、Agent 如何使用它们，以及实现层面的最佳实践。

Agent 并不具备你和团队已有的上下文。即使它能扫描你的代码库，或连接到文档管理系统，它依然不了解你们团队的流程、质量标准和目标。为了让回答更准确、减少错误，人们常常通过反复补充提示词来提供正确上下文。

Agent skills 就是为了解决这个问题。它是一种简单、开放的格式，把指令、脚本和资源打包起来，让 LLM 和 Agent 可以自动发现并使用，从而提升输出准确性。

你可以把 skills 理解为“按需调用、集中管理的专业经验”。写一次，Agent 就能在需要时访问关键信息。Skills 让你从“Agent 勉强能用”走向“Agent 真正知道我们这里怎么做事”。

Link to heading什么是 skills？

Skills 是面向 AI Agent 的可打包、可复用指令。Skills 基于一个被众多头部提供商和 Agent 平台采用的开放标准。

你只需要安装一次 skill package，Agent 就可以在任务匹配时自动加载。Skills 适用于各种 Agent，不论是写代码、分析数据、管理工作流，还是处理客服场景。

虽然当前采用高潮主要由 coding agent 推动，但 skills 适用于任何 Agent 用例。同一种打包格式和生态可以跨领域复用。

Link to headingSkills 与 MCP servers、tools、rules、system prompts 有什么区别？

Skills、MCP servers、tools、rules 和 system prompts 分别解决 AI Agent 配置的不同层面，并提供不同类型的能力。

Skills 最擅长打包“带上下文与护栏”的完整工作流。MCP servers 提供标准化工具访问。Tools 提供单点功能。Rules 与 system prompts 则提供基础行为控制。

这些方法并非互斥，而是协同关系。Skills 可以引用 MCP servers、建立在 system prompts 之上，并结合 rule-based 逻辑。

Link to headingSkills

Skills 用于打包完整工作流，把指令、上下文和决策逻辑组合在一起。它不仅告诉 Agent 有哪些工具可用，还告诉它何时用、按什么顺序用，以及怎样算成功。

Skills 最适合复杂、多步骤、重复出现且带领域属性的任务。这类场景需要结合上下文来判断工具使用和结果处理方式，而 skills 能提供完成决策所需的任务级专业知识。

Link to headingMCP servers

Model Context Protocol（MCP）servers 为 AI Agent 访问外部工具和服务提供标准化接口，负责 AI 系统与第三方 API 之间的技术集成。

它最适合工具接入、API 访问，以及为 Agent 提供可靠的外部服务接口，例如数据库、文件系统或 Web 服务。

Link to headingTools

Tools 提供可被 Agent 调用的单一功能，用于执行特定动作。每个 tool 都处理一个离散操作，例如发起 API 调用、执行网页搜索、读取文件或处理数据。

它最适合单一目的操作、API 集成，以及作为更大工作流中的能力积木。

Link to headingRules

Rules 定义 AI 行为的具体约束和逻辑。团队和个人都可以用它持续落实安全策略、数据处理标准和运营约束，不受任务类型或 Agent persona 变化影响。

它最适合执行合规要求、设置访问控制，以及定义必须稳定执行的行为边界。

Link to headingSystem prompts

System prompts 用来设定 AI 的基础行为和“人格”。它决定 Agent 应如何回应、使用什么语气，以及优先强调哪些基础能力。

它最适合定义核心行为、沟通风格和适用于所有交互的基线运行参数（而 rules 更像在基线上进一步施加“必须/禁止”的窄约束）。

Link to headingSkills 解决了哪些问题？

当团队在复杂工作流中依赖 Agent 时，skills 可以解决一系列典型问题。

提示词会漂移。两个人提同一个需求，可能因为措辞不同，或 Agent 关注的上下文不同，得到完全不同结果。即便在同一个 SOP 的某个步骤，这种情况也会发生。没有一致指令时，Agent 在相同任务上的行为会变得不一致。

工作流惯例会丢失。每个流程都有自己的质量检查、验证方式、审批流、数据格式和决策标准。没有明确引导，Agent 无法正确推断这些细节；而在大规模场景下，也不可能每次都手动重述。

指令蔓延会挤爆上下文。把冗长 playbook 直接贴进 prompt，会和其他推理信息争抢上下文窗口，关键流程信息反而被淹没。

Skills 把这些原本分散在临时 prompt 里的指令抽离出来，集中到可版本化、可审查、可复用的格式中，并在各类 agentic workflow 中复用。

Link to headingSkills 示例有哪些？

Vercel React Best Practices：当 Agent 编写或审查 React / Next.js 代码时，会加载该 skill，以确保组件遵循性能实践，例如正确 memoization、bundle 优化、server component 使用等。
Supabase Postgres Best Practices：当 Agent 需要编写数据库查询或设计 schema 时，会应用该 skill，确保索引合理、查询模式高效、表结构最优。
Copywriting：当 Agent 创建营销内容、落地页或社媒文案时，会使用该 skill，应用以转化为导向的写作模式、说服框架和品牌语气一致性。
Remotion Best Practices：当 Agent 使用 Remotion SDK 生成视频时，会使用该 skill，应用动画、音频、3D 内容、图表、字幕等视频制作领域知识。

这些例子展示了 skills 的跨领域能力：开发团队可获得符合性能规范的代码，数据库团队获得优化查询，营销团队获得更具转化力的文案，视频团队获得可直接生产的 Remotion 代码。无论你写的是 SQL 还是销售文案，底层打包格式都一致。

Link to heading什么是 skill package？

Skill package 是可共享的技能集合，包含一个或多个 skills，团队可以按需采用并安装。

每个 package 都包含让 skills 生效的组件。唯一必需组件是 SKILL.md 文件，其余都可选。

SKILL.md 用于告诉 Agent 这个 skill 做什么、如何使用。scripts 目录用于存放可执行辅助脚本与自动化脚本。references 目录用于存放支持文档、示例和上下文文件。配置文件用于定义初始化和依赖要求。

你不需要为每个 repo 维护一套巨型指令。可以在哪些项目需要就安装到哪里，其余 Agent 配置保持不变。这种模块化方式让团队能按能力增量采用，而不必重构整个工作流。

一个 package 可以只包含一个聚焦 skill，也可以包含多个协同 skills，并按开发环境需要添加支持文件。

Link to heading如何安装 skill package？

安装 skill package 时，你可以把相关文件放到项目的 skills/ 目录，或放在用户级全局范围。你也可以使用 skills 命令行工具。

通过命令行安装 skills

使用 skills CLI 直接从命令行添加 skills：

npx skills add <owner/repo>

Link to heading如何发现 skills packages？

Skills 有自己的生态，格式一致，并在 skills.sh 提供公开目录，你可以在其中发现新的 skills。

Link to heading安装后会发生什么？

安装完成后，skills 会出现在 Agent 的可用 skills 列表中。Agent 会根据 skill 元数据和当前上下文，在需要时自动加载。

Link to heading我可以创建自己的 skills 吗？

可以。你可以创建自定义 skills。Skill 本质上是一个包含 SKILL.md（以及按需其他文件）的文件夹，用于定义该 skill 的目标与实现。

你可以在本地创建 skills，不依赖外部托管。创建一个文件夹，加入带必需 YAML frontmatter 和 skill 定义的 SKILL.md，Agent 即可立即使用。

要理解结构与实现模式，可参考已有 skills 示例。这有助于你构建能高效集成进 agentic systems 的 skills。

Link to heading在真实工作流中，skill packages 会出现在哪里？

当 skills 能映射到可重复工作模式，并承载特定领域知识或组织经验时，价值最大：

开发团队可拥有一组 skills：如何新增路由、运行测试、写清晰 PR 描述、确认合并前必过检查项。
内容团队可拥有一组 skills：如何写标题、遵循品牌规范、组织博客结构、优化 SEO。
客服团队可创建一组 skills：如何分诊工单、遵循语气规范、处理常见问题、必要时升级处理。
数据分析师可创建一组 skills：如何清洗数据集、运行特定查询、生成可视化、记录方法论。

团队也会为跨组织通用流程构建共享 skill packages。比如工程团队可标准化数据库迁移结构、日志编写方式或事故处理流程。

Agent skills 带来的关键变化是：具体指令与专业经验不再散落在某人上周的笔记里，也不再藏在一次性 prompt 中，而是沉淀到可集中审查、可共同迭代的位置。

Link to headingAgent 如何使用 skills？

多数支持 skills 的 Agent 平台都遵循类似模式。

启动时，Agent 先加载一个轻量索引，只包含可用 skills 的名称与描述，而不是完整指令内容。

当某个任务与 skill 匹配时，Agent 再加载该 skill 的完整内容。这样既能保持默认上下文精简，又能在关键时刻获取详细指导。

一些平台还支持显式调用（explicit invocation）。这在你希望强制执行某个工作流，或排查某个 skill 为什么生效/未生效时很有用。

Link to headingSKILL.md 里有什么？

SKILL.md 包含两部分：YAML frontmatter 和 markdown 正文。

Link to headingYAML frontmatter

Frontmatter 用于 Agent 发现与元数据描述，必须包含 name 和 description 字段。

name 字段要求：长度 1–64 字符，仅允许小写字母与数字，连字符只能单个出现，且必须与目录名一致，并匹配 ^[a-z0-9]+(-[a-z0-9]+)*$。

description 字段要求：长度 1–1024 字符。

未知 frontmatter 字段会被忽略，因此该格式具备前向兼容性。

Link to headingMarkdown content

Markdown 正文部分承载 Agent 实际执行指令。你需要在这里定义 Agent 应做什么、如何行为，以及在使用该 skill 时应遵循的具体准则。

Link to headingSKILL.md 的哪些 frontmatter 字段是可选的？

可选字段包括 license、compatibility（最多 500 字符）、metadata（任意字符串到字符串的键值映射）和 allowed-tools。

这些字段可帮助团队传达约束和环境要求，而无需把它们硬编码进大段说明文字。

Link to heading一个 skill 还可以包含什么？

Skill 不只是单个指令文件。

除了 SKILL.md，skill 目录还可以包含 scripts/（可执行辅助脚本，适合需要稳定重复执行的步骤）、references/（按需加载的长文档支持材料）、assets/（支持输出的模板、示例或其他工件）。

这些都不是必需项，但能提供更高级功能、简化 SKILL.md，并把长篇参考资料从默认上下文中剥离出去。

Link to heading`scripts` 目录有什么用途？

scripts/ 可包含可执行辅助脚本。

这会让 skill 更省 Token、结果更可预测，因为 Agent 可以直接运行脚本，而不是每次都用自然语言重新推导多步骤流程。

脚本也更便于审查。对于必须“每次都正确”的步骤，脚本通常比段落描述更可审计。

Link to heading`references` 目录有什么用途？

references/ 用于存放按需加载的支持文档。

它符合渐进式披露（progressive disclosure）模型：Agent 可以先看摘要，只有在需要细节时再加载完整内容。

一个实用最佳实践是：避免在 SKILL.md 和 references/ 中重复同一信息。

如果某个 reference 文件非常大，可在 SKILL.md 中加入 grep 搜索模式，帮助 Agent 快速定位目标段落。

[Link to heading](#other-common-quest

[... 内容已截断 ...]