Anthropic · Progressive Disclosure · 2025

Claude Skills 完全指南

Skill 不是一段 prompt,而是一个可以装入 Claude 的能力包——SKILL.md 说明何时激活,scripts/ 与 references/ 按需加载,既不占用上下文又能让 Claude 获得专家级技艺。10 章带你写出可交付、可复用、可分发的 Skill。

Claude Code API Skills SKILL.md File Tools Bash Tool MCP 协作

开始学习 →

🎯 10 章节 📦 能力即代码 ♻️ 团队可复用

课程目录

从一个 SKILL.md 起步,把你积累的最佳实践打包成 Claude 随手可调的技艺

什么是 Skill:能力与 Prompt 的分界

Skill 不等于 System Prompt,也不是 Tool。理解渐进披露(Progressive Disclosure)为何是关键:Claude 默认只看到 Skill 的简介,真正用时才按需加载细节。

基础Skill 模型

第一个 Skill:PDF 表单填写

10 分钟写一个能让 Claude 自动填写 PDF 表单的 Skill:创建目录、写 SKILL.md、加辅助脚本,本地用 Claude Code 激活、调用、调试。

SKILL.md 结构与元数据

YAML frontmatter 的 name / description / when-to-use / required-tools 规范;正文如何分层写:概览在前,深度材料放 references;Claude 读 SKILL.md 的顺序是什么。

渐进披露:让 Claude 按需加载

Skill 的核心机制:简介进上下文、细节按 grep 触发、脚本按 Bash 执行。怎么写引用链、怎么控制加载路径,让 10 万字的文档不占 token。

核心机制上下文节流

脚本与辅助工具:scripts/ 的正确用法

什么时候让 Claude 直接写代码,什么时候让它调用预置脚本。Python / Node / Shell 脚本的选型、入参规范、错误处理,让 Skill 既可靠又省 token。

references/:海量文档的正确打包

API 文档、SQL schema、品牌规范动辄几十万字,塞不进上下文。用 references/ 做懒加载索引、用 grep-friendly 的结构让 Claude 按需取用。

references懒加载

Skill 在 Claude Code / API / App 三端

Claude Code 的 ~/.claude/skills/ 与项目级 Skills、Claude API 的 Skills 参数、Claude.ai 的 Skill 上传。同一个 Skill 如何一份代码三端运行。

测试 Skill:让能力可验证

Skill 的单元测试和回归测试怎么写;用 eval 场景集记录 Claude 的调用行为;怎么在 SKILL.md 里写 few-shot 让 Claude 学会边界场景。

Skill 与 MCP / Tool 的协作边界

Skill 用于静态领域知识,MCP Server 用于动态外部系统,Tool 是原子能力。如何组合:Skill 指挥 MCP、Skill 调用 Tool,避免三者功能重叠。

实战:团队级 Skill 库与治理

Git 管理 Skill 版本、CI 自动测试、Skill Marketplace 内部分发、权限与审计;一个金融业务团队如何沉淀 20 个核心 Skill,让新人 Day 1 即可产出专家级交付物。