Claude Code Skills 系列（1/3）：入门实战篇 - 快速上手 Claude Code Skills
- [第一部分：理解 Skills](#第一部分：理解 Skills)
-
- [1.1 什么是 Claude Code Skills](#1.1 什么是 Claude Code Skills)
-
- [1.1 核心概念](#1.1 核心概念)
- [1.2 工作原理](#1.2 工作原理)
- [1.3 Skills 与传统提示词的区别](#1.3 Skills 与传统提示词的区别)
- [2. Skills 的核心优势](#2. Skills 的核心优势)
-
- [2.1 提升开发效率](#2.1 提升开发效率)
- [2.2 知识封装](#2.2 知识封装)
- [2.3 灵活的调用机制](#2.3 灵活的调用机制)
- [3. Skills 配置方式详解](#3. Skills 配置方式详解)
- 第二部分：快速安装
-
- [4. 安装 Skills 的三种方法](#4. 安装 Skills 的三种方法)
-
- [4.1 方法一：自然语言安装（推荐新手）](#4.1 方法一：自然语言安装（推荐新手）)
- [4.2 方法二：手动安装（推荐进阶用户）](#4.2 方法二：手动安装（推荐进阶用户）)
- [4.3 方法三：插件市场安装（推荐团队使用）](#4.3 方法三：插件市场安装（推荐团队使用）)
- [4.4 安装后的重要步骤](#4.4 安装后的重要步骤)
- [5. 推荐的优质 Skills 资源](#5. 推荐的优质 Skills 资源)
-
- [5.1 Anthropic 官方 Skills ⭐⭐⭐⭐⭐](#5.1 Anthropic 官方 Skills ⭐⭐⭐⭐⭐)
- [5.2 Superpowers ⭐⭐⭐⭐⭐](#5.2 Superpowers ⭐⭐⭐⭐⭐)
- [5.3 其他优质资源](#5.3 其他优质资源)
-
- [Jeffallan/claude-skills ⭐⭐⭐⭐](#Jeffallan/claude-skills ⭐⭐⭐⭐)
- [Skills 市场平台 - SkillsMP](#Skills 市场平台 - SkillsMP)
- [Awesome Claude Skills](#Awesome Claude Skills)
- 第三部分：推荐配置
-
- [6. 推荐配置方案](#6. 推荐配置方案)
-
- [6.1 新手入门配置](#6.1 新手入门配置)
-
- [步骤 1：安装 Claude Code](#步骤 1：安装 Claude Code)
- [步骤 2：添加官方插件市场](#步骤 2：添加官方插件市场)
- [步骤 3：安装推荐的 Skills](#步骤 3：安装推荐的 Skills)
- [步骤 4：测试安装](#步骤 4：测试安装)
- [推荐的入门 Skills](#推荐的入门 Skills)
- [6.2 个人开发者配置](#6.2 个人开发者配置)
-
- [推荐的个人级 Skills](#推荐的个人级 Skills)
- 安装方式
- [6.3 团队协作配置](#6.3 团队协作配置)
-
- [推荐的项目级 Skills](#推荐的项目级 Skills)
- [Git 配置建议](#Git 配置建议)
- 提交到版本控制
系列导航
- 第 1 篇：入门实战篇 - 快速上手 Claude Code Skills（当前）
- [第 2 篇：开发进阶篇 - 创建与管理自定义 Skills](#第 2 篇：开发进阶篇 - 创建与管理自定义 Skills)
- [第 3 篇：精通参考篇 - 进阶技巧与完整手册](#第 3 篇：精通参考篇 - 进阶技巧与完整手册)
本篇概要本文是 Claude Code Skills 系列的第 1 篇，将带你从零开始了解 Skills 的概念、优势和配置方式，学会三种安装方法，并完成第一次配置。阅读完本篇后，你将能够安装和使用现成的 Skills，为后续的自定义开发打下基础。
适用系统 ：Windows 10/11
命令行工具 ：优先使用 CMD，复杂操作使用 PowerShell
预计阅读时间：20-30 分钟
第一部分：理解 Skills
1.1 什么是 Claude Code Skills
1.1 核心概念
Claude Code Skills 是一种可重用的 AI 工作流模块，它将指令、上下文和工具访问权限打包成独立的功能单元。
简单来说，Skills 就像是给 Claude 安装的"插件"或"技能包"，让它能够：
- 🎯 自动执行特定任务
- 📚 遵循团队标准
- 🔄 跨项目复用
- 👥 与团队共享
1.2 工作原理
Skills 遵循 Agent Skills 开放标准，这是一个跨多个 AI 工具的通用标准。Claude Code 在此基础上扩展了额外功能：
- 调用控制：控制谁可以触发 Skill（用户或 AI）
- 子代理执行：在隔离环境中运行复杂任务
- 动态上下文注入：根据需要加载相关信息
1.3 Skills 与传统提示词的区别
| 特性 | 传统提示词 | Claude Code Skills |
|---|---|---|
| 持久性 | 需要每次复制粘贴 | 自动加载，跨会话可用 |
| 共享性 | 难以标准化 | 通过 Git 轻松共享 |
| 触发方式 | 手动输入 | AI 自动识别或手动调用 |
| 版本控制 | 无 | 完整的版本管理 |
| 团队协作 | 困难 | 原生支持 |
举个例子：
- 传统方式：每次需要生成 API 文档时，都要复制粘贴一大段提示词
- Skills 方式 ：安装一次
api-docSkill，之后只需输入/api-doc或让 Claude 自动识别
2. Skills 的核心优势
2.1 提升开发效率
Skills 让 AI 助手能够可靠地执行复杂任务，不仅仅是一次性的，而是在不同会话和上下文中都能保持一致性。
实际场景：
- 代码审查：每次 PR 都自动按照团队标准审查
- 文档生成：统一的 API 文档格式
- 测试编写：遵循相同的测试模式
2.2 知识封装
将最佳实践、组织特定的编码规范、测试模式、文件结构等封装到 Skills 中，确保团队遵循统一标准。
实际场景：
- 新人入职：直接使用团队的 Skills，快速上手
- 规范统一：所有人遵循相同的编码标准
- 知识传承：最佳实践以 Skills 形式保存
2.3 灵活的调用机制
- 模型调用（Model-invoked）：Claude 根据对话内容自动决定何时使用
- 用户调用 （User-invoked）：通过
/skill-name命令手动触发
实际场景：
- 自动触发：你说"帮我审查这段代码"，Claude 自动使用
code-reviewSkill - 手动触发：你输入
/deploy-prod v1.2.3，明确执行部署操作
3. Skills 配置方式详解
3.1 配置级别与优先级
Claude Code 支持多个级别的 Skills 配置，优先级从高到低：
企业级 > 个人级 > 项目级 > 插件级理解优先级：
- 如果同名 Skill 存在于多个级别，高优先级的会覆盖低优先级的
- 这样设计是为了让企业规范 > 个人偏好 > 项目特定需求
3.2 个人级配置（推荐新手）
适用场景：跨项目的个人偏好和常用工具
配置路径
💡 关于用户主目录：
- Windows 系统中，用户主目录位于
C:\Users\你的用户名\ - 可以通过环境变量
%USERPROFILE%访问 - 例如：如果你的用户名是"张三"，路径就是
C:\Users\张三\
配置路径：
C:\Users\你的用户名\.claude\skills\<skill-name>\SKILL.md快速访问方法
cmd
# 在 CMD 中查看你的用户主目录
echo %USERPROFILE%
# 直接打开 .claude 目录
explorer %USERPROFILE%\.claude特点
- ✅ 应用到所有个人项目
- ✅ 不影响团队成员
- ✅ 便于个人工作流优化
推荐使用场景
- 个人代码风格偏好
- 常用的开发工具集成
- 个人效率提升工具
- 跨项目通用的辅助功能
示例目录结构
C:\Users\张三\.claude\ # 用户主目录下的 .claude 文件夹
└── skills\ # 个人级 Skills 存放目录
├── code-reviewer\ # 代码审查 Skill
│ └── SKILL.md # Skill 配置文件（必需）
├── api-doc-generator\ # API 文档生成器 Skill
│ ├── SKILL.md # Skill 配置文件
│ └── templates\ # 模板文件夹（可选）
│ └── api-template.md # API 文档模板
└── test-writer\ # 测试编写助手 Skill
├── SKILL.md # Skill 配置文件
└── templates\ # 测试模板
└── unit-test.ts # 单元测试模板如何查看 .claude 文件夹
由于 .claude 是以点开头的文件夹，在 Windows 中默认可能不显示：
方法一：文件资源管理器
- 打开文件资源管理器
- 点击"查看"选项卡
- 勾选"隐藏的项目"
方法二：直接访问
- 按
Win + R打开运行对话框 - 输入
%USERPROFILE%\.claude - 按回车直接打开
方法三：使用命令行
cmd
# CMD - 打开 .claude 目录
explorer %USERPROFILE%\.claude
# CMD - 查看目录内容
dir %USERPROFILE%\.claude\skills3.3 项目级配置（推荐团队）
适用场景：特定项目的专属功能
配置路径
💡 关于 .claude 目录：
.开头的文件夹在 Windows 中是可以创建的- 这个目录位于项目根目录 下，与
.git文件夹同级 - Windows 默认可能不显示，需要开启"显示隐藏的项目"
配置路径：
# 相对于项目根目录
.claude\skills\<skill-name>\SKILL.md
# 完整路径示例
D:\Projects\my-project\.claude\skills\deploy-prod\SKILL.md特点
- ✅ 仅在当前项目中生效
- ✅ 可通过 Git 与团队共享
- ✅ 支持项目特定的工作流
推荐使用场景
- 项目特定的构建流程
- 项目相关的测试策略
- 特定技术栈的最佳实践
- 项目文档生成规则
示例目录结构
D:\Projects\your-project\ # 你的项目根目录
├── .claude\ # Claude Code 配置目录（隐藏文件夹）
│ └── skills\ # 项目级 Skills 存放目录
│ ├── deploy-prod\ # 生产环境部署 Skill
│ │ ├── SKILL.md # Skill 配置文件（必需）
│ │ └── scripts\ # 部署脚本文件夹（可选）
│ │ └── deploy.ps1 # PowerShell 部署脚本
│ └── generate-api-docs\ # API 文档生成 Skill
│ ├── SKILL.md # Skill 配置文件
│ └── templates\ # 文档模板文件夹（可选）
│ └── api-template.md # API 文档模板
├── src\ # 项目源代码目录
├── package.json # 项目配置文件
├── .git\ # Git 版本控制目录（隐藏）
└── README.md # 项目说明文档
# 注意：.claude 目录应该提交到 Git，这样团队成员都能使用这些 Skills如何创建 .claude 文件夹
cmd
# 在 CMD 中（简单操作）
cd /d D:\Projects\your-project
mkdir .claude\skills
cmd
# 快速访问
explorer .claude3.4 企业级配置（简介）
适用场景：组织范围内的统一标准
配置路径：
/etc/claude-code/managed-settings.json特点：
- 最高优先级
- 需要企业计划
- 管理员统一配置
- 自动应用到所有用户
使用建议：
- 公司编码规范
- 安全策略
- 合规要求
- 统一的工作流程
3.5 插件级配置（简介）
适用场景：通过插件市场安装的 Skills
特点：
- 使用命名空间
plugin-name:skill-name - 不会与其他级别冲突
- 便于分发和更新
安装方式：
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills第二部分：快速安装
4. 安装 Skills 的三种方法
4.1 方法一：自然语言安装（推荐新手）
最简单的方式！
操作步骤
-
在 Claude Code 中直接输入：
帮我安装一个 skill，项目地址是：
https://github.com/anthropics/skills/blob/main/skills/pptx -
Claude Code 会自动：
- 下载 Skill 文件
- 放置到正确的目录
- 完成配置
优点
- ✅ 最简单直观
- ✅ 无需了解目录结构
- ✅ AI 自动处理细节
适用场景
- 快速测试新 Skill
- 不熟悉命令行操作
- 从 GitHub 安装单个 Skill
4.2 方法二：手动安装（推荐进阶用户）
完全控制安装过程！
步骤 1：下载 Skill 文件
cmd
# 使用 Git 克隆整个仓库（简单操作）
git clone https://github.com/anthropics/skills.git
# 或直接从 GitHub 下载 ZIP 文件并解压步骤 2：复制到目标位置
个人级安装：
cmd
# 使用 CMD（简单场景）
xcopy /E /I skills\skills\document-skills %USERPROFILE%\.claude\skills\document-skills\项目级安装：
cmd
# 在项目根目录
cd /d D:\Projects\your-project
mkdir .claude\skills
xcopy /E /I path\to\skill .claude\skills\skill-name\步骤 3：验证安装
cmd
# 重启 Claude Code
# 或在 Claude Code 中输入
/skills或者输入：
What skills are available?优点
- ✅ 完全控制安装过程
- ✅ 可以自定义修改
- ✅ 适合离线环境
适用场景
- 需要修改 Skill 内容
- 批量安装多个 Skills
- 企业内网环境
4.3 方法三：插件市场安装（推荐团队使用）
统一管理，自动更新！
步骤 1：添加插件市场
/plugin marketplace add anthropics/skills步骤 2：浏览可用 Skills
/plugin marketplace list步骤 3：安装指定 Skill
/plugin install document-skills@anthropic-agent-skills步骤 4：管理已安装的插件
# 查看已安装
/plugin list
# 更新插件
/plugin update document-skills
# 卸载插件
/plugin uninstall document-skills优点
- ✅ 统一管理
- ✅ 自动更新
- ✅ 版本控制
- ✅ 团队协作友好
适用场景
- 团队标准化工具
- 需要定期更新的 Skills
- 大规模部署
4.4 安装后的重要步骤
⚠️ 重要提示：安装完成后必须重启 Claude Code 才能生效！
验证安装：
# 查看所有可用 Skills
What skills are available?
# 测试特定 Skill
/skill-name test-argument5. 推荐的优质 Skills 资源
5.1 Anthropic 官方 Skills ⭐⭐⭐⭐⭐
GitHub 地址：https://github.com/anthropics/skills
推荐理由
- ✅ 官方维护，质量保证
- ✅ 经过严格测试
- ✅ 持续更新
- ✅ 最佳实践示例
包含的 Skills 类别
- 📄 文档处理（Markdown、PDF、PPTX）
- 🔍 代码审查
- 🎨 设计工具
- 📊 数据分析
- 🧪 测试生成
适合人群
- 新手入门首选
- 需要稳定可靠的工具
- 学习 Skill 开发的参考
快速安装
cmd
# 克隆仓库
git clone https://github.com/anthropics/skills.git
# 复制到个人目录
xcopy /E /I skills\skills\* %USERPROFILE%\.claude\skills\5.2 Superpowers ⭐⭐⭐⭐⭐
GitHub 地址 ：https://github.com/obra/superpowers
GitHub Stars：16,000+ 🌟
核心理念
强制 Claude 按照世界级高级工程师的标准流程工作，而不是随意编写代码。
功能覆盖
头脑风暴 → 需求文档 → 开发实现 → 测试验证 → 部署上线包含的 Skills
- 📋 需求分析与规划
- 🏗️ 架构设计
- 💻 代码实现
- 🧪 测试策略
- 📚 文档生成
- 🚀 部署流程
适合人群
- 追求高质量代码的开发者
- 需要完整开发流程的团队
- 希望 AI 遵循最佳实践
快速安装
cmd
# 克隆仓库
git clone https://github.com/obra/superpowers.git
# 复制到个人目录
xcopy /E /I superpowers\skills\* %USERPROFILE%\.claude\skills\5.3 其他优质资源
Jeffallan/claude-skills ⭐⭐⭐⭐
GitHub 地址：https://github.com/Jeffallan/claude-skills
特点：
- 65 个专业化 Skills
- 专为全栈开发者设计
- 技术栈覆盖：React、Vue、Node.js、Python、Database、DevOps
Skills 市场平台 - SkillsMP
统计数据：
- 📦 Skills 总数：58,000+
- 🔍 支持 AI 智能搜索
- 📂 完善的分类体系
- 🌐 中文界面支持
使用技巧：
- 使用 AI 搜索功能描述需求
- 按分类浏览相关 Skills
- 查看用户评分和下载量
- 阅读使用文档和示例
Awesome Claude Skills
GitHub 地址：https://github.com/travisvn/awesome-claude-skills
特点：
- 精选的 Skills 列表
- 定期更新
- 社区驱动
- 包含使用教程
第三部分：推荐配置
6. 推荐配置方案
6.1 新手入门配置
目标：快速上手，使用稳定的官方 Skills
步骤 1：安装 Claude Code
- 访问 Claude 官网 下载 Windows 版本
步骤 2：添加官方插件市场
/plugin marketplace add anthropics/skills步骤 3：安装推荐的 Skills
/plugin install document-skills@anthropic-agent-skills步骤 4：测试安装
What skills are available?推荐的入门 Skills
document-skills：文档处理code-review：代码审查test-generator：测试生成
6.2 个人开发者配置
目标：提升个人开发效率
推荐的个人级 Skills
C:\Users\你的用户名\.claude\skills\
├── code-review\ # 代码审查 Skill
├── api-doc-generator\ # API 文档生成器 Skill
├── test-writer\ # 测试编写助手 Skill
├── commit-message\ # Git 提交信息生成 Skill
└── refactor-helper\ # 重构辅助 Skill安装方式
方式 1：从 Superpowers 安装
cmd
# 1. 克隆 Superpowers 仓库
git clone https://github.com/obra/superpowers.git
# 2. 复制到个人 Skills 目录
xcopy /E /I superpowers\skills\* %USERPROFILE%\.claude\skills\
# 3. 重启 Claude Code方式 2：从官方市场安装
# 在 Claude Code 中执行
/plugin marketplace add anthropics/skills
/plugin install code-quality@anthropic-agent-skills6.3 团队协作配置
目标：统一团队标准，提升协作效率
推荐的项目级 Skills
D:\Projects\your-project\
├── .claude\
│ └── skills\
│ ├── coding-standards\ # 团队编码规范 Skill
│ ├── pr-template\ # Pull Request 模板 Skill
│ ├── deploy-staging\ # 部署到测试环境 Skill
│ └── project-docs\ # 项目文档生成 SkillGit 配置建议
gitignore
# .gitignore 文件配置
# 不要忽略 .claude 目录，让团队共享 Skills
#
# ❌ 错误配置：
# .claude\
#
# ✅ 正确配置：
# 不添加 .claude 到 .gitignore，让它被 Git 跟踪提交到版本控制
cmd
# 提交 Skills 到 Git
git add .claude\skills\
git commit -m "feat: add team skills"
git push相关链接：