什么是 Skills？

Skills（技能）是一套可扩展的指令集，它能够赋予 AI 编程助手更强大的能力。通过 Skills，你可以将特定领域的工作流程、最佳实践和操作步骤封装成一个可复用的模块，让 AI 助手在需要时自动调用或按需执行。

Skills 的核心作用

作用	说明
能力扩展	为 AI 助手添加新的技能，如代码审查、文档生成、PPT 制作等
流程标准化	将复杂的工作流程固化为标准步骤，确保一致性
效率提升	避免重复输入相同指令，一键触发复杂任务
知识沉淀	将团队经验和最佳实践编码为可执行的技能

Skills 的通用性

Skills 是一种通用的概念，不仅适用于 Claude Code，也适用于其他 AI 编程工具。不同工具可能有不同的实现方式，但核心理念是一致的：通过可配置的指令集来扩展 AI 的能力。

本文将以实际案例为例，介绍 Skills 的安装、使用和创建方法。

---

Skills 的两种级别

项目级 Skills vs 用户级 Skills

特性	项目级 Skills	用户级 Skills
存放位置	项目根目录/.claude/skills/	~/.claude/skills/（用户主目录）
作用范围	仅对当前项目生效	对当前用户的所有项目生效
优先级	高（优先使用）	低（项目级没有时使用）
适用场景	项目特定技能（如特定框架、业务逻辑）	通用技能（如通用开发、文档生成）
版本控制	可以提交到 Git，团队共享	仅本地使用

示例路径：

• 项目级：F:\project\projectAI\cc_xm\.claude\skills\ppt-master\
• 用户级：C:\Users\administer\.claude\skills\

---

Skills 的 5 种获取方式

方式 1：内置 Skills（开箱即用）

系统自带，无需安装：

• /init - 初始化项目文档
• /review - 代码审查
• /simplify - 代码简化优化
• /security-review - 安全审查

方式 2：从 GitHub 克隆（推荐）

# 项目级安装（推荐）
git clone https://github.com/anthropics/claude-code-skills.git /path/to/project/.claude/skills/skill-name

# 用户级安装（所有项目共享）
git clone https://github.com/anthropics/claude-code-skills.git ~/.claude/skills/skill-name

方式 3：手动创建

# 创建目录
mkdir -p .claude/skills/my-skill

# 创建 SKILL.md 文件
cat > .claude/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: 我的自定义技能
---

## When to Use
当用户需要...时触发

## Procedure
1. 第一步
2. 第二步
EOF

方式 4：下载 ZIP 包

1. 从 GitHub 下载 ZIP 文件
2. 解压到 .claude/skills/ 目录
3. 重命名文件夹为技能名称

方式 5：从其他项目复制

# 从其他项目复制 Skills
cp -r /path/to/other/project/.claude/skills/skill-name .claude/skills/

---

Skills 目录结构详解

基本目录结构

.claude/skills/
├── skill-name/                    # 每个 Skill 一个目录
│   ├── SKILL.md                   # 核心配置文件（必需）
│   ├── scripts/                   # 辅助脚本（可选）
│   │   └── *.py
│   ├── templates/                 # 模板文件（可选）
│   │   └── *.svg
│   ├── references/                # 参考文档（可选）
│   │   └── *.md
│   └── .env.example              # 环境变量示例（可选）

实际示例：ppt-master 结构

.claude/skills/ppt-master/
├── SKILL.md                       # 主配置文件
├── scripts/                       # Python 脚本
├── templates/                     # SVG 模板
├── references/                    # 参考文档
└── workflows/                     # 工作流定义

---

SKILL.md 文件格式

YAML Frontmatter（元数据配置）

---
name: my-skill                    # 技能名称（必需）
description: 我的自定义技能        # 技能描述（必需）
version: 1.0.0                    # 版本号（可选）
platforms: [macos, linux, windows] # 平台限制（可选）
metadata:                         # 扩展元数据（可选）
  tags: [development, testing]
  category: utility
  author: Your Name
---

Markdown 内容（执行指令）

## When to Use
触发条件说明

## Procedure
1. 第一步操作
2. 第二步操作

## Pitfalls
- 常见问题和解决方案

## Verification
如何验证技能执行成功

---

Skills 管理命令

查看已安装的 Skills

# 查看项目级 Skills
ls -la .claude/skills/

# 查看用户级 Skills
ls -la ~/.claude/skills/

# 查看特定 Skill 的详细信息
cat .claude/skills/skill-name/SKILL.md

删除 Skills

# 删除项目级 Skill
rm -rf .claude/skills/skill-name/

# 删除用户级 Skill
rm -rf ~/.claude/skills/skill-name/

更新 Skills

# 方法一：Git 拉取更新
cd .claude/skills/skill-name && git pull

# 方法二：手动更新
# 直接编辑 SKILL.md 文件

# 方法三：重新克隆
rm -rf .claude/skills/skill-name
git clone https://github.com/... .claude/skills/skill-name

查看可用的 Skills

# 输入斜杠命令查看所有可用 Skills
/

# 输入技能名称触发
/skill-name
/skill-name 参数

---

项目级 vs 用户级 选择建议

场景	推荐级别	原因
项目特定的代码规范检查	项目级	只对当前项目生效
通用的代码格式化	用户级	所有项目都能用
团队共享的工作流	项目级	可以提交到 Git
个人偏好设置	用户级	跨项目保持一致
特定框架的代码生成	项目级	框架相关，不适合所有项目
通用的文档生成	用户级	任何项目都可能用到

---

常见问题

Q1: Skills 安装后不生效怎么办？

• 检查 SKILL.md 文件格式是否正确
• 重启 AI 编程助手
• 确认 Skills 目录路径正确

Q2: 项目级和用户级 Skills 冲突怎么办？

• 项目级 Skills 优先级更高
• 同名 Skills 会覆盖用户级版本

Q3: 如何分享 Skills 给团队？

• 将 Skills 放在项目级目录
• 提交到 Git 仓库
• 团队成员克隆后即可使用

Q4: Skills 可以调用外部脚本吗？

• 可以，放在 scripts/ 目录
• 在 SKILL.md 中引用脚本路径

---

使用 Skills 的三种方式

方式 1：斜杠命令调用

/skill-name
/skill-name 参数

方式 2：自动检测关键词

在对话中提及关键词，系统会自动匹配技能，例如：

"创建一个关于AI的PPT"

方式 3：参数传递

/skill-name args

---

最佳实践

1. 命名规范

   • 使用小写字母和连字符
   • 名称简洁明了
   • 避免与内置 Skills 冲突

2. 文档完善

   • 清晰的触发条件
   • 详细的执行步骤
   • 常见问题说明

3. 版本管理

   • 项目级 Skills 提交到 Git
   • 使用语义化版本号
   • 记录变更日志

4. 测试验证

   • 创建后立即测试
   • 验证各种输入情况
   • 确保输出符合预期