适用场景
当你第三次向 AI 口述同一份说明时,应立即停止,并将该说明写成 Skill。
典型症状:每周重复同一套发布流程;每次都要解释项目约定;在不同对话里复制粘贴同一段 prompt。
部件构成
一个 Skill 就是一个文件夹。核心部件是 SKILL.md,见 FIG. 2-1。
---
name: publish-post
description: 当用户说"发布这篇"时,把 Markdown 草稿整理成可发布的文章。
---
# 步骤
1. 规范 frontmatter(title, date, tags)
2. 运行 scripts/links.py 检查死链
3. 生成 120 字以内的摘要
# 绝不
- 不改动正文观点与措辞
# 完成时
- 输出 checklist.md,全部打勾KEY · 图注
- 1LINE 03description 决定 AI 什么时候调用它——写触发场景,不写功能介绍。
- 2LINE 11“绝不”比“步骤”更重要:边界写清楚,AI 才不越界。
- 3LINE 14可验证的完成标准,AI 才知道什么时候停。
SKILL.md 应控制在 60 行以内,仅包含“步骤”“绝不”和“完成时的样子”。
故障排除
WARNING · 400 行的
SKILL.md 不会让 AI 更聪明,只会让它更困惑。| 症状 SYMPTOM | 处理 REMEDY |
|---|---|
| AI 在任意位置停下 | 补写验收标准(完成时的样子) |
| Skill 被用在无关任务上 | 收窄触发条件,写明“不适用于” |
| 输出格式每次不同 | 提供模板文件,而非文字描述 |
日常操作
写完草稿后,只需下达一条指令:“发布这篇”。省下的五十分钟,请用于撰写下一篇。
END OF ENTRY