别再每次都手动敲指令了

你有没有这种经历：每个月都要汇总一遍客户反馈。打开 Claude Code，打一串差不多的指令，等结果，发现忘了指定输出格式，又改一下，勉强能用。下个月再来一次，又不记得上次怎么写的了，花20分钟重新试出正确的指令，输出跟上个月还不一样，想对比都没法比。

这就是提示词跑步机效应——反复做同样的事，但每次都在重复劳动，没有积累。

Skill 就是来解决这个问题的。 Skill 就像一个写好的"作业模板"。你只需要把模板做好，之后喊一声"跑一下"，它就会按你定的流程自动干活。

那建一个 Skill 到底值不值？ 算笔账就清楚了：

• 第一次建 Skill 大概要 30-60 分钟

• 之后每次用只要 5-10 分钟

• 用 2 次就开始赚了，用 5 次能省将近 2 小时，用 10 次能省近 5 小时

---

Skill 到底是什么？

说白了，Skill 就是一个 Markdown 文件，里面写着"遇到这种情况该怎么做"。Claude Code 读了就会按你说的办。

Skill 放在两个地方：

• 项目级

  ：.claude/skills/（跟代码放一起，团队都能用）

• 个人级

  ：~/.claude/skills/（存在你自己的电脑上，所有项目都能用）

Skill 和提示词有啥区别？

对比方面	临时提示词	Skill
用完还在不在？	会话结束就没了	存在文件里
下次还能用吗？	靠脑子回忆	喊名字就行
每次结果一样吗？	每次不一样	流程固定
能分享给别人吗？	复制粘贴发给对方	Git 提交就行了
能改进吗？	丢了就找不到了	有版本记录

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 

Skill 怎么用？

两种方式：

1. 自动发现

   ：你说"帮我汇总这些反馈"，Claude Code 自动匹配到对应的 Skill。

2. 斜杠命令

   ：直接输入 /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 里引用它们："使用 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、处理超大数据集、或者转换数据格式时才会用到。

完整的 Skill 目录长这样

 skill-name/
├── SKILL.md               # 必需：核心指令
├── resources/              # 可选：参考文档
│   ├── template.md
│   └── rubric.md
├── scripts/                # 可选：辅助脚本
│   └── helper.py
└── examples/               # 可选：示例输入/输出
    ├── sample-input.csv
    └── expected-output.md 

examples/ 文件夹可以放一些示例，方便其他人理解这个 Skill 是干什么的。