S

Skill

推荐

Skill 是 AI 智能体在任务匹配时加载的一个指令文件夹:介绍如何编写,以及如何让它更可靠。

本文由 AI 翻译。 阅读原文

6 个章节109 篇教程

01 · 介绍

什么是 Skill

Skill(技能)是为 AI 智能体准备的一套可重复使用的指令,以文件形式保存,而不是每次都在聊天框里重新输入。

最简单的 skill 只需要一个文件夹和一个文件,即 SKILL.md。文件开头说明这个 skill 的用途(例如“部署这个项目”“按我们的格式撰写周报”)。下面是智能体应当遵循的步骤、规则和示例。

当你向智能体提出与该描述相符的请求时,它会读取这个 skill 并按照其中的内容执行。在 Claude Code 中,你也可以直接输入 /<skill-name> 来调用它。

可以把它想象成一张菜谱卡:智能体是厨师,skill 就是这张卡片,同一张卡片每次都能做出同样的菜。

02 · 适合什么场景

何时编写 Skill

当你发现自己第三次以上解释同一件事时,就该写一份:

  • 有固定步骤的流程:发布、部署、备份、为客户开通服务。
  • 一套内部风格:报告、邮件或提交信息必须长什么样。
  • 一份检查清单:发布或发送前需要核对什么。
  • 需要专门知识才能使用的工具:你的计费系统、某个供应商的 API,或一段遗留脚本。

一次性的任务不必写,模型本身已经掌握的通用知识也不必写。Skill 的价值在于省下反复解释的功夫,只有做到这一点,它才值得存在。

03 · 配置

编写你的第一个 Skill

  1. 新建一个文件夹:项目内的 .claude/skills/weekly-report/(或者用 ~/.claude/skills/ 让所有项目都能使用)。
  2. 创建 SKILL.md,写一段简短的标题和以下说明:
---
name: weekly-report
description: Write the Monday status report from last week's git log and the task board.
---

# Weekly report

1. Run `git log --since="7 days ago" --oneline`.
2. Group the commits by project.
3. Write three sections: Done, In progress, Blocked.
4. Keep it under 200 words. No adjectives.
  1. 把额外材料放在同一个文件夹里:模板文件、要运行的脚本或参考文档。在 SKILL.md 中链接它们,这样代理只会在需要时才读取。
  2. 试一试:让代理生成一份每周报告,观察它的执行过程,然后修改出错步骤的描述措辞。

description 这一行最为关键。代理会根据它判断该技能是否适用,所以要直接说明何时使用。

04 · 使用说明

日常使用

  • 保持 SKILL.md 简短,只写步骤、规则和示例。长篇参考文字请移到单独的文件中。
  • 规则要写成事实(例如“提交信息以动词开头”),不要写成恳求(例如“请尽量……”)。
  • 添加一行“Done when”,让智能体知道什么时候该停下。
  • 把技能和项目一起放在 git 中进行版本管理。团队成员和他们的智能体无需额外操作即可获得它。
  • 当智能体犯同样的错误两次时,修改技能,而不是修改聊天内容。
  • 每隔几个月审查一次技能。过时的步骤比没有步骤更糟。

05 · 注意事项

常见陷阱

  • 描述含糊。 “帮助处理报告”无法可靠地触发技能。请写明具体任务和触发关键词。
  • 技能过多。 描述相互重叠会让智能体选错技能。请合并或收紧描述。
  • 文件夹里有密钥。 技能就是纯文本,而且常常被分享。请把密钥和密码放在环境变量中。
  • 步骤未经测试。 技能中的每条命令都应该由人工至少运行过一次。
  • 来自陌生人的技能。 下载的技能可能会指示智能体执行任何操作。安装前请先阅读其内容。

06 · 资源

接下来去哪里

Skills 是指令层。工具(MCP)是智能体连接外部世界的方式,而工作流则把多个步骤串成一次完整运行。

我的笔记

登录后可以在这本手册上记私人笔记。登录