xhyapi
视频来源：Bilibili 原视频
前两期讲了 Skill 是什么、有哪些现成的可以抄。这一期只走一条线：想清楚 → 做出来 → 用起来，把一个想法一路做成能在 Codex 里真正跑起来的 skill。先说结论：难的只有「想清楚该做什么」，做出来和用起来，跟着走一遍就会。
① 想清楚：好 Skill 不是规划出来的，是被「烦」出来的
别坐下来「我要做个 skill」。留意三种反复出现的「疼」，那就是信号：
- 第三次复制同一段：又翻聊天记录，把那段提示词复制粘贴、改两个字再发；
- 又纠正同一个错：AI 同样的毛病，你已经改了一遍又一遍；
- 又解释同一套背景：每开一个新对话，都要把项目背景、偏好重讲一遍。
信号出现不等于马上动手——先拿 04-1 那把尺子量一遍：反复做 + 有流程 + 有标准 + 经常提醒，没定型的先别封装。
够格之后，做「想清楚」里最有含量的一步——显性化：把脑子里默认、从没写下来的判断，一条条摊成 AI 能照做的说明。骨架就五件事：
| 骨架 | 要写清什么 |
|---|---|
| 何时触发 | 什么场景用、什么场景不碰 |
| 分几步 | 把默认的流程拆成固定步骤 |
| 每步标准 | 每一步「什么算做对」的判据 |
| 红线 | 绝对不能做的禁区 |
| 怎么自检 | 交付前自己再过一遍的清单 |
还要破一个最劝退人的误会：做 skill，九成不用写一行代码——绝大多数就是把想清楚的骨架写成一份文字说明书（Markdown）。只有当光「说明」不够、需要 AI 每次运行一个现成程序时，才需要写代码。
② 做出来：想清楚了，一句话让 AI 成文
你只做两件事。第一件，对 Codex 说一句大白话（拿「交付读者视角检查」当例子）：
「帮我做个 skill，名字 delivery-reader-gate：交付课程/文章正文前，检查有没有把制作过程、作者备注写给读者；红线是……，自检是……。写成 SKILL.md。」
第二件，把 AI 写好的文件放对地方——建个以 skill 名命名的文件夹，放进去就生效：
~/.codex/skills/
delivery-reader-gate/
SKILL.mdAI 写出来的就是这样一份完整文件，你不用会写，只要读懂：
---
name: delivery-reader-gate
description: 交付课程 / 文章 / PPT 正文前，检查有没有把制作过程、
作者备注、「本节怎么讲」写给最终读者。Use when 产出正文、准备交付时。
---
# 交付读者视角闸门
## 红线（不许写进正文）
- 录制安排 / 讲师提示 / 作者备注 · 制作流程 / 技术选型 / 设计思路
## 交付前自检
1. 逐条对照红线过一遍 2. 只留读者能直接感知的内容整份就两块：上面 frontmatter（name + description），下面正文（你想清楚的红线 + 自检）。而真正决定成败的，是 description 这一行——Codex 靠它判断「这个任务要不要用这个 skill」，写不好就永远不触发：
| 写法 | 结果 | |
|---|---|---|
| ✗ | description: 帮我起标题 | 没说什么时候用、没关键词，Codex 不知道何时调它——永远不触发 |
| ✓ | …generate titles. Use when 起标题 / 批量 / 公众号·B站 适配… | 干什么 + 什么时候用 + 触发关键词——稳定触发 |
口诀：干什么 + 「Use when 什么时候用」 + 触发关键词。
顺带认识一下目录全貌——打开任何一个 skill，里面最多就四样，其中只有 SKILL.md 是必须的：
| 文件 | 作用 |
|---|---|
| SKILL.md（必须） | 说明书本体，一触发就整份读入，只放判断/流程/红线，要短 |
| references/（可选） | 太长的资料拆到这，AI 用到哪篇才翻哪篇，平时不占上下文 |
| scripts/（可选） | 写好的小程序，AI 直接运行拿结果 |
| assets/（可选） | 要照着用的模板/图片/字体 |
③ 用起来：派活就自动触发，用中养大
不用记命令。你正常说任务，description 一匹配，Codex 自动把这个 skill 加载进来。两个常见情况：
- 没触发？九成是 description 没写清——回去补关键词，别改正文；
- 跑起来发现某种情况没覆盖？回去补一条规则，下次就接得住。skill 是活的，越用越准。
一张卡，把你的场景套进去
- ① 想清楚：嗅信号 → 拿公式量一遍（没定型先别封）→ 显性化骨架：触发/步骤/标准/红线/自检
- ② 做出来：说一句让 AI 成文 → 盯 description（干什么 + Use when + 关键词）→ 放 ~/.codex/skills/
- ③ 用起来：派活看触发 → 没触发改 description → 用中补规则养大
三段里只有「想清楚」要动脑。现在就挑你最常复制的那段提示词，照这张卡走一遍——把你的第一个 skill 跑通。
Skills 三部曲
- 04-1 入门：别再复制提示词了，让 Codex 记住你的工作方法
- 04-2 工具箱：我每天在用的 19 个 Codex Skills，7 大场景直接抄
- 04-3 动手做：你的第一个 Codex Skill，是被「烦」出来的（本篇）
进阶：skill 多了怎么统一管理、跨项目共用？B站搜「Skills 管理 xhyovo」看专门那期。
