什么是智能体技能？示例与入门指南

智能体技能是可复用的软件包，包含指令以及可选的脚本、参考资料和模板，用于引导 AI 智能体完成特定任务。在开放的 Agent Skills 格式中，每个软件包都是以 SKILL.md 文件为核心的文件夹。兼容的智能体可以发现相关技能，并在需要时加载其指令，而不必将所有流程同时保留在对话中。本指南将介绍该格式，展示实用示例，并带您创建和测试第一个技能。

Agent Skills 是一种轻量级开放格式，用于封装专业知识和工作流程。一个技能包含 SKILL.md 文件，其中 YAML frontmatter 描述了其名称和用途，随后是 Markdown 指令。辅助文件可以包括脚本、参考文档和模板。

“AI 技能”一词可能指代多种含义，包括人们使用 AI 的能力。在本指南中，智能体技能和 AI 智能体技能特指供兼容智能体使用的可复用 SKILL.md 软件包。

例如，会议纪要技能可以定义团队会议纪要应包含的章节、如何记录决策，以及如何标记缺失的负责人或截止日期。您只需保存一次这些规则，之后即可将其用于新的会议记录。该技能会指导智能体的工作，但不会重新训练底层模型。

开放规范要求在 frontmatter 中包含名称和描述。名称必须为 1–64 个字符，只能使用小写字母、数字和连字符，并且要与目录名称一致；不能以连字符开头或结尾，也不能包含连续的连字符。描述必须为 1–1,024 个字符，并同时说明任务内容以及何时使用该技能。

该格式采用渐进式披露设计：智能体会先获得足以选择技能的信息，再加载其完整指令。

1. 发现。 智能体会收到可用技能的名称和描述。这些元数据仍会占用上下文，但不会预先加载所有完整流程。

2. 激活。 当智能体选择相关技能后，会读取 SKILL.md。有些工具还允许您按名称调用技能，或禁用自动选择。

3. 执行。 智能体会遵循流程，并在需要且获得许可时读取辅助参考资料或运行脚本。

这样可以减少未激活流程占用的上下文。实际的上下文用量取决于描述的数量和长度、已激活的技能以及加载的任何资源。清晰的描述有助于选择技能，但技能激活情况和输出质量仍需测试。

AI 工具领域的术语繁多，“技能”与几个看似相近的概念并列。它们的区别如下：

技能与提示词。 提示词是在对话中给出的指令；技能则保存了可供发现或显式调用的可复用流程及辅助资源。提示词也可以保存和复用。当一项重复任务需要持续维护的工作流程、示例、参考资料或脚本时，技能就会发挥作用。

技能与 MCP。 MCP 为智能体提供能力，也就是连接实时工具和数据的途径。技能为智能体提供知识：如何高质量地完成任务、应按什么顺序进行，以及应采取哪些验证步骤。两者相辅相成。代码审查技能定义什么样的审查才算全面，而 GitHub MCP 服务器则让智能体能够读取实际的拉取请求。

技能与项目指令。 AGENTS.md 等文件会根据智能体的加载和作用域规则提供项目指导。将广泛适用的约定保留在这些文件中，将应在相关时加载的任务专用流程放入技能。具体行为取决于工具。

• 可复用的专业知识： 沉淀任务专用的方法、检查清单和模板，无需每次都重新说明。

• 流程更一致： 在重复任务中，为智能体提供相同的步骤和审查标准。结果仍需验证。

• 上下文效率： 在需要时加载详细指令，而不是将每个流程都放入始终加载的指导内容中。

• 跨工具复用： 在兼容的智能体间共享核心 SKILL.md 格式，但使用前要检查工具访问权限、依赖项和平台特定字段。

• 团队维护： 将技能文件夹纳入版本控制，以便审查共享工作流程的变更。

越来越多的 AI 工具支持智能体技能，包括 Claude Code、OpenAI Codex、Cursor、GitHub Copilot 和 Kimi Code。这些工具使用可复用的技能软件包，为智能体提供任务专用的指令、工作流程和辅助资源。

共享的 SKILL.md 格式让技能更易于在兼容工具间复用，不过安装方式和调用方法因产品而异。如果技能依赖脚本或外部工具，请确认您计划使用它的环境中具备这些依赖项。

实用的技能会沉淀让重复任务符合团队具体要求的规则。以下示例展示了应封装哪些内容，以及应检查结果中的哪些方面：

文档处理和周期性数据分析也是不错的应用场景，但它们往往需要 SKILL.md 以外的工具或脚本。先从范围明确的工作流程开始，验证其输出结果，仅在任务需要时再添加依赖项。

选择与任务相匹配的环境。上述创建方式涵盖自然语言编写和基于本地文件的工作流。

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 中开始使用。

你可以向 AI 工具描述工作流程来创建技能，也可以自行编写 SKILL.md。先从一项重复性任务和易于检查的输出开始，例如会议纪要。

在 Kimi 中，打开技能面板以发现或安装技能。要创建自己的技能，可上传一份流程说明，或在技能创建对话中描述你的需求。你也可以使用 /skill-creator。有关当前入口，请参阅 Kimi 的技能指南。

第 1 步：打开 Kimi 的技能商店，点击“自定义”>“使用 Kimi 创建”。

第 2 步：描述你需要的技能。

向 Kimi 提供任务、预期输入、输出结构，以及缺失信息的处理规则。

例如：

如果结果遗漏了某条规则，请让 Kimi 修改该规则并重复测试。对于现有 SOP，请明确哪些内容是指令，哪些是背景材料；打包前移除无关或敏感内容。技能创建完成后，即可立即在 Kimi 中使用。

此示例仅使用文本指令，无需额外脚本。示例使用 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 技能应保持未激活状态。还应在未提供记录的情况下调用它：它应要求提供输入。

对于脚本、长篇参考资料或模板，可按需添加 scripts/、references/ 或 assets/，并从 SKILL.md 链接到它们。有关当前路径和调用选项，请参阅 Kimi Code CLI 技能文档。

• 定义清晰的触发条件： 说明任务内容和使用该技能的时机。纳入用户自然会使用的词语，并测试相关和无关的请求。

• 保持指令聚焦： 规范建议主文件少于 500 行且少于 5,000 个 token。这是两项独立的建议，并非行数与 token 数的换算关系。将详细参考资料移至辅助文件。

• 明确可观察的输出： 包括必需的部分、输入和输出示例，以及缺失信息的处理规则。

• 记录依赖项： 标明所需工具和软件包，并在适当时使用兼容性元数据。将特定平台的扩展与可移植核心分开。

• 控制会产生重要影响的操作： 对于发送消息或部署变更的工作流，使用显式调用和适当的审批规则。仅靠手动调用不能取代权限检查。

• 审查第三方软件包： 安装前检查指令和随附脚本，包括它们使用哪些数据和权限。

智能体技能将重复任务转化为可复用的工作流，兼容的 AI 智能体可在需要时加载。先从一份聚焦的 SKILL.md 开始，明确技能的使用时机及其应产出的内容。仅在任务需要时添加脚本或参考资料，然后测试技能的激活时机和输出质量。