【Claude Code】带你深度剖析 SKILL 文档

Skill

它是模块化、可复用、按需加载的结构化能力封装标准。

什么是skills：Skill不是写得更好的prompt，而是可安装、可复用、带执行能力的能力包；它既不是纯文本提示，也不是静态知识库，而是让AI主动识别任务、调用工具、执行动作的标准化单元。一个文件夹即一个Skill，最小仅需一个 skill.md 即可运行；包含三核心组件——YAML元数据+Markdown指令层+可执行脚本（Python/Shell/JS）+按需加载的参考资料。

与prompt的区别

Prompt是反应式、一次性、高开销：用户提问才响应，对话结束即失效，越长越贵，无法跨会话复用，上下文占用大。
Skill是主动式、持久化、低消耗：安装一次长期生效，AI自主判断调用时机；按需加载资源，支持多Skill组合成流水线；包含prompt但远超prompt——它是结构化、可执行、可迭代的能力工程产物。

内部四层结构

Skill内部四层结构解析

YAML Front Matter（元数据层）： name 和 description 为必填项，其中description是AI路由决策的核心依据，决定能否被精准触发。
Markdown正文（指令层）：定义角色、核心任务、输出格式、约束条件等，相当于AI执行任务的“操作手册”。
Scripts目录（执行层）：存放Python/Shell/JavaScript等可执行脚本，AI在沙箱中真实运行代码，不止于生成文字。
Resources目录（资源层）：存放合规手册、知识文档等参考资料，仅在指令明确引用时才加载，避免无效token消耗。

Agent调用Skill全流程演示（以会议审计为例）

路由阶段：用户输入“分析年度采购会议记录，检查超预算违规项”，Agent扫描所有Skill description，LLM推理命中关键词“会议记录”“审计”“预算”，锁定 meeting-auditor 技能。
加载阶段：系统将 meeting-auditor.skill.md 全文载入上下文，AI获得完整审查逻辑与输出模板。
引用阶段：指令中声明“参考compliance-rules.md第三章”，仅该章节被加载，其余合规文档零占用。
推理阶段：AI结合会议记录+合规条款生成审计报告草稿。
执行阶段：用户确认后输入“归档”，Agent调用归档脚本，在沙箱中执行并返回唯一归档编号——全程一句自然语言驱动全链路自动化。