← BACK TO CONTENTS
CHAPTER 01 · AI Skills · § 1.1

把重复劳动写成一个 SKILL.md

Turning chores into a Skill

适用场景

当你第三次向 AI 口述同一份说明时,应立即停止,并将该说明写成 Skill。

典型症状:每周重复同一套发布流程;每次都要解释项目约定;在不同对话里复制粘贴同一段 prompt。

部件构成

一个 Skill 就是一个文件夹。核心部件是 SKILL.md,见 FIG. 2-1。

LISTING2-1
FILE · 文件publish-post/SKILL.md
LANGMarkdown
LINES15
---
name: publish-post
description: 当用户说"发布这篇"时,把 Markdown 草稿整理成可发布的文章。
---

# 步骤
1. 规范 frontmatter(title, date, tags)
2. 运行 scripts/links.py 检查死链
3. 生成 120 字以内的摘要

# 绝不
- 不改动正文观点与措辞

# 完成时
- 输出 checklist.md,全部打勾
KEY · 图注
  1. 1LINE 03description 决定 AI 什么时候调用它——写触发场景,不写功能介绍。
  2. 2LINE 11“绝不”比“步骤”更重要:边界写清楚,AI 才不越界。
  3. 3LINE 14可验证的完成标准,AI 才知道什么时候停。
FIG. 2-1 · SKILL.md 全文 · 在 SKILL 库下载(SK-01)悬停 ● 查看图注

SKILL.md 应控制在 60 行以内,仅包含“步骤”“绝不”和“完成时的样子”。

故障排除

WARNING · 400 行的 SKILL.md 不会让 AI 更聪明,只会让它更困惑。
症状 SYMPTOM 处理 REMEDY
AI 在任意位置停下 补写验收标准(完成时的样子)
Skill 被用在无关任务上 收窄触发条件,写明“不适用于”
输出格式每次不同 提供模板文件,而非文字描述

日常操作

写完草稿后,只需下达一条指令:“发布这篇”。省下的五十分钟,请用于撰写下一篇。

END OF ENTRY