---
name: prompt-to-skill
description: 把一段效果很好的提示词或对话，按 Agent Skills 格式改写成团队可共享、可复用的 SKILL.md：合规的 name、说明做什么和何时使用的 description、所需输入、带判断规则的编号步骤、输出模板、完整示例和检查项。适用于有人说“把这个存成技能”“做成可复用的”“把我的提示词变成技能”，想把提示词分享给团队，或问怎么为 Claude、ChatGPT 或编程智能体写 SKILL.md 时。
---

# 把提示词变成技能

好用的提示词只存在于一个人的聊天记录里；技能能让整个团队得到同样的结果。Agent Skills 格式是一个包含 SKILL.md 的文件夹：开头是含 `name` 和 `description` 的 front matter，后面是说明。在任务匹配之前，AI 只读 name 和 description，所以 description 决定了这个技能会不会被用上；正文只需要写 AI 默认不会做的事。

## 适用场景

- 某个提示词或某次对话的结果，有人想再要一次。
- 团队里好几个人各自写着同一个提示词的不同版本。
- 把一份很长的“提示词模板”文档，改成 AI 能自己调用的东西。
- 不适用于一次性的问题，也不适用于 AI 一句话就能做好的任务。

## 需要准备

- 提示词，或效果好的那次对话，包括过程中你给出的修正。修正才是最有价值的部分。
- 1–2 个你满意的输出示例。
- 谁会用这个技能、在哪些工具里用。不清楚的话，就按通用 AI 来写，避免使用特定工具的功能。

## 步骤

1. **找出可复用的部分。** 把固定的内容（流程、格式、规则、你给过的修正）和每次都会变的内容（输入）分开。会变的部分写进“需要准备”。
2. **起名。** 小写字母、数字和连字符，不超过 64 个字符，与文件夹名一致；不含“claude”或“anthropic”。用它做什么来命名：`weekly-client-report`、`processing-invoices`。避免含糊的名字（`helper`、`utils`）。
3. **写 description。** 用第三人称，不超过 1,024 个字符，不含 XML 标签。先说它做什么，再写何时使用（中文写“适用于……”，英文写“Use when...”），用上用户真正会输入的词（“复盘”“跟进”“会议纪要”）。AI 就是拿这段话去匹配请求的；含糊的描述（“帮助处理文档”）永远不会被触发。
4. **写步骤。** 编号，每步有一个简短的名称和一条具体规则。只保留会改变输出的指令：你在对话中做过的修正、阈值、“如果 X，就 Y”的判断。删掉 AI 本来就知道的解释。
5. **加上输出模板和一个示例。** 一个放在代码块里、带 [占位符] 的模板，然后是一个真实的输入及其完整输出。一个具体示例教格式，胜过好几段描述。
6. **加上检查项。** 4–7 条 AI 在回答前执行、可以验证的检查（“每个待办事项都有负责人”），而不是愿望（“质量要高”）。
7. **用新的输入测试。** 在新对话里用 3 个不同的真实输入运行，其中一个是棘手的情况。把它做错的地方改进技能里，再运行一次。正文控制在 500 行以内；这个技能库的技能都力求远少于 200 行。

## 输出格式

````markdown
---
name: [小写连字符名称]
description: [它做什么，第三人称]。适用于 [场景，以及用户会输入的词]。
---

# [标题]

[1–3 句：好的输出能达到什么，以及背后的原则。]

## 适用场景
- [场景]
- 不适用于 [不该由它处理的相近任务]。

## 需要准备
- [输入] — 缺少时，[问一次 / 继续做并标注“[假设]”]。

## 步骤
1. **[步骤名称]。** [带判断规则的具体指令。]

## 输出格式
```markdown
[带 [占位符] 的模板]
```

## 示例
**输入：** [真实的输入]
**输出：** [完整输出]

## 发送前检查
- [ ] [可验证的检查]
````

## 示例

**输入：** “我老是把这段话粘贴到 ChatGPT 里：‘这是我和客户通话的记录。写一封跟进邮件：感谢对方，回顾我们谈妥的内容，列出带日期的下一步，400 字以内，不要套话，最后提一个明确的问题。’我通常还得提醒它用客户自己的说法，不要编造日期。”

**输出：**

````markdown
---
name: call-follow-up-email
description: 根据零散的通话记录，写一封客户通话后的简短跟进邮件：致谢、回顾谈妥的内容、带负责人和日期的下一步，以及一个收尾问题，400 字以内。适用于有人发来通话记录，要求写跟进邮件、回顾邮件，或说“给他们发个总结”时。
---

# 通话跟进邮件

跟进邮件趁通话记忆犹新时确认谈妥的内容，免得事情走样。写得简短，用客户自己的说法，最后提一个能推动进展的问题。

## 适用场景
- 销售或客户通话之后，根据记录或转写稿来写。
- 不适用于发给从未沟通过的人的陌生开发邮件。

## 需要准备
- 通话记录。如果缺少下一步的日期，写“日期待定”，不要自己编。
- 客户的姓名和公司。

## 步骤
1. **只回顾谈妥的内容。** 对方的目标和用词，用客户自己的说法。
2. **列出下一步。** 每项都有负责人和来自记录的日期，或写“日期待定”。
3. **以一个问题结尾。** 推进所需的那一个答案。
4. **删减到 400 字以内。** 不要套话；一句话只讲一件事。

## 输出格式
```markdown
主题：[公司] — [日期] 通话后的下一步

[姓名]，您好：

感谢您 [具体的事]。回顾一下，我们谈妥了 [1–2 行]。

下一步：
- [负责人]：[日期或“日期待定”] 前 [事项]

[一个问题]？

[签名]
```

## 示例
**输入：** “和港湾科技的林芸通了电话。他们想缩短新客户上手时间。谈妥做 2 周试点。我周五前发试点方案。需要知道他们的管理员是谁。”
**输出：**
主题：港湾科技 — 今天通话后的下一步
林芸，您好：感谢您向我介绍贵司的客户上手流程。回顾一下，我们谈妥了做 2 周试点，重点是缩短上手时间。
下一步：
- 我方：周五前发出试点方案
- 港湾科技：为试点指定一位管理员，日期待定
请问试点应该把谁设为贵司的管理员？

## 发送前检查
- [ ] 400 字以内。
- [ ] 每个日期都来自记录，或写明“日期待定”。
- [ ] 以且仅以一个问题结尾。
- [ ] 用的是客户的说法，不是我们的。
````

## 发送前检查

- [ ] name 为小写加连字符，不超过 64 个字符，不含“claude”或“anthropic”。
- [ ] description 用第三人称，说明了做什么并写明何时使用（“适用于……”或“Use when”），不超过 1,024 个字符，不含 XML 标签。
- [ ] 原对话中的每一次修正，都成了一个步骤或一条检查。
- [ ] 技能有输出模板和一个完整的示例。
- [ ] 已用 3 个新输入测试过，修正也写回了技能里。

## 常见错误

- 原样照搬提示词。把你不得不给的提醒（“不要编造日期”）变成步骤；这正是技能增加的价值。
- 解释 AI 已经知道的东西（“邮件是一种消息……”）。每一行都占用上下文；只保留会改变输出的内容。
- description 只说做什么，不说何时用。AI 无法把请求和它匹配，就不会选用这个技能。