怎样写一个真正会被用上的 AI 技能（SKILL.md）
AI 技能是一个纯文本文件——通常叫 SKILL.md——顶部是一个名字和一行说明什么时候适用的描述，下面是方法：步骤、检查项、产出的形状。想写一个会被用上的技能：描述它适用的情境而不是它的内容，让方法具体到可以被照字面执行，第一次让你失望时就去改它。
当你第三次往对话框里敲同一句指令——「先写决定，每条都要有负责人和日期」——这句话就已经成了一个技能。只是还没被存下来。
技能、提示词和自定义指令
- 一条存下来的提示词，是你粘贴的文字。只有你记得它存在，它才管用。
- 自定义指令作用于每一条消息。适合长期偏好（「用简体中文」「简短一点」），不适合某一类活，因为它也会作用于其他所有类型的活。
- 一个技能只作用于一类活，按名字调用，或者在活对得上时被选中，并且以一个你能读、能改、能发给别人的文件存在。
这种格式在各种 AI Agent 工具里流行开来，是因为它简单：一个 Markdown 文件，一段简短的头部，加上正文。
它的结构
---
name: meeting-notes
description: 当需要把零散的会议笔记或逐字稿整理成决定和行动项的记录时使用。
---
1. 先写决定。每条都要有负责人和日期。如果没有约定日期，写「未约定日期」，而不是编一个。
2. 然后是待解决的问题，每个都写明预计由谁来回答。
3. 只有当某件事没法表达成决定或问题时，才写一小段叙述。
4. 笔记里没点名的人，绝不把一句话归到他名下。
两部分，各管各的事。
描述决定这个技能会不会被选中。 当 AI 自动选择技能时，在需要某一个之前，它通常只看得到名字和描述。所以把描述写成它适用的情境——「当需要把零散笔记整理成决定时使用」——而不是对内容的概括。
正文决定被选中之后发生什么。 把它写成给一位会照字面执行的细心同事的指令。具体胜过巧妙：「如果没有约定日期，写未约定日期」比「日期要准确」管用得多。
让技能起作用的五条规则
- 一个技能只管一件活。 「会议纪要」是一个技能。「写作助手」是一个愿望。
- 说清信息缺失时怎么办。 那正是模型即兴发挥的地方，而即兴发挥就是它们编造东西的地方。
- 描述产出的形状。 一个清单、一张有这几列的表、四个象限。形状比语气更容易照着做。
- 书架保持小。 描述互相重叠，对的那个就更难被选中。用不上的就撤下。
- 改那一行，而不是整个文件。 结果不对时，通常是指令没说出你的意思。改那一行，再跑一遍。
安装之前先读一遍
技能里没有代码，但文字依然可能让 AI 做你不会选择的事。别人写的技能，安装之前完整读一遍，就像运行一段脚本之前会读一遍一样。
在 MindMax 里
技能是你文件夹里的文件：把一个 SKILL.md 放进技能文件夹就算数；挪出去就不算。输入 / 按名字调用，或者描述任务，让对得上的那个被选中。输入 /new-skill，用大白话描述方法，你会拿到一份起草好的技能，读过再批准——你不点头，什么都不会保存。
同一个技能可以在对话、画布和编辑器里分别打开。在对话里，它可以多轮进行，读你的文档。在画布卡片上，它的产出以方法要求的形状返回，比如一张表或四个象限。在编辑器里，它作用于你选中的段落，以修订形式返回。
为别的 Agent 工具写的 SKILL.md 可以作为对话技能使用，有一条边界：只带过来文字。技能文件夹里的脚本或其他文件不会运行，依赖 MindMax 没有的工具的步骤也不会发生。
技能做不到的事
技能是指令，不是新能力。它改变的是用 AI 已有的能力——读你的文档、搜索、写文件——完成一件活的方式。如果你希望增加一项能力，这是错误的机制。
更多见 AI 技能，分步做法见使用和编写技能。单独的定义在术语表里：Agent 技能。内置技能大多是经典方法——见画布上的思维模型。