三、动手制作一个 Skill

本章目标：从零做出一个能跑、能被正确触发的 Skill，并知道每一步「为什么这么做」。

前三章都是「知道」，本章开始「做到」。整个制作过程可以拆成 6 步，其中真正需要动脑的是第 1、2、4 步，其余是机械操作。

本章包含

小节	标题	你会得到什么
3.1	从零创建：初始化与目录规范	用脚本或手搓出正确的目录骨架
3.2	SKILL.md 怎么写	description 触发词工程 + 四种正文范式的落地写法
3.3	校验与打包	自动校验规则逐条拆解 + 常见报错速查

步骤	做什么	关键动作
Step 1	理解需求	找 3～5 个真实用户会说的话，作为触发样本
Step 2	规划资源	逐条问「这是不是要反复写的代码 / 详细资料 / 产物素材」
Step 3	初始化	建目录 + `SKILL.md` 骨架（推荐用 `init_skill.py`）
Step 4	撰写与实现	先写 `scripts/`、`references/`、`assets/`，再回头写 `SKILL.md`
Step 5	校验与打包	跑校验脚本，通过后打 zip
Step 6	迭代	用真实任务跑，把「又踩的坑」写回 SKILL.md

一个反直觉但极重要的顺序：Step 4 要先做资源、后写 SKILL.md。因为只有资源定下来了，你才知道 SKILL.md 里该引用哪些文件、参数怎么描述。反过来写，等于边写说明书边改机器。

Skill 创建者套件里提供了两个工具（位于 skill-creator 技能包内）：

脚本	作用	一句话用法
`init_skill.py`	生成标准目录骨架	`python init_skill.py my-skill --path ~/.workbuddy/skills`
`package_skill.py`	校验并打包成 zip	`python package_skill.py ~/.workbuddy/skills/my-skill ./dist`

打包脚本内部会先调用校验逻辑，校验不过就不会产出 zip——这是保护你发出一个坏 Skill 的第一道闸门。

整理人：WorkBuddy