📰 来源: 博客园
这篇文章带你搞懂 Skill 是什么、怎么用、怎么设计。全是干货，看完你也能自己写 Skill。
别再每次都手动敲指令了
你有没有这种经历：每个月都要汇总一遍客户反馈。打开 Claude Code，打一串差不多的指令，等结果，发现忘了指定输出格式，又改一下，勉强能用。下个月再来一次，又不记得上次怎么写的了，花20分钟重新试出正确的指令，输出跟上个月还不一样，想对比都没法比。
这就是提示词跑步机效应——反复做同样的事，但每次都在重复劳动，没有积累。
Skill 就是来解决这个问题的。 Skill 就像一个写好的"作业模板"。你只需要把模板做好，之后喊一声"跑一下"，它就会按你定的流程自动干活。
那建一个 Skill 到底值不值？ 算笔账就清楚了：
第一次建 Skill 大概要 30-60 分钟
第一次建 Skill 大概要 30-60 分钟
之后每次用只要 5-10 分钟
之后每次用只要 5-10 分钟
用 2 次就开始赚了，用 5 次能省将近 2 小时，用 10 次能省近 5 小时
用 2 次就开始赚了，用 5 次能省将近 2 小时，用 10 次能省近 5 小时
Skill 到底是什么？
说白了，Skill 就是一个 Markdown 文件，里面写着"遇到这种情况该怎么做"。Claude Code 读了就会按你说的办。
Skill 放在两个地方：
项目级
：.claude/skills/（跟代码放一起，团队都能用）
：.claude/skills/（跟代码放一起，团队都能用）
个人级
：~/.claude/skills/（存在你自己的电脑上，所有项目都能用）
：~/.claude/skills/（存在你自己的电脑上，所有项目都能用）
Skill 和提示词有啥区别？
Skill 的文件长啥样
每个 Skill 就是一个文件夹，里面至少有一个 SKILL.md 文件：
.claude/skills/
├── feedback-synthesis/
│ └── SKILL.md
├── release-notes/
│ ├── SKILL.md
│ └── resources/
│ └── customer-voice-guide.md
└── prd-audit/
├── SKILL.md
└── resources/
└── prd-checklist.md
自动发现
：你说"帮我汇总这些反馈"，Claude Code 自动匹配到对应的 Skill。
：你说"帮我汇总这些反馈"，Claude Code 自动匹配到对应的 Skill。
斜杠命令
：直接输入 /feedback-synthesis，强制运行。
：直接输入 /feedback-synthesis，强制运行。
⚠️ 要注意：Skill 的描述里要写用户平时会说的话。写"分析客户情感数据"不如写"汇总客户反馈、NPS调查、支持工单"——因为大家平时说的是"帮我汇总一下反馈"，而不是"分析一下情感数据"。
Skill 里面都有什么？
一个 Skill 文件夹可以放这些文件：
SKILL.md 是主文件
里面最重要的部分叫 YAML 头信息，用 --- 包起来，告诉 Claude Code 这个 Skill 是干什么用的。
---
name: standup-notes
description: 根据昨天的 Git 提交生成晨会记录。当用户提及晨会、每日更新或我昨天做了什么时使用。
---
YAML 头后面就是正文，用 Markdown 格式写，告诉 Claude Code 具体怎么做：
# 晨会记录
## 目的
根据最近的提交生成格式化的晨会记录。
## 输入
- 包含提交历史的 Git 仓库
## 流程
1. 读取过去 24 小时的提交
2. 按类型分组（功能、修复、重构）
3. 以第一人称、过去时态撰写
## 输出
将晨会记录打印到终端。不要创建文件。
参考文件（resources/）
如果你的 Skill 比较复杂，可以把一些固定内容放到单独的文件里，这样 SKILL.md 保持清爽：
feedback-synthesis/
├── SKILL.md
└── resources/
├── category-definitions.md # 分类标准
├── output-template.md # 输出格式模板
└── quality-rubric.md # 质量评分标准
类别定义
：分类标准写在单独文件里，不用堆在 SKILL.md 中
：分类标准写在单独文件里，不用堆在 SKILL.md 中
输出模板
：输出的格式模板
质量评分标准
：怎么判断输出好不好
风格指南
：用什么样的语气和措辞
：用什么样的语气和措辞
在 SKILL.md 里引用它们："使用 resources/category-definitions.md 中的定义对反馈进行分类。"
如果 Skill 要生成文档，最好提前定好输出长什么样：
## 输出格式
生成文件：`reports/feedback-synthesis-[date].md`
遵循以下结构：
# 反馈综合报告：[日期范围]
## 执行摘要
[3-5 个关键发现的要点]
## 主题分析
### 主题 1：[名称]
- **出现频率：** [计数] 次提及（[百分比]%）
- **情感倾向：** [正面/负面/混合]
- **代表性引述：**
- "[引述 1]"
- "[引述 2]"
- **影响分析：** [这对产品意味着什么]
[为每个主题重复此结构]
## 建议
[按优先级排序的建议行动列表]
## 方法论
[数据来源和分析方法的简要说明]
脚本（scripts/）
有些复杂操作可以放脚本文件：
release-notes/
├── SKILL.md
└── scripts/
└── fetch-jira-tickets.py
不过对大部分人来说，脚本不是必需的。只有在需要调用外部 API、处理超大数据集、或者转换数据格式时才会用到。
🔗 原文链接: 点击阅读原文
文章评论