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

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/ #