智能体技能是可复用的指令包，可包含脚本、参考资料和模板等可选内容，用于引导 AI 智能体完成特定任务。在开放的 Agent Skills 格式中，每个包都是一个以 SKILL.md 文件为核心的文件夹。兼容的智能体可以发现相关技能，并在需要时加载其指令，无需将所有流程同时保留在对话中。本指南将介绍这一格式，展示实用示例，并带你创建和测试第一个技能。
什么是智能体技能？
Agent Skills 是一种轻量、开放的格式，用于封装专业知识和工作流程。一个技能包含 SKILL.md 文件：文件开头的 YAML frontmatter 用于说明其名称和用途，后面是 Markdown 指令。支持文件可以包括脚本、参考文档和模板。
“AI 技能”一词可能指代多种事物，包括人们使用 AI 的能力。本指南中的智能体技能和 AI 智能体技能，特指供兼容智能体使用、可复用的 SKILL.md 包。
例如，会议摘要技能可以规定团队会议纪要应包含哪些部分、如何记录决策，以及如何标记缺少负责人的事项或截止日期。你只需保存一次这些规则，之后便可将其用于新的会议记录。技能用于指导智能体工作，不会重新训练底层模型。
开放规范要求在 frontmatter 中提供名称和描述。名称必须为 1–64 个字符，只能使用小写字母、数字和连字符，并且必须与目录名称一致；名称不能以连字符开头或结尾，也不能包含连续的连字符。描述必须为 1–1,024 个字符，并说明任务内容以及何时使用该技能。
智能体技能如何运作？
该格式采用渐进式披露设计：智能体先获得足以选择技能的信息，再加载其完整指令。
发现。 智能体会获得可用技能的名称和描述。这些元数据仍会占用上下文，但不会预先加载所有完整流程。
激活。 智能体选择相关技能后，会读取 SKILL.md。部分工具还支持按名称调用技能，或关闭自动选择。
执行。 智能体遵循流程，并在需要且获得许可时读取支持性参考资料或运行脚本。
这样可以减少未激活流程占用的上下文。实际的上下文占用取决于描述的数量和长度、已激活的技能以及加载的资源。清晰的描述有助于选择技能，但仍需测试激活情况和输出质量。
智能体技能、提示词、MCP 和工具的区别
AI 工具领域的术语很多，“技能”与几个看似相近的概念并列。它们的区别如下：
| 能力 | 定义 | 何时启用 | 适用场景 |
|---|---|---|---|
| 提示词 | 在对话中提供的说明；也可以保存 | 保留在对话上下文期间 | 一次性说明 |
| 始终生效的说明（如 AGENTS.md、QWEN.md） | 项目事实和约束条件 | 根据智能体的项目范围和加载规则 | 适用于整个项目的规则 |
| 智能体技能 | 包含说明和资源的版本化文件夹 | 相关时按需加载 | 可重复执行的工作流和流程 |
| MCP 服务器 / 工具 | 提供操作和数据的运行中集成 | 完成配置、连接并获得授权后 | 执行操作、访问实时数据 |
| 子智能体 | 拥有独立上下文窗口的单独工作单元 | 启动时 | 隔离或并行的工作 |
技能与提示词。 提示词是在对话中提供指令；技能则保存可复用的流程和支持资源，供发现或显式调用。提示词也可以保存和复用。当重复任务需要维护工作流程、示例、参考资料或脚本时，技能便能发挥作用。
技能与 MCP。 MCP 为智能体提供能力，即连接实时工具和数据；技能则为智能体提供知识：如何高质量地完成任务、应遵循什么顺序，以及应采用哪些验证步骤。两者相辅相成。代码审查技能定义何为全面的审查，而 GitHub MCP 服务器让智能体能够读取实际的拉取请求。
技能与项目指令。 AGENTS.md 等文件会根据智能体的加载和作用域规则提供项目指导。将普遍适用的约定保留在这些文件中，将应在相关时加载的任务专用流程放入技能。具体行为取决于所用工具。
智能体技能为何重要
可复用的专业知识： 沉淀任务专用的方法、检查清单和模板，无需每次都重新说明。
更一致的流程： 针对重复任务，为智能体提供相同的步骤和审查标准。结果仍需验证。
上下文效率： 在需要时加载详细指令，而非将所有流程都放入始终加载的指导内容中。
跨工具复用： 可在兼容的智能体间共享核心 SKILL.md 格式，但使用前应检查工具访问权限、依赖项和特定平台字段。
团队维护： 将技能文件夹纳入版本控制，以便审查共享工作流程的变更。
哪些 AI 工具支持智能体技能？
越来越多的 AI 工具支持智能体技能，包括 Claude Code、OpenAI Codex、Cursor、GitHub Copilot 和 Kimi Code。这些工具使用可复用的技能包，为智能体提供任务专用的指令、工作流程和支持资源。
共享的 SKILL.md 格式让技能更易于在兼容工具间复用，但安装路径和调用方式因产品而异。如果技能依赖脚本或外部工具，请确认计划使用它的环境中提供了这些依赖项。
智能体技能示例和使用场景
实用的技能会沉淀让重复任务符合团队要求的规则。以下示例展示了应封装哪些内容，以及应检查结果的哪些方面：
| 技能 | 输入 | 可复用规则 | 待验证的输出 |
|---|---|---|---|
| 会议摘要 | 会议记录或转录稿 | 将决策与讨论分开；注明任务负责人和截止日期；标记缺失的细节 | 包含摘要、决策和行动事项的会议纪要 |
| 品牌内容审核 | 草稿和品牌指南 | 检查已批准的术语、语气、禁用表述和必需信息 | 附带修改建议的问题清单 |
| 代码审查 | 拉取请求差异 | 检查错误处理、测试、依赖项变更和项目规范 | 区分必须修复项和建议项的报告 |
| 周报 | 进度说明和指标 | 使用固定的报告周期和章节；区分已完成工作、风险和后续步骤 | 保留所提供指标并标记缺失数据的报告 |
文档处理和定期数据分析也是合适的应用场景，但通常需要 SKILL.md 之外的工具或脚本。先从范围明确的工作流程开始，验证其输出结果，仅在任务需要时再添加依赖项。
在 Kimi AI 中使用智能体技能
选择与你的任务相匹配的环境。上述创建方式涵盖自然语言编写和基于本地文件的工作流。
Kimi Code 中的智能体技能
Kimi Code CLI 会在项目目录 .agents/skills/ 和 .kimi-code/skills/，以及用户目录 ~/.agents/skills/ 和 ~/.kimi-code/skills/ 中发现技能。Kimi 专用的用户目录可通过 KIMI_CODE_HOME 更改。使用 /skill:<name> 调用技能，或让模型根据其描述和支持的触发字段选择技能。可以为单个技能禁用自动选择。配置路径或平台专属字段时，请查阅当前 CLI 文档。
在 Kimi 中使用智能体技能处理日常工作
无需从头设置。在桌面端或网页端打开 Kimi，浏览技能商店，一键安装技能后即可在 Kimi 中使用。从研究和写作到编程和数据分析，Kimi 技能商店为各类任务提供技能。在 Kimi 的桌面端或网页端应用中浏览商店，一键安装技能，即可在 Kimi 中使用。
如何创建自己的智能体技能
你可以向 AI 工具描述工作流来创建技能，也可以自行编写 SKILL.md。先从一项重复性任务和易于检查的输出开始，例如会议纪要。
方法 1：使用 Kimi 创建智能体技能
在 Kimi 中打开技能面板，查找或安装技能。若要创建自己的技能，可上传流程说明，或在技能创建对话中描述你的需求。你也可以使用 /skill-creator。有关当前入口，请参阅 Kimi 的技能指南。
第 1 步：打开 Kimi 的技能商店，点击“自定义”>“使用 Kimi 创建”。
第 2 步：描述你需要的技能。
向 Kimi 提供任务、预期输入、输出结构，以及信息缺失时的处理规则。
例如：
如果结果遗漏了某项规则，请让 Kimi 修改该规则并重复测试。对于现有的 SOP，请说明哪些内容是指令，哪些是背景材料；打包前移除无关或敏感内容。技能创建完成后，你可以立即在 Kimi 中使用。
方法 2：自行编写智能体技能
本示例仅使用文本指令，无需额外脚本。示例使用 Kimi Code CLI 演示安装和调用；其他智能体可能使用不同的路径和命令。
第 1 步：创建文件夹。 若要在 Kimi Code CLI 中创建用户级技能，请创建 ~/.agents/skills/meeting-summary/。若要创建与团队共享的仓库级技能，则在仓库根目录下使用 .agents/skills/meeting-summary/。
第 2 步：保存 SKILL.md。 创建 ~/.agents/skills/meeting-summary/SKILL.md 并粘贴以下内容。description 用于标识任务；正文用于定义输出和信息缺失规则。
第 3 步：启动新会话并调用技能。 保存文件后，启动新的 Kimi Code CLI 会话。在聊天输入框中输入以下命令：
第 4 步：检查结果。 以下是说明性的预期输出，并非实际产品运行记录。措辞可能有所不同，但章节、决策、负责人和截止日期应遵循该技能的规定。
第 5 步：测试自动选择和适用边界。 在新对话中，不使用斜杠命令，提出“将这些会议笔记整理成会议纪要”的请求，并提供相同的笔记。在界面提供活动记录的情况下，通过该记录检查智能体是否加载了技能，并检查输出是否符合其规则。然后尝试不相关的请求，例如“解释 Python 中的递归”；meeting-summary 技能应保持未激活状态。还要在未提供笔记时调用它：它应要求提供输入。
智能体技能无法正常工作怎么办？
| 症状 | 检查项 |
|---|---|
| 未发现该技能 | 检查扫描目录、SKILL.md 文件名是否完全一致、YAML frontmatter 是否有效，以及文件夹与名称是否匹配。添加后请开启新会话。 |
| 手动调用有效，但不会自动选择 | 让描述更贴合预期任务。检查是否已禁用自动调用；在新对话中重试。 |
| 该技能会在无关请求中激活 | 缩小描述范围，并将无关请求作为反例进行测试。 |
| 输出遗漏了一项规则 | 明确写出该规则，添加输入/输出示例，并用信息缺失的情况重新测试。 |
| 脚本或集成失败 | 检查所需的软件包、权限、网络访问和已配置的工具。技能不会自动安装所有依赖项。 |
如需脚本、较长的参考资料或模板，可按需添加 scripts/、references/ 或 assets/，并在 SKILL.md 中链接它们。有关当前路径和调用选项，请参阅 Kimi Code CLI 技能文档。
使用和创建智能体技能的最佳实践
定义清晰的触发条件： 说明任务内容和使用该技能的时机。包含用户自然会使用的术语，并测试相关及不相关的请求。
保持指令聚焦： 规范建议主文件少于 500 行、少于 5,000 个 token。这是两项独立的建议，并非行数与 token 数的换算关系。将详细参考资料移至支持文件。
明确可观察的输出： 包括必需章节、输入和输出示例，以及信息缺失时的处理规则。
记录依赖项： 列出必需的工具和软件包，并在适当时使用兼容性元数据。将平台专属扩展与可移植的核心部分分开。
控制有重要影响的操作： 对于发送消息或部署变更的工作流，使用明确调用方式和适当的审批规则。仅靠手动调用不能替代权限检查。
审查第三方软件包： 安装前检查指令和附带脚本，包括它们使用哪些数据和权限。
结语
智能体技能可将重复性任务转化为可复用的工作流，兼容的 AI 智能体可在需要时加载。先创建一份聚焦的 SKILL.md，明确技能的使用时机和应产出的内容。仅在任务需要时添加脚本或参考资料，然后测试技能何时激活以及输出质量。