跳到主要内容
术语表

Agent 技能(SKILL.md)

定义

Agent 技能是一组打包好的指令——通常是一个 SKILL.md 文件,包含一个名字、一行「什么时候用」的描述,以及下面的方法——AI Agent 平时只凭描述记着它,任务需要时才完整读一遍。

格式
一个 Markdown 文件,SKILL.md
决定何时运行的
那一行描述
它不是
新能力或代码

技能是什么​

认真用 AI 的人,大多会一遍遍重新敲同样的指令:读书笔记该怎么排、会议纪要必须包含什么、一份草稿得通过哪些检查。或者攒一份提示词文档,从里面复制粘贴,直到需要的那条恰好是你忘了自己写过的那条。

技能就是把这段解释存一次,存成 Agent 能自己找到的形式。常见的形态是一个 SKILL.md 文件,顶部两行——一个名字,一段什么时候用的描述——下面是方法:步骤、要检查什么、产出该是什么样。

设计上的巧妙之处在于 Agent 眼里留着什么。它只记着名字和描述;当一个请求和某条描述对上时,才把那一个技能完整读一遍。这就是为什么技能能扩展,而一段长长的系统提示词不能。

技能会在哪里出问题​

  • 选择靠的是描述。 自动匹配读的是那一行「什么时候用」,而不是方法本身。写成内容概括的描述(「会议纪要指南」),比写成适用情境的描述(「当用户粘贴一段会议逐字稿或零散笔记时」)更难被准确选中。
  • 不是越多越好。 描述互相重叠,对的那个就更难被选中。几个写得准的,胜过一整个书架。
  • 技能没法增加能力。 如果一个技能让 Agent 运行一段脚本、调用一个它没有的工具,那几步就是不会发生。它是方法,不是插件。
  • 导入的技能,是你同意遵循的指令。 纯技能里没有代码,但文字依然可能让 Agent 做你不会选择的事。安装之前读一遍,就像运行一段脚本之前会读一遍一样。

MindMax 怎样处理​

MindMax 里的技能是你文件夹里的文件,而不是账号里的设置:放进技能文件夹就算数;挪出去就不算。同一个技能可以在对话、画布和编辑器里分别打开,每个地方各做它擅长的事——对话里是一份报告,画布上是几条分支,选中的文字上是一处修订。输入 / 按名字调用,或者输入 /new-skill 描述一个方法,拿回一份草稿,读过再保存。为别的 Agent 工具写的 SKILL.md,可以作为对话技能使用;只带过来它的文字。完整说明见 AI 技能。

毕业论文/只对这个项目
.mindmax/skills/meeting-notes.md ✓ 生效
old-checklist.md挪出去了——不再生效
你的技能/对所有项目
house-style.mdverify-claims.md
meeting-notes整理会议记录时使用
方法正文 · 只在遇到这件活时才读
  1. 先写决定,而不是谁说了什么
  2. 每项行动都要有负责人和日期
  3. 没定日期?标为「待商定」
house-style稿子要以团队名义发出之前使用
verify-claims当用户问某个说法站不站得住时使用
……书架上其余的技能,每个一行
把内置技能改成你的
verify-claims · 内置verify-claims · 你的副本
删掉你的副本,内置版就回来了。
分享出去
一个 Markdown 文件。没有技能市场,也不需要账号。

技能放在哪里、AI 眼里留着什么、技能怎样修改和分享——全都是一个文件。

打开一个技能:一个名字、一句什么时候用、方法,以及它可以在哪里运行。

常见问题

什么是 Agent 技能?

写成文件的可复用方法——通常是一个 SKILL.md,包含名字、一行什么时候用的描述和步骤——AI Agent 只在任务和描述对得上时才加载它。

技能和自定义指令有什么不同?

自定义指令作用于每一条消息。技能只作用于一类活,按名字调用或靠描述匹配,只在需要时才完整读——所以你可以留很多个,而不会挤占每一次对话。

别的 Agent 工具里的 SKILL.md,能在 MindMax 里用吗?

能,作为对话技能:名字、描述和方法都会带过来。技能文件夹里的脚本或其他文件不会运行,依赖 MindMax 没有的工具的步骤也不会发生。

技能能给 AI 新能力吗?

不能。技能改变的是 Agent 用它已有的能力完成一件活的方式。增加能力需要工具或代码,而纯技能里没有这些。