Claude Code Skills 2 完整教程：配置方法、进阶用法与内置技能全解析

用 Claude Code 写代码的人，估计都被这事折磨过：

你让它帮你写个组件，写得挺好。第二天再让它写一个类似的，它完全不记得昨天聊了什么。你得重新告诉它你用的什么框架、什么代码风格、项目目录长什么样。

每次对话都像失忆重来。

更烦的是，你花半小时调教出一套好用的 prompt，换个项目又得从头来。用完就扔，太浪费了。

Claude Code Skills 2 就是来治这个病的。 这次升级之后，你可以把常用的指令、工作流、代码规范写成 Skill，一次配置，永久生效。下面我把 Claude Code Skills 2 的核心概念、配置方法和进阶玩法全部拆开讲一遍。

相关教程推荐：

想了解 Claude Code 的整体使用技巧？请查看 Claude Code 使用技巧：创始人分享的 10 个最新用法

需要 ChatGPT Plus？请查看 ChatGPT Plus 一键充值教程

01 | Claude Code Skills 2 到底是个啥

一句话讲完：Claude Code Skills 2 里的 Skill，就是一份可以反复使用的指令配方。

你把想让 Claude 干的事写成一个 SKILL.md 文件，往指定目录一放。之后 Claude 遇到相关场景，自动读取这个配方，按你的要求干活。

你也可以手动输入 /skill-name 直接触发。

不用每次重新解释，不用每次重新调教。写一次，永久生效。

这和以前的 custom commands 有啥区别？Claude Code Skills 2 加了不少东西：支持多文件目录、frontmatter 配置、subagent 隔离运行、动态注入上下文。后面一个个讲。

02 | Claude Code Skills 2 的两种类型

Claude Code Skills 2 的 Skill 分两种，区别搞清楚了后面就好理解了。

第一种：参考型 Skill

给 Claude 补知识、加约束。比如你们团队有一套 API 设计规范，写成 Skill，Claude 写接口的时候自动遵守。

---
name: api-conventions
description: API design patterns for this codebase
---

When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats
- Include request validation

这种 Skill 不是让 Claude 执行什么任务，而是让它工作时「带着这些知识」。相当于给它装了个插件，相关场景下自动生效。

第二种：任务型 Skill

告诉 Claude 具体做什么、一步步怎么做。部署流程、代码审查流程、报告生成流程，都属于这类。

---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
---

Deploy the application:
1. Run the test suite
2. Build the application
3. Push to the deployment target
4. Verify the deployment succeeded

注意 disable-model-invocation: true 这行。加了它，Claude 就不能自己决定什么时候跑这个 Skill，只有你手动输 /deploy 才会触发。

你肯定不想 Claude 觉得代码写差不多了就自己跑去部署吧。

ChatGPT Plus 国内充值/升级与支付

支持 ChatGPT代充与 ChatGPT Plus支付，流程清晰，服务稳定

ChatGPT充值升级

03 | Claude Code Skills 2 的 SKILL.md 怎么写

在 Claude Code Skills 2 中，每个 Skill 就是一个目录，里面放一个 SKILL.md。目录结构长这样：

my-skill/
├── SKILL.md           # 主文件（必须有）
├── template.md        # 模板（可选）
├── examples/
│   └── sample.md      # 示例（可选）
└── scripts/
    └── validate.sh    # 辅助脚本（可选）

SKILL.md 分两部分：上面是 YAML frontmatter 配置，下面是 markdown 写的指令。

Frontmatter 常用字段一览：

字段	干嘛用的
`name`	Skill 名字，也是 `/` 命令名
`description`	描述。Claude 靠它判断啥时候自动加载
`disable-model-invocation`	设 true，Claude 不会自作主张触发
`allowed-tools`	限制这个 Skill 能调哪些工具
`context`	设 fork，在独立 subagent 里跑
`agent`	指定用哪个 subagent
`model`	指定用哪个模型

来个完整例子。这个 Skill 专门解释代码，你问「这段代码怎么回事」的时候会自动加载：

---
name: explain-code
description: Explains code with visual diagrams and analogies. Use when explaining how code works, teaching about a codebase, or when the user asks "how does this work?"
---

When explaining code, always include:

1. **Start with an analogy**: Compare the code to something from everyday life
2. **Draw a diagram**: Use ASCII art to show the flow or relationships
3. **Walk through the code**: Explain step-by-step what happens
4. **Highlight a gotcha**: What's a common mistake or misconception?

Keep explanations conversational.

写完放到目录里，Claude 就认识它了。

04 | Claude Code Skills 2 放哪里，决定谁能用

Claude Code Skills 2 中 Skill 的存放位置直接决定作用范围，这个设计挺巧妙的：

级别	路径	谁能用
个人	`~/.claude/skills/<name>/SKILL.md`	你所有项目
项目	`.claude/skills/<name>/SKILL.md`	这个项目所有人
插件	`<plugin>/skills/<name>/SKILL.md`	装了插件的人
企业	托管设置部署	整个组织

优先级：企业 > 个人 > 项目。

举个例子，你个人的代码风格偏好放 ~/.claude/skills/，所有项目通用。团队的 CI/CD 部署流程放项目的 .claude/skills/，提交到 git，团队成员自动共享。

还有个实用细节：monorepo 自动发现。你在编辑 packages/frontend/ 下的文件，Claude 会同时去找 packages/frontend/.claude/skills/ 里的 Skill。不用额外配置，直接生效。

05 | Claude Code Skills 2 参数传递

Claude Code Skills 2 支持传参。用 $ARGUMENTS 占位符接收 /skill-name 后面的内容。

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---

Fix GitHub issue $ARGUMENTS following our coding standards.

1. Read the issue description
2. Understand the requirements
3. Implement the fix
4. Write tests
5. Create a commit

跑 /fix-issue 123，Claude 收到的就是「Fix GitHub issue 123 following our coding standards」。

多个参数的话，用 $0、$1、$2（$ARGUMENTS[N] 的简写）：

---
name: migrate-component
description: Migrate a component from one framework to another
---

Migrate the $0 component from $1 to $2.
Preserve all existing behavior and tests.

跑 /migrate-component SearchBar React Vue，三个参数自动填充。简单粗暴。

06 | Claude Code Skills 2 动态上下文注入

这个功能我觉得是 Claude Code Skills 2 里最有意思的。

用 !`command` 语法，Skill 加载之前先跑一遍 shell 命令，把结果塞进提示词里。Claude 看到的不是命令本身，而是执行结果。

---
name: pr-summary
description: Summarize changes in a pull request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Your task
Summarize this pull request...

这等于在 Skill 里嵌入了实时数据。Claude 拿到的是一份已经准备好的完整上下文，直接开干。

比让 Claude 自己一个个去跑命令快多了，而且不会跑偏。

07 | Claude Code Skills 2 Subagent 隔离运行

有些 Skill 不适合在主对话里跑。比如扫描整个代码库的研究任务，在主对话里执行的话上下文很快就爆了。

加个 context: fork，Skill 在独立 subagent 里运行：

---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly:

1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references

跑完之后结果汇总返回主对话，主对话上下文干干净净。

agent 可以选 Explore（只读探索）、Plan（架构规划）、general-purpose（通用），也可以用你自定义的 agent。

踩坑提醒：context: fork 只适合有明确任务的 Skill。如果你的 Skill 只是参考知识（比如「遵循这些 API 规范」），subagent 收到了但不知道干啥，返回的东西没啥用。别问我怎么知道的。

08 | Claude Code Skills 2 内置技能一览

Claude Code Skills 2 自带几个 Skill，不用自己写，直接敲命令就行。

/simplify：代码清理神器。写完功能或修完 bug 跑一遍，它并行启动三个审查代理（复用性、质量、效率），汇总问题然后自动修。省得你自己 review 自己的代码。

/batch：批量改代码。告诉它要改什么，它拆成 5 到 30 个子任务，每个在独立 git worktree 里跑，各自提 PR。大规模重构用这个，比如 /batch migrate src/ from Solid to React。

/debug：调试会话。读当前对话的调试日志来排查问题。

/loop：定时循环。/loop 5m check if the deploy finished，每 5 分钟看一眼部署好了没。

/claude-api：加载 Claude API 参考文档。代码里 import 了 anthropic 或 @anthropic-ai/sdk，自动激活。

09 | Claude Code Skills 2 权限控制

Claude Code Skills 2 的权限控制做得比较细，对团队使用很重要。

限制工具访问，让 Skill 只能用特定工具：

---
name: safe-reader
description: Read files without making changes
allowed-tools: Read, Grep, Glob
---

只能读，不能改。给实习生用的时候比较安心。

限制哪些 Skill 能被调用，在 /permissions 里配：

# 允许
Skill(commit)
Skill(review-pr *)

# 禁止
Skill(deploy *)

隐藏 Skill。设 user-invocable: false，不出现在 / 菜单里，但 Claude 相关场景下还是会自动加载。适合那些纯粹的背景知识型 Skill。

10 | Claude Code Skills 2 生成视觉输出

Claude Code Skills 2 的 Skill 不只是处理文本。它可以执行脚本，生成 HTML 在浏览器里打开。

官方文档有个 codebase-visualizer 的例子，扫描项目结构，生成可交互的树状图：

---
name: codebase-visualizer
description: Generate an interactive collapsible tree visualization of your codebase.
allowed-tools: Bash(python *)
---

Run the visualization script from your project root:

python ~/.claude/skills/codebase-visualizer/scripts/visualize.py .

Skill 目录里放一个 Python 脚本（只用标准库，不装依赖），跑完浏览器自动弹出来。

这个思路可以延伸：依赖关系图、测试覆盖率报告、数据库结构可视化，都能用同样的模式搞。

11 | 手把手教程：从零创建一个 Claude Code Skill

概念讲完了，动手走一遍。

场景：你经常做 code review，每次都得重复说审查标准。做成 Skill，一劳永逸。

第一步，建目录：

mkdir -p ~/.claude/skills/code-review

第二步，写 SKILL.md：

---
name: code-review
description: Review code changes with consistent standards. Use when reviewing PRs, diffs, or code changes.
allowed-tools: Read, Grep, Glob, Bash(git diff *)
---

Review the code changes with these criteria:

## Security
- Check for hardcoded secrets, SQL injection, XSS
- Verify input validation at system boundaries

## Performance
- Look for N+1 queries, unnecessary re-renders
- Check for missing indexes on queried fields

## Maintainability
- Functions under 50 lines
- No magic numbers without constants
- Error messages should be actionable

## Output format
For each issue found:
- **File**: path and line number
- **Severity**: critical / warning / suggestion
- **Issue**: what's wrong
- **Fix**: how to fix it

第三步，用起来：

直接问 Claude「review the recent changes」，或者手动跑 /code-review。它会按你定义的标准审查，输出格式也是你规定的。

换了项目，这个 Skill 还在。因为它在 ~/.claude/skills/ 下面，跟着你走，不跟着项目走。

Claude Code Skills 2 核心功能总结

功能模块	核心作用	适用场景
参考型 Skill	补知识、加约束，自动加载	代码规范、API 设计、团队约定
任务型 Skill	定义执行步骤，手动或自动触发	部署、审查、报告生成
参数传递	`$ARGUMENTS` 接收命令行参数	fix-issue、migrate 等通用任务
动态上下文注入	!`command` 实时注入 shell 结果	PR 摘要、CI 状态、数据库查询
Subagent 隔离	`context: fork` 独立运行	大规模研究、避免上下文爆炸
权限控制	`allowed-tools` 和 `/permissions`	团队协作、安全边界
内置 Skill	`/simplify`、`/batch`、`/debug` 等	日常代码整理和批量操作

写在最后

Claude Code Skills 2 干的事说白了就一件：把你和 AI 协作中那些重复的东西固化下来。

以前 Claude 是个很强但没记忆的工具，每次对话从零开始。现在通过 Claude Code Skills 2，你可以把经验攒成 Skill，它越用越顺手。

技术上也不复杂。一个 markdown 文件，放到对应目录，完事。高级功能要了解些 frontmatter 配置，但核心就是「把你的要求写下来，让 Claude 每次都照着办」。

如果你在用 Claude Code，建议从最简单的 Skill 开始试。把你最常重复的那句指令、最常给的那段上下文，做成一个 Claude Code Skill。

试一次就回不去了。

如果你在使用 Claude Code 时需要调用 ChatGPT 的 API，或者日常工作中需要使用 ChatGPT Plus，可以通过 GetGPTPlus 快速充值开通，支持支付宝/微信支付，省去海外支付的麻烦。