Skills 与能力包

Skill 解决什么问题

每次都从头告诉 AI“项目规则、操作步骤和输出格式”，既浪费时间，也容易漏步骤。Skill（能力包）通常把这些内容组织成一个可复用单元，让 Agent 在需要时读取和使用。

可以把它理解成：说明书 + 检查清单 + 示例 + 可选资源。它不是另一个模型，也不是自动获得所有权限的插件。

一个 Skill 通常包含什么

• 一份清楚的使用说明：什么时候启用、输入需要什么、应该交付什么；
• 一套工作步骤和判断标准；
• 可选的模板、示例、参考资料或脚本；
• 安全边界：哪些事情不能做，需要用户确认什么。

不同产品对目录名、元数据和加载方式的约定可能不同，安装前要看对应 Agent 的官方说明。不要把某个平台的 Skill 文件直接当成所有平台都兼容。

在 Agent Skills 开放规范中，一个 Skill 文件夹通常至少包含 SKILL.md；文件的 YAML 元数据会先告诉宿主它叫什么、适合什么时候使用，正文再提供具体指令。scripts/、references/、assets/ 等目录可以按需要加入。宿主通常按需加载详细内容，但具体行为、权限和兼容范围由宿主产品决定。

怎样写一个好 Skill

1. 单一目标：解决一个重复、清楚、可验证的问题；
2. 触发条件明确：说明什么时候应该使用、什么时候不该使用；
3. 步骤可执行：每一步有输入、动作和结果；
4. 示例真实：给出正常、边界和失败示例；
5. 默认安全：读取可以自动化，删除、发布、付费和发送数据应先确认；
6. 保持短小：把常用规则放在入口说明，详细资料按需读取。

新手可以从什么 Skill 开始

• “把需求整理成验收清单”；
• “按照项目规范生成一篇文档”；
• “发布前检查链接、移动端布局和构建结果”；
• “把报错整理成复现步骤和排查顺序”。

这些任务边界清楚、容易检查，适合先练习能力包的设计。

安全检查

使用第三方 Skill 前，阅读其说明和脚本内容，确认它会读取什么、写入什么、是否访问网络或执行命令。不要因为名称看起来可信，就把密钥、生产目录或全部文件权限交给它。

Skill 和提示词的区别

提示词通常服务于当前任务；Skill 是可以反复使用的任务规范。一个 Skill 仍然需要当前任务的目标、资料和用户确认，不能代替判断。

官方资料

• Agent Skills 官方站点
• Agent Skills 开放规范
• Agent Skills 客户端接入
• Anthropic：Agent Skills
• Model Context Protocol：Agent Skills

相关格式和支持范围正在发展，实际安装和目录约定以你使用的 Agent 官方文档为准。