技能说明文件
SKILL.md
学到 能改 就够:能自己调整和排错
你可能会说
“我打开技能文件夹看到一个 SKILL.md,它的开头和正文分别有什么作用?只改里面的说明,是否就能改变助手做法?”
SKILL.md 是 Agent Skills 格式要求的入口文件,开头元数据说明名称和适用场景,正文写任务方法;它是供智能体读取的说明,不会自行执行。
使用 AI
科研里的例子
为访谈编码技能写清输入是去标识文本,输出是代码、原句和疑问;把范例表放在参考目录,由正文说明读取时机。
规范要求该文件包含 YAML 前置信息和 Markdown 正文,至少提供 name 与 description。名称帮助识别,描述帮助判断何时加载,正文才展开具体步骤;更多脚本与参考可以通过链接按需读取。宿主如何赋予工具权限、处理实验字段和发现路径,仍属于具体实现。写得含混会造成误触发,正文与脚本不一致则可能让实际行为偏离技能声明。
在你的学科里,直接拿去用
把模糊需求变成可执行任务
我不熟悉AI术语。请把我的需求转成明确的任务说明。 我的原话:[粘贴] 可用材料:[列出文件、表、链接或说明目前没有材料] 使用者与用途:[填写] 先用普通中文复述目标,再给需要时才用的关键中英术语。区分任务、输入、约束、输出和可检查的完成标准。若缺项会实质改变结果,最多问3个问题;其他假设明确列出。先交付任务说明,不擅自执行与改文件。方括号里的内容换成你自己的。来自知识增量《科研中英表达与 Prompt 指南》PG01
判断
亲手检查一次
核对 name、description 与正文任务是否一致,再运行一个应触发和一个不应触发的例子,检查宿主是否实际读取文件。
它做不到的
文件名符合规范不代表技能已经安装或生效,修改正文也不会改变模型本身;不能把密钥和私密访谈原件随包发布。
增量,由你来写
读完这张,你的理解变了什么?
留言功能会在后面的版本开放。现在可以先在 X 上 @knowledgedelta 告诉我。