官方技能 · AI 实践

把提示词变成技能

把一段好用的提示词改写成可复用的 SKILL.md:合规的名称、说明何时使用的描述、步骤、输出模板、示例和检查项。

可在 Claude、ChatGPT 和编程智能体中使用。在 Team 和 Business 套餐中,Pod 里的官方技能会在我们改进后自动更新到最新版。

适用场景

你需要提供

你会得到

一份完整的 Agent Skills 格式 SKILL.md 文件,已用新输入测试过。

工作方式

  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 行。

SKILL.md 全文

这就是 AI 读取的完整文件。 下载

---
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 无法把请求和它匹配,就不会选用这个技能。

与团队共享

把它添加到 AI Skill Pod,团队里的每个人(包括外包人员)都能在自己的 AI 中使用同一个版本。 了解与团队共享 AI 技能的最佳方式

添加到团队的 Pod

更新记录

参考来源

  1. Specification - Agent Skills (2026-11-04 查阅)
  2. Skill authoring best practices - Claude Docs (2026-11-04 查阅)