乐于分享
好东西不私藏

AI 编程助手 Skills 完全指南

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 包

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

方式 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

最佳实践

  1. 命名规范

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

    • 清晰的触发条件
    • 详细的执行步骤
    • 常见问题说明
  3. 版本管理

    • 项目级 Skills 提交到 Git
    • 使用语义化版本号
    • 记录变更日志
  4. 测试验证

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

作者重视实战与理论的结合,文章干货满满,有较为丰富的平台、数开经验,欢迎和作者一起交流,共同进步。
风间技术私享 聚焦“大数据+AI”实战与资讯,技术干货和行业消息一网打尽。期待与你同行,欢迎扫码添加作者微信。

往期精彩

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

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

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

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

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料