波仔
🧡 第十三章 实战项目2：内容创作自动化
📄 一句话概括

skill 就是一个固定结构的文件夹：SKILL.md 是入口，description 那句决定它何时被找到；名字描述常驻、正文按需、长文再按需，这是它省上下文的原因。

📝 本节和前面几节的关系

前两节把规矩摆好了；这一节开始把【重复的活】做成能反复调用的东西——第一个 skill。

一、skill 就是一个文件夹

SKILL.md：入口，说明它是什么、什么时候用。 scripts/：可选，真正干活的脚本。 references/：可选，用到才读的长文档。assets/：可选，模板与样式。 结构固定是刻意的——固定才可预期，可预期才敢反复用。

二、SKILL.md 骨架

文件开头是一小段元信息：名字，和一句 description。 description 是关键：一句话说清它干什么、什么时候该用它。 这句就是它被找到的唯一依据——写不清，这个 skill 等于没有。

三、三层加载，为什么省

名字与描述：每次会话都看得到——用来判断该不该用它。 SKILL.md 正文：真的用到这个 skill 时才读进来。 references/ 里的长文：正文里明确指到它时才读。 于是不用的 skill 只花一句描述的钱——这正是它比【全塞进规则文件】划算的地方。

四、第一个 skill 做什么最容易成

挑一件你天天都在做的重复活（第 7.2 节）。 对内容创作者来说，最常见的就是：把一段素材整理成初稿。 做法：先带它手动走一遍，确认流程顺了，再把这一遍写成 SKILL.md。

五、动手 Demo：创建你的第一个 skill

下面给 skill 的目录结构、SKILL.md 骨架，与三层加载时机。

P("    my-skill/")
P("      SKILL.md          <- 入口：它是什么、什么时候用")
P("      references/       <- 可选：用到才读的长文档")
TH([u"三层加载", u"什么时候进上下文"], [24, 50])

实跑输出：

--------------------------------------------------------------------
创建你的第一个 skill
--------------------------------------------------------------------

skill 就是一个文件夹，结构固定：

    我的skill/
      SKILL.md          <- 入口：它是什么、什么时候用
      scripts/          <- 可选：真正干活的脚本
      references/       <- 可选：用到才读的长文档
      assets/           <- 可选：模板、样式、素材

`SKILL.md` 的骨架，**关键是 description 那一句**：

    ---
    name: 周报整理
    description: 把散乱的记录整理成周报。当用户说【整理周报】时使用。
    ---

    一句话说清它干什么、什么时候该用它——
    这句就是它被找到的唯一依据。

**skill 是分三层读进来的**，这正是它省上下文的原因：

  三层加载                 什么时候进上下文
  --------------------------------------------------------------
  名字与描述               每次会话都看得到——用来判断该不该用它
  SKILL.md 正文            真的用到这个 skill 时才读进来
  references/ 里的长文     正文里明确指到它时才读

所以写 skill 的第一条纪律是：**description 要写清什么时候用**——
正文写得再好，**它不知道什么时候该翻出来，就等于没有**。

skill 是分三层读进来的——名字描述常驻、正文按需、长文再按需，这是它省上下文的原因。 description 要写清什么时候用；正文写得再好，它不知道什么时候翻出来也等于没有。

30 秒实验

  1. 给你天天重复的那件活写一句 description，只准写一句话。
  2. 拿这句话去问自己：换个说法它还能被认出来吗？不能就再改。

常见误区

  1. 把 skill 当成一本讲义写。正文越长，触发时进上下文就越贵。
  2. description 写成【处理文本】这种话。它判断不出什么时候该用，等于没写。
自测三问（点开对答案） 1. skill 的目录结构有哪几部分？ —— SKILL.md 入口，加上可选的 scripts、references、assets。 2. description 那句为什么关键？ —— 它是 skill 被找到的唯一依据——写不清就等于没有。 3. skill 为什么省上下文？ —— 分三层加载：名字描述常驻、正文按需、长文再按需。

相关笔记