返回AI 入门教程
AI 入门教程
Claude Skills 完全指南：从小白到高手
阅读时间：20 分钟
🔥 本文整合了 B站 2026 最新教程 + Anthropic 官方文档 + 社区最佳实践。Skill 是 Claude Code 最强大的能力——给它一个 Skill，它就从通用助手变成领域专家。
🧠 Skill 是什么 —— 一张图看懂
👤 你：帮我审查这段代码
⬇️
🤖 Claude 读取所有 Skill 的 description
⬇️
🎯 匹配到 code-review Skill → 自动加载 SKILL.md
⬇️
📋 按 Skill 流程：安全检查 → 性能检查 → 规范检查 → 输出报告
⬇️
✅ 专业级代码审查报告
一、Skill 的核心概念
Skill = 给 AI 写的「专业操作手册」。不是一次性的 Prompt，而是一个可以反复使用、团队共享、持续迭代的能力包。
📝
Prompt
一次性指令
用完就没了
📋
AGENTS.md
项目规则
始终生效
⚡
Skill
按需触发的能力包
可复用、可分享
📊 渐进式披露 —— Token 的秘密
L1 · 元数据层
name + description · ~100 Token
⏰ 启动时始终加载
➡️
L2 · 指令层
SKILL.md 正文 · ~5000 Token
🎯 匹配时按需加载
➡️
L3 · 资源层
scripts/ references/ assets/
📖 动态按需读取
💡 平时只占 ~100 Token · 触发后才加载完整内容 · 可以同时装很多 Skill 不卡
二、Skill 的文件结构
📁 my-skill/
├── SKILL.md ← 必需！核心文件
├── 📁 scripts/ ← 可选：Python/Bash 脚本
│ └── validate.py
├── 📁 references/ ← 可选：详细参考文档
│ └── api-docs.md
└── 📁 assets/ ← 可选：模板、图片等
└── template.docx
📝 SKILL.md 的两部分结构
📋 YAML 头部（元数据）
---
name: my-skill
description: >-
做什么 + 什么时候触发
allowed-tools: Read,Write,Bash
---
⚡ 始终加载，约 100 Token
📖 Markdown 正文（指令）
# Skill Name
## Quick Start
## Common Tasks
## Gotchas ⚠️
🎯 触发时才加载，约 2000-5000 Token
三、从零创建 Skill 的全流程
1️⃣ 裸跑任务：正常跟 Claude 完成一次任务，记下你反复说了什么
2️⃣ 提取模式：什么会在类似任务中复用？
3️⃣ 对 Claude 说：「把刚才的工作流程整理成一个 Skill」
4️⃣ Claude 自动生成 SKILL.md + scripts/ + references/
5️⃣ 测试：新开 Claude 实例，用自然语言触发 Skill
6️⃣ 迭代：它漏了什么？什么让它困惑？→ 改 SKILL.md
7️⃣ 分享：放到 .claude/skills/，团队共用
🔌 Skill vs MCP —— 大脑 vs 工具箱
🧠 Skill
告诉你「怎么做」
- ✅ 内部流程和知识
- ✅ 程序性知识模块
- ✅ 类比：菜谱 / 操作手册
- ✅ Markdown 文件 + 脚本
🔧 MCP
给你「能做什么」
- ✅ 外部工具和数据
- ✅ 工具接口协议
- ✅ 类比：工具箱 / USB-C
- ✅ 客户端-服务端架构
💡 黄金组合：MCP = 手和脚 · Skill = 大脑 · Agent = 身体
四、最关键的一行：Description
⚠️ Description 写不好 = Skill 永远不会被触发
公式：做什么 + 什么时候用（用户会说什么关键词）
❌ 太模糊
description: Helps with documents
✅ 触发力强
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDFs, forms, or document extraction.
🎯 Skill 触发机制
🔍
自动触发
你正常说话
Claude 理解语义后自动匹配
⌨️
手动触发
输入 /skill-name
直接调用，跳过匹配
🔒
锁定模式
disable-model-invocation: true
仅允许手动触发
五、Anthropic 官方 9 大 Skill 类型
📚
1. 库/API 参考
补齐冷门库知识
✅
2. 产品验证 ⭐
可重复验收流程
📊
3. 数据获取分析
连接真实数据栈
🤖
4. 业务流程自动化
重复工作流压成命令
🏗️
5. 代码脚手架
生成符合规范模板
🔍
6. 代码质量审查
风格/测试/对抗审查
🚀
7. CI/CD 部署
交付链路自动化
🔧
8. 运维 Runbook
症状→结构化排查
⚙️
9. 基础设施运维
日常维护含破坏操作
六、Anthropic 官方的 10 条铁律
1.❌ 不写废话——只写 Claude 不知道的信息，它已经非常聪明了
2.⚠️ 必须有 Gotchas 章节——从真实失败中积累的踩坑清单，信号密度最高
3.📁 用文件系统做渐进式披露——SKILL.md 是指南针，细节放 references/
4.🚫 避免 47 步死剧本——给信息和灵活度，不要铁路化 Agent
5.🔧 设计 Setup 流程——未配置时 Agent 主动引导用户配置
6.🎯 Description 写给模型看——放触发词，帮 Claude 做决策
7.📝 内建记忆——用 append-only 日志存历史结果
8.⚡ 存脚本让 Agent 做组合——脚本干重活，Claude 负责编排
9.🪝 按需 Hook——只在调用 Skill 时生效的防护钩子
10.🔄 从一行 Gotcha 开始迭代——Claude 撞墙后持续加厚
七、常见反模式（千万别这么干）
❌ Windows 路径 scripts\helper.py
✅ 用正斜杠 scripts/helper.py
❌ 深层嵌套引用 a→b→c
✅ 只允许一层引用
❌ 太多选项没默认值
✅ 提供默认选择 + 逃生口
❌ 模糊的 description
✅ 具体 + 触发词组 + 场景词
❌ 术语混用 API/URL/route/path
✅ 全文统一用词
❌ 往 Skill 里放 README/CHANGELOG
✅ Skill 为 AI 写，不是为人写
八、5 分钟快速上手
# 1. 创建目录
mkdir -p ~/.claude/skills/my-first-skill
# 2. 写 SKILL.md
cat > ~/.claude/skills/my-first-skill/SKILL.md << 'EOF'
---
name: my-first-skill
description: >-
Brief description of what this does. Use when [trigger scenarios].
---
# Instructions
1. Step one
2. Step two
3. Verify with [check]
EOF
# 3. 测试
重启 Claude Code，用自然语言描述任务，看它是否自动触发你的 Skill
或者输入 /my-first-skill 手动测试
💡 核心心法：从一行 Gotcha + 一个验证脚本开始，比写一百页 Prompt 管用。Skill 是「用」出来的，不是「写」出来的。让 Claude 撞墙，然后把撞墙的经验写进 Gotchas。