Claude Code Skills保姆级全教程｜安装、使用、自定义开发+完整代码案例📚

前言✨

Claude Code 是Anthropic推出的终端编程助手，Skills 是其扩展能力核心模块，不用复杂插件框架即可拓展文件读写、Git、接口调用、脚本执行能力。本文从零拆解Skills全流程，附带命令、可运行代码、Mermaid流程图，新手也能直接上手。

一、什么是 Skills🧩

0. 一句话总结：

把你想要的提示+你想要做的行为写在一个md文件里，实现一个功能，类似于一个技能包，直接可以调用。

1. 核心定义

Skills 是Claude Code原生内置的轻量化能力扩展系统，基于**MCP(Model Context Protocol)** 协议实现，本质是一组标准化函数集合，允许Claude主动调用本地/远程工具、读写文件、执行终端命令、请求第三方API，突破纯文本对话限制。

2. 核心作用

• 本地工程操作：读写项目文件、检索代码、重构源码
• 终端能力：执行git、npm、curl、编译脚本等**shell** 命令
• 外部交互：调用数据库、接口、云服务、生成Mermaid图表
• 自动化流程：一键跑单元测试、生成接口文档、提交Git变更

简易调用流程图（Mermaid）

二、Skills和 Plugin的核心区别 📊

0. 一句话总结：

一句话：Plugin可能包含多个skills， Plugin 可能还包含很多agen 和hook

很多新手混淆两者，这里用对比表清晰区分：

对比维度	Skills	Plugin
底层协议	原生**MCP** 协议，官方标准	老旧第三方扩展规范，无统一协议
部署方式	单文件/轻量服务，写入**claude_desktop_config.json** 即可	需打包、安装依赖、注册插件市场
启动开销	极低，按需加载，无常驻进程	高，后台常驻插件服务，占用内存
开发难度	极简，JSON/TypeScript少量代码即可自定义	复杂，需适配插件SDK、生命周期钩子
权限控制	细粒度：单独配置文件、终端、网络权限	全局权限，管控粗糙
适用场景	本地开发、脚本工具、小型自定义能力	大型独立功能、跨平台重型组件

核心总结💡

日常本地开发拓展优先用**Skills**；独立重型业务组件才考虑Plugin。

三、怎么安装 Skills🛠️

手动复制

一句话：1.其他项目，2.或其他人写好的skills，3.各大skills公开平台。 直接下载下来复制到项目的指的目录下，
主要存放的目录:
1：个人用户目录，给自己用的
2：项目级别的，给团队用的

Skills 两大存放位置（官方标准）
1）个人全局 Skill（本机所有项目通用）
	路径
	
	    Mac/Linux：~/.claude/skills/技能文件夹/SKILL.md
	    Windows：%USERPROFILE%\.claude\skills\技能文件夹\SKILL.md
	
	说法 & 用途
		自己私用、通用工具（格式化代码、查接口、脚本工具），换项目不用重复复制。
2）项目本地 Skill（只当前项目生效，Git 可提交给团队）
	路径
		项目根目录：./.claude/skills/技能文件夹/SKILL.md

使用工具，插件安装

使用claude code 安装skills商场，在商场里下载安装，自动会下到项目里

四、Skills核心特点 🔥

0. 一句话总结：

1。重复使用
2。可被分享
3。自动触发

1. 原生轻量化：基于MCP标准，无冗余封装，启动速度毫秒级
2. 权限隔离：每个Skill独立配置环境变量、文件访问白名单，安全可控
3. 双向交互：Claude主动调用Skill获取本地资源，结果回流AI上下文
4. 跨语言兼容：Skill服务支持Node.js、Python、Go任意语言开发
5. 按需加载：仅当指令匹配对应能力时才启动Skill服务，不占用后台资源
6. 极简调试：内置**/skill-debug** 命令，一键打印调用日志、报错堆栈
7. 自定义零门槛：仅需定义函数入参、返回格式即可完成私有Skill开发

五、怎么使用 Skills📝

例如你创建了一个名字为 review 的skills 。直接在cc的命令窗口执行 /review

  可以 /review 
  也可以  /review 只审核xxx功能的代码，非xxx功能的不审核

六、自定义 Skills完整开发教程（含可运行代码）💻

本节从零开发一个自定义文件统计Skill：统计项目中Java文件行数，基于Node.js实现，可直接复制运行。

6.1 项目目录结构

review/
└── SKILL.md

6.2 编写规范

强制文件规范（90% 人踩坑这里）

    文件夹名：只能小写 + 横杠 review，不能大写、下划线、中文
    技能入口文件名：必须大写 SKILL.md，skill.md/ Skill.md 全部不识别
    SKILL.md 头部必须有 Frontmatter 元数据，定义命令名：

markdown

---
name: review
description: 你是专业代码评审专家，需根据场景执行评审
disable-model-invocation: true # 必须加，否则不能手动 /zhuzhucode 调用
---
# 下面是你复制的校验Prompt内容

6.3 案例

最简单的方式就是用cc帮你写一个skills 。
例如：帮我写一个名字为 review的skills，主要是用于代码审核的。

以下的skills 的md说明，可以直接用

---
name: review
description: 你是专业代码评审专家，需根据场景执行评审
disable-model-invocation: true # 必须加，否则不能手动 /review调用
---

# 代码评审规范（Code Review Skill）
你是专业代码评审专家，需根据场景按以下流程执行评审：

## 评审两种模式
### 模式一：本地变更评审（默认，未传入MR编号时）
未传入MR编号参数时，评审本地未提交代码改动：
1. 执行 `git status` 查看已修改文件
2. 执行 `git diff` 获取全部未提交代码差异
3. 分析代码改动，输出完整专业评审意见

### 模式二：合并请求MR评审（传入MR编号时）
传入MR编号（示例：`mr-1`、`MR-123`）时执行：
**重要说明**：本项目使用内部私有Git服务，非GitHub，无法使用gh命令行工具
1. 使用内部专属Git指令拉取MR详情
2. 若未配置内部Git接口/命令行工具，告知用户该情况
3. 备选方案：请用户手动提供MR代码差异文本

## 评审分析维度
完整代码评审需覆盖以下全部模块：
### 1. 改动概览
- 本次代码修改功能简述
- 改动影响范围与波及模块

### 2. 代码质量分析
- 代码逻辑正确性
- 是否遵守项目编码规范（参考 `.claude/CODING_RULES.md`）
- 类型注解规范（Python3.11 标准写法：`x | None`、`list[str]`）
- 导入语句规范（所有import统一放置文件头部）

### 3. 具体问题清单
每条问题需包含四项信息：
- **严重等级**：严重 / 高风险 / 中风险 / 低风险
- **位置**：文件路径+行号
- **问题描述**：清晰说明代码存在的问题
- **优化建议**：附带可直接使用的修正代码示例

### 4. 性能影响评估
- 数据库查询优化（N+1查询等问题）
- 内存占用情况
- 异步/await 编码规范
- 数据库连接池、连接释放处理

### 5. 安全风险检查
- 入参校验逻辑
- 身份认证、权限鉴权
- SQL注入、XSS跨站脚本风险
- 敏感数据处理与打印规范

### 6. 测试覆盖评估
- 缺失单元测试场景
- 未覆盖边界值、异常分支
- 是否需要补充集成测试

## 输出固定格式
```markdown
# 代码评审：[功能/模块名称]

## 改动概览
[简短描述本次修改内容]

## 代码亮点
[本次代码写得规范、优秀的地方]

## 发现问题

### 严重/高风险问题
[必须修改的致命缺陷]

### 中/低风险问题
[建议优化的瑕疵点]

## 优化可选建议
[非强制、可后续迭代改进的内容]

## 代码质量总评
| 评估维度 | 评级 | 备注说明 |
|--------|--------|-------|
| 逻辑正确性 | ✅/⚠️/❌ | ... |
| 性能表现 | ✅/⚠️/❌ | ... |
| 编码风格 | ✅/⚠️/❌ | ... |
| 安全性 | ✅/⚠️/❌ | ... |

## 评审结论
[直接通过 / 修改后通过 / 需要大幅整改]
 

 ## 重要注意事项
1. 项目使用私有Git内部服务，**禁止使用gh系列命令**，该工具不可用
2. 反馈内容落地、可执行，拒绝空泛评价
3. 标注代码位置统一使用 `文件路径:行号` 格式
4. 评审时结合项目配置文件 `CLAUDE.md` 上下文
5. 严格遵循 `.claude/CODING_RULES.md` 编码规范
6. 新增代码注释统一使用**中文**编写

结尾总结📌

Claude Code的**Skills** 是本地开发最强扩展能力，相比笨重Plugin更轻量化、易维护。

1. 日常开发直接使用官方内置file_skill/shell_skill，开箱即用；
2. 第三方工具需求安装开源MCP Skill；
3. 私有业务逻辑可基于MCP SDK从零自定义，支持任意编程语言；
4. 调试统一使用/skill-debug命令快速定位配置、代码问题。