Qoder Skill 规范与 SKILL.md 文件结构

问题定义

前两章我们理解了 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/ #