把反复要做的活儿固化成 Skill

同一套流程你粘贴了第三遍，就该把它变成一个 Skill。和 CLAUDE.md 的关键区别：Skill 的正文只在用到时才加载，长材料放进去几乎不占成本。

2026/08/06约 7 分钟HiBridge 原创

方法来源本文由 HiBridge 撰写，方法来自下面的出处。

出处: Extend Claude with skills
来自: Anthropic 官方文档
查证日期: 2026/08/06

CLAUDE.md 适合放事实——术语表、口径、禁忌。

但有些东西不是事实，是流程：「访谈编码要走哪五步」「提案交出去前要检查哪八条」。这类内容塞进 CLAUDE.md 会有两个问题：文件越来越长，而且每次会话都在加载它，哪怕这次你根本不做编码。

Skill 就是为这个场景准备的。

什么时候该建一个 Skill

官方给的判断标准很直接：

当你反复把同一套指令、清单或多步流程粘进对话时，或者当 CLAUDE.md 里的某一节已经长成了一套流程而不是一条事实时，就该建一个 Skill。

关键区别在这里：

和 CLAUDE.md 的内容不同，Skill 的正文只在被用到的时候才加载，所以很长的参考材料在你需要它之前，几乎不产生任何成本。

这一条决定了两者的分工：

	CLAUDE.md	Skill
放什么	事实：术语、口径、约定	流程：多步的做法、检查清单
什么时候加载	每次会话都加载	只在用到时加载
长度	官方建议 200 行以内	可以很长，不用时不花钱

怎么建

一个 Skill 就是一个目录加一个文件：

~/.claude/skills/interview-coding/SKILL.md

文件内容是 YAML frontmatter 加正文：

Markdown

---
name: interview-coding
description: 按项目既定框架对访谈转录稿逐份编码。处理深访、焦点小组转录稿时使用。
---

## 编码流程

1. 先读 @docs/编码框架.md，确认本项目的类目定义
2. 逐段处理，不要跳读
3. 每一段输出：类目 | 支撑原话（逐字摘录） | 访谈编号
4. 无法归入任何类目的，写「未分类」，不要勉强归类
5. 全部处理完后，输出一张各类目的计数表

## 硬要求

- 原话必须逐字摘录，不做任何润色
- 受访者一律用编号，不出现真实姓名
- 材料里没有依据的，写「材料未涉及」，不要推断

之后在对话里敲 /interview-coding 就能调用，或者 Claude 判断相关时会自己用。

放在哪里

位置	路径	作用范围
个人	`~/.claude/skills/<名字>/SKILL.md`	你的所有项目
项目	`.claude/skills/<名字>/SKILL.md`	只在这个项目
企业	由 IT 通过管理设置分发	组织内所有人

同名时的优先级：企业 > 个人 > 项目。

团队共用的流程放项目级，随版本库分发，全组一致。你自己的习惯放个人级。

description 是最重要的一个字段

所有字段都是可选的，但 description 强烈建议写——Claude 靠它判断什么时候该用这个 Skill。

官方有一条容易被忽略的提醒：

把关键用例放在最前面：description 与 when_to_use 合并后的文本，在技能列表中会被截断到 1,536 个字符，以减少上下文占用。

所以：

❌ 「这个技能是我们团队在 2026 年为某类项目开发的一套流程，涵盖了……」（关键信息被埋在后面）
✅ 「按项目既定框架对访谈转录稿逐份编码。 处理深访、焦点小组转录稿时使用。」

第一句话就说清「做什么 + 什么时候用」。

几个有用的字段

YAML

---
name: proposal-redteam
description: 以评审视角审查提案初稿，逐条对照 RFP 评分标准挑毛病。提案定稿前使用。
when_to_use: 用户提到提案、标书、RFP 应答、Red Team 审查时
disable-model-invocation: true
allowed-tools: Read Grep
---

when_to_use——补充说明触发时机
disable-model-invocation: true——只能由你手动 /调用，Claude 不会自己用它。适合那些「必须由人决定什么时候跑」的流程
allowed-tools——限制这个 Skill 运行时能用哪些工具

研究咨询里值得固化的几件事

按「你今年粘贴过几次」排序：

一、访谈编码流程——框架、输出格式、追溯要求。这是最高频的。

二、提案交付前的检查——对照 RFP 评分标准逐条核。具体做法见写提案：AI 该在哪一步介入里的 Red Team 提示词，把它写成 Skill 就不用每次重贴。

三、桌面研究的检索规范——必须标来源、标日期、标出哪些结论只有单一来源。

四、报告格式统一——数字精度、图表标注、术语一致性。

五、转录前的术语表准备——见转录访谈时模型为什么会听错品牌名。

自定义命令已经合并进来了

如果你以前用过 .claude/commands/ 目录：

自定义命令已合并进技能。 .claude/commands/deploy.md 和 .claude/skills/deploy/SKILL.md 都会创建 /deploy，工作方式相同。你已有的 .claude/commands/ 文件继续有效。

Skill 多出来的是：可以带一个目录放配套文件、可以用 frontmatter 控制由谁调用、以及可以让 Claude 在相关时自动加载。

建完之后

别信「跑一遍看着对」。 一份 Skill 有没有真的生效、是不是被环境里别的东西推着生效的，需要专门验证——见你以为规则生效了，其实是别的东西在起作用。

最省事的一招：在 Skill 里埋一个可搜索的标记（比如要求每段结尾必须带访谈编号），事后直接搜这个标记在不在。把「它照做了吗」变成一个能用机器回答的问题。

从哪开始

和 CLAUDE.md 一样的建议：从你这个月粘贴过第三次的那段话开始。

不用一开始就写得完整。先把那五步写下来，用几次，遇到它做偏的地方再补一条规则。三个月后，那个文件就是你这套方法本身。