问题定义前两章我们理解了 Skill 是什么、为什么有用。从本章开始，我们要动手了。但在写下第一个字符之前，必须先搞清楚SKILL.md的格式规范。很多新手写 Skill 时容易犯这些错误：name字段用了大写字母或下划线；description写得太笼统，Agent 根本不知道怎么触发；目录名和name不一致，导致 Agent 加载失败；把所有内容都塞进SKILL.md，结果文件又臭又长；引用references/里的文件时用了绝对路径或深层嵌套。本章的目标就是帮你掌握 Qoder Skill 的规范，写出结构清晰、格式正确、易于维护的SKILL.md。核心概念Qoder Skill 的目录结构Qoder 采用与 Agent Skills 开放标准一致的目录结构。一个 Skill 目录通常长这样：.qoder/skills/skill-name/ ├── SKILL.md # 必需：元数据 + 指令 ├── references/ # 可选：参考文档、规范、检查清单 ├── assets/ #