一、为什么需要了解多文件 Skill
在 创建第一个 Skill 中，一个 SKILL.md 就能完成所有工作。但当指令逐渐增长——审查清单、输出模板、语言专属规则各占几十行——单文件 Skill 会遇到两个具体问题：
- SKILL.md 超过 500 行后，Claude 在上下文中同时处理所有信息，指令遵循质量下降
- 不同场景的逻辑混在同一文件中，修改一处规则时容易影响不相关的工作流
多文件架构解决的不是"文件太长"这个表面问题，而是让 Claude 在不同执行阶段加载不同的内容。
二、多文件 Skill 的工作方式
三个子目录的加载行为
Skill 目录下可以包含三个子目录，Claude 对每个目录有不同的处理方式：
三个目录都不会在 Skill 触发时自动加载。Claude 只在 SKILL.md 的指令明确要求读取或执行某个文件时，才访问对应目录中的内容。
一个包含全部三个子目录的 Skill 结构：
SKILL.md 在多文件架构中的角色
SKILL.md 的职责从"包含所有指令"变为"协调各文件的工作"。它需要明确告诉 Claude 去哪个目录读取什么文件，以及在什么步骤执行什么脚本。
Claude 不会自动发现和读取子目录中的文件——SKILL.md 中没有提到的文件不会被使用。
为什么分三个目录而不是都放在 references/
三个目录的区别在于 Claude 如何使用其中的文件：