Claude Code 开发完全指南
🎯 什么是 Claude Skills？
Claude Skills 是一种标准化的能力包，将专家知识封装成文件，让 Claude 能够在特定任务上表现得更专业。
核心组成
每个 Skill 由三部分构成：
SKILL.md - 主要指令文件（必需）
scripts/ - 可执行代码（可选）
reference/ - 参考资源（可选）
工作原理
Skills 采用渐进式披露机制，分三层加载：
•
Level 1: 元数据（name + description）- 始终加载，~100 tokens
•
Level 2: 指令（SKILL.md 主体）- 触发时加载，~5k tokens
•
Level 3: 资源和代码 - 按需加载
📦 本项目包含什么？
📖 核心文档（3 个）
README.md（本文件）- 项目介绍和快速开始
Claude_Skills_开发完全指南.md - 详细的开发教程（2500+ 行）
快速参考卡片.md - 模板和检查清单
🎨 官方示例（17 个 Skills）
anthropic-skills/ - Anthropic 官方 Skills 仓库，包含：
创意设计类：
•
algorithmic-art - 算法艺术生成
•
canvas-design - 画布设计
•
slack-gif-creator - Slack GIF 创建
开发技术类：
•
artifacts-builder - Claude.ai Artifacts 构建
•
mcp-builder - MCP 服务器构建
•
webapp-testing - Web 应用测试
企业沟通类：
•
brand-guidelines - 品牌规范应用
•
internal-comms - 内部沟通
•
theme-factory - 主题工厂
文档处理类（document-skills/）：
•
docx - Word 文档处理
•
pdf - PDF 文档处理
•
pptx - PowerPoint 处理
•
xlsx - Excel 处理
元 Skills：
•
skill-creator - Skill 创建指南
•
template-skill - Skill 模板
其他示例：
•
claude-cookbooks/skills/ - 包含 3 个财务相关示例
🚀 快速开始（5 分钟）
第 1 步：查看一个简单的 Skill
代码块
Plain Text
# 查看最简单的模板
cat anthropic-skills/template-skill/SKILL.md
一个最基本的 Skill 就是这样：
代码块
YAML
---
name: my-skill
description: 描述这个 Skill 做什么以及何时使用
---
第 2 步：创建你的第一个 Skill
代码块
YAML
# 创建目录
mkdir my-first-skill
cd my-first-skill
# 创建 SKILL.md
cat > SKILL.md << 'EOF'
---
name: greeting-expert
第 3 步：使用你的 Skill
在 Claude.ai、Claude Code 或 API 中上传这个 Skill 文件夹，然后就可以使用了！
📖 学习路径
🎯 初学者（1-2 小时）
目标：理解 Skills 基础，创建简单 Skill
阅读本 README（15 分钟）
查看 template-skill（15 分钟）
代码块
Plain Text
cat anthropic-skills/template-skill/SKILL.md
查看 2-3 个简单示例（30 分钟）
◦
brand-guidelines
◦
internal-comms
创建你的第一个 Skill（30 分钟）
◦
只包含 SKILL.md
◦
不需要脚本
🎓 进阶者（3-5 小时）
目标：掌握最佳实践，创建包含脚本的 Skill
阅读 Claude_Skills_开发完全指南.md 核心章节（2 小时）
◦
第 5 章：SKILL.md 编写
◦
第 6 章：Scripts 开发
◦
第 8 章：最佳实践
研究复杂示例（1 小时）
◦
mcp-builder
创建包含脚本的 Skill（2 小时）
🚀 高级者（5+ 小时）
目标：精通 Skills 开发，创建生产级 Skill
完整阅读 Claude_Skills_开发完全指南.md（3 小时）
研究所有官方示例（2 小时）
创建生产级 Skill（多次迭代）
💡 核心要点
✅ 好的 Skill 应该：
•
简洁 - 只教 Claude 不知道的东西
•
精准 - description 要准确描述使用场景
•
结构化 - 使用清晰的步骤和示例
•
可测试 - 提供具体的使用示例
•
适度 - SKILL.md 保持在 500 行以内
❌ 避免这些错误：
•
过度解释 Claude 已知的基础知识
•
包含会过时的时效性信息
•
SKILL.md 过长（超过 1000 行）
•
缺少具体的使用示例
•
description 太模糊
📚 文档导航
🎨 官方示例索引
按复杂度
简单（只有 SKILL.md）：
•
template-skill
•
brand-guidelines
•
internal-comms
中等（包含 reference/）：
•
skill-creator
•
mcp-builder
复杂（包含 scripts/）：
•
webapp-testing
•
slack-gif-creator
•
document-skills
按用途
学习参考：
•
template-skill - 最基本的模板
•
skill-creator - 如何创建 Skill
创意设计：
•
algorithmic-art
•
canvas-design
•
theme-factory
开发工具：
•
artifacts-builder
•
mcp-builder
•
webapp-testing
文档处理：
•
document-skills/docx
•
document-skills/pdf
•
document-skills/pptx
•
document-skills/xlsx
✅ 创建 Skill 检查清单
开始前
•
明确 Skill 的目标和使用场景
•
确定是否需要 scripts 和 reference
•
准备好 2-3 个使用示例
创建时
•
编写清晰的 name（小写，连字符）
•
编写精准的 description（包含使用场景）
•
提供具体的使用示例
•
保持 SKILL.md 简洁（< 500 行）
•
使用结构化的指令格式
完成后
•
在不同场景下测试
•
检查是否有不必要的内容
•
确保示例清晰易懂
•
添加必要的注释
📝 SKILL.md 模板
代码块
YAML
---
name: skill-name # 小写+连字符，最大64字符
description: 做什么 + 何时用 + 触发词 # 最大1024字符
---
# Skill Title
简短概述（1-2句话）
## Capabilities
- 能力1
🐍 Python 脚本模板
代码块
Python
🧪 测试脚本模板
代码块
Python
from anthropic import Anthropic
import os
client = Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))
response = client.beta.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=4096,
betas=["code-execution-2025-08-25", "skills-2025-10-02"],
container={
"skills": [{"type": "local", "path": "skills/my-skill"}]
🔧 命令速查
创建 Skill 结构
mkdir -p skills/my-skill/{scripts,reference}
touch skills/my-skill/SKILL.md
测试脚本独立运行
echo '{"test": "data"}' | python scripts/my_script.py
检查脚本权限
chmod +x scripts/my_script.py
测量文件行数
wc -l skills/my-skill/SKILL.md
📊 设计模式速查
工作流模式
代码块
Markdown
### Phase 1: Preparation
- [ ] 验证输入
- [ ] 创建备份
### Phase 2: Processing
- [ ] 处理数据
### Phase 3: Validation
- [ ] 运行验证脚本
- [ ] 如果失败，返回 Phase 2
决策树模式
代码块
Plain Text
1. 检查输入格式:
- 如果 CSV → 使用 process_csv.py
- 如果 JSON → 使用 process_json.py
- 如果其他 → 先转换为 CSV
验证模式
代码块
Plain Text
## 输出验证清单
- [ ] 所有必需字段存在
- [ ] 数据类型正确