AI 编程助手 Skills 完全指南

什么是 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-skilldescription: 我的自定义技能---## When to Use当用户需要...时触发## Procedure1. 第一步2. 第二步EOF

方式 4：下载 ZIP 包

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

方式 5：从其他项目复制

# 从其他项目复制 Skillscp -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: utilityauthor: Your Name---

Markdown 内容（执行指令）

## When to Use触发条件说明## Procedure1. 第一步操作2. 第二步操作## Pitfalls- 常见问题和解决方案## Verification如何验证技能执行成功

Skills 管理命令

查看已安装的 Skills

# 查看项目级 Skillsls -la .claude/skills/# 查看用户级 Skillsls -la ~/.claude/skills/# 查看特定 Skill 的详细信息cat .claude/skills/skill-name/SKILL.md

删除 Skills

# 删除项目级 Skillrm -rf .claude/skills/skill-name/# 删除用户级 Skillrm -rf ~/.claude/skills/skill-name/

更新 Skills

# 方法一：Git 拉取更新cd .claude/skills/skill-name && git pull# 方法二：手动更新# 直接编辑 SKILL.md 文件# 方法三：重新克隆rm -rf .claude/skills/skill-namegit 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

最佳实践

命名规范

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

文档完善

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

版本管理

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

测试验证

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

关于作者

作者重视实战与理论的结合，文章干货满满，有较为丰富的平台、数开经验，欢迎和作者一起交流，共同进步。

风间技术私享聚焦“大数据+AI”实战与资讯，技术干货和行业消息一网打尽。期待与你同行，欢迎扫码添加作者微信。

往期精彩

Claude Code+CC-Switch一键安装与快速上手

体验 Hermes Agent：一个会自我进化的 AI 智能体

Crawl4AI 实战指南：面向大模型的智能爬虫工具

关注 风间技术私享 获取更多私享技术