SkillPedia Skills Encyclopedia
中文 EN
今日更新 2026-11-17 UTC

今天还没有新提交

查看更新动态

AI 与大模型 · 入门

SKILL.md(技能说明文件)

一个技能包里的核心说明书,用大白话写清这个技能干什么、什么时候用、按什么步骤做。模型读到它,就照着上面说的执行。

AI 与大模型 入门 站内文案里出现过 107 次,涉及 54 个条目 446 字 约 1 分钟读完 45 次阅读

TL;DR三十秒版本

  1. 一个技能包里那份用大白话写的说明书,讲清它干什么、什么时候该用。
  2. AI 读到它,就照着上面写的步骤和规矩去干活。
  3. 它是文档不是程序,写得含糊也不会报错,只会被理解歪。

Overview详细说说

SKILL.md 是一个文件名,通常放在技能包的最外层,充当整包的主说明。里面不是代码,而是用自然语言写的:这个技能解决什么问题、什么情况下该用它、具体分成哪几步。模型读到这份文件,就按上面的说法干活。它是纯文本,用任何编辑器都能打开和修改。

它的价值在于可移植。各家工具有自己的私有格式,模型换一个就跑不起来;而一份按通用写法组织、结构清楚的说明,多个 AI 工具都能读、都能照做。换句话说,写得好的说明可以在工具之间搬来搬去。这也是它用普通文字而不是某种专用语言来写的原因。

拿它和提示词比:提示词是一次性的,说完就过去了;SKILL.md 是留在技能包里的常驻说明,每次调用都被重新读一遍。拿它和程序比:程序写错会报错,说明书含糊却不会有任何提示,模型只会按自己的理解做偏,等到结果出来才知道不对。

所以它的效果几乎全看写得清不清楚。步骤含混、适用边界没交代、该说什么时候不要用它却漏了,最后都会体现成模型乱来。写的时候可以假设读者第一次接触这个技能,把判断条件和例外情况一并写进去,比单纯把步骤列得多更管用。

Myths常见误解

  • 以为它是另一种更高级的提示词 提示词说完就过去了,这份说明长期留在包里,每次调用都被重新读
  • 以为写错了会像程序一样报错 文档不会报错,它只会按自己的理解做偏,等结果出来才发现不对
  • 以为步骤列得越多越好 关键是写清用它的条件和不该用的时候,光堆步骤照样跑偏

In practice你会在哪用到它

  • 给一个批量处理表格的技能写说明,把适用场景和例外都写上
  • 把这个技能包换到另一个 AI 工具里,它能照读照做
  • 发现 AI 用技能时乱来,回去检查说明是不是没交代边界

Summary记住这几点就够了

  • 技能包里负责说明的核心文件
  • 用普通文字写清用途、时机和步骤
  • 写法通用,多种 AI 工具都能读
  • 它是文档不是程序,写不清楚效果就差

常见问题

SKILL.md(技能说明文件)是什么意思?

一个技能包里那份用大白话写的说明书,讲清它干什么、什么时候该用。AI 读到它,就照着上面写的步骤和规矩去干活。它是文档不是程序,写得含糊也不会报错,只会被理解歪。

SKILL.md(技能说明文件)一般用在什么地方?

给一个批量处理表格的技能写说明,把适用场景和例外都写上;把这个技能包换到另一个 AI 工具里,它能照读照做;发现 AI 用技能时乱来,回去检查说明是不是没交代边界。

关于SKILL.md(技能说明文件),最容易搞错的是什么?

以为它是另一种更高级的提示词,其实提示词说完就过去了,这份说明长期留在包里,每次调用都被重新读;以为写错了会像程序一样报错,其实文档不会报错,它只会按自己的理解做偏,等结果出来才发现不对。

SKILL.md(技能说明文件)要记住哪几点?

技能包里负责说明的核心文件;用普通文字写清用途、时机和步骤;写法通用,多种 AI 工具都能读;它是文档不是程序,写不清楚效果就差。

容易踩的坑 说明书含糊时模型不会报错,只会自己猜着做,所以能用的边界和禁忌都要写进去。

全站第 21 / 186 条 · 全部词条

接着读Related reading

接着去哪Explore more

回到技能本身

词典里讲到的这些概念,大多一条命令就能装进你的 AI 客户端。