Claude Code Skills：可复用提示词模块完整指南

Skills 是 Claude Code 的可复用提示词模块，每个 Skill 对应一种专项任务，通过 /skill-name 调用。一次配置，反复使用。

Skills 的工作原理#

一个 Skill 本质上是一个带有详细指令的提示词文件（Markdown 格式），存放在 .claude/skills/ 目录下。调用时，Claude Code 把 Skill 的内容加载进上下文，按照其中的指令完成任务。

Skills 有两种来源：

安装型：通过 npx skills add <URL> 从远程安装，下载到 ~/.claude/skills/ 目录，所有项目均可调用
自定义型：在项目的 .claude/skills/ 目录手写 .md 文件，只在该项目可用；放在 ~/.claude/skills/ 则全局可用

目录结构示例：

1
project/
2
└── .claude/
3
    └── skills/
4
        ├── commit.md       # git commit 规范化（安装型或自定义）
5
        ├── review-pr.md    # PR 代码审查
6
        └── deploy-check.md # 自定义 Skill

调用 Skill#

在 Claude Code 对话中，输入 /skill-name 即可调用：

1
/commit
2
/review-pr 123
3
/deploy-check

斜杠后面接 Skill 文件名（不含 .md 后缀）。部分 Skill 支持传递参数，如 /review-pr 123 中的 123 是 PR 编号，Skill 文件里通过 $ARGUMENTS 引用。

内置 Skills#

Claude Code 自带一批常用 Skills，覆盖开发流程中最高频的操作：

/commit#

自动生成符合规范的 git commit 信息。

调用后 Claude 会分析当前 staged changes，生成符合 Conventional Commits 规范的提交信息，包含 type、scope 和描述，并添加 Co-Authored-By 署名。

1
git add .
2
/commit
3
# Claude 输出：feat(auth): add OAuth2 login flow

/review-pr#

审查指定 PR，输出结构化的问题清单。

1
/review-pr 42

Claude 会拉取 PR #42 的 diff，从代码质量、潜在 bug、安全风险、性能问题几个维度输出审查意见，每条问题标注文件和行号。

/simplify#

简化和重构刚修改的代码，专注于可读性。调用后 Claude 只处理最近改动的部分，不触碰其他代码。

适合在功能实现完成后，快速做一轮代码整洁处理。

/loop#

按设定间隔循环执行某个任务，适合监控型场景。例如每隔 30 秒检查一次某个 API 的返回状态，直到条件满足为止。

自定义 Skill#

在 .claude/skills/ 下创建 .md 文件，写入任务描述和执行步骤，即为一个自定义 Skill。

基础示例#

1
# deploy-check
2

3
检查当前分支是否满足部署条件：
4

5
1. 确认所有测试通过（运行 `npm test`）
6
2. 检查是否有未提交的改动（`git status`）
7
3. 验证 CI 最新 run 的状态
8
4. 检查是否有 console.log 遗留在代码里
9
5. 输出结论：可以部署 / 不可以部署（列出原因）

保存后直接用 /deploy-check 调用。

带参数的 Skill#

Skill 文件里用 $ARGUMENTS 接收调用时传入的参数：

1
# test-file
2

3
为 $ARGUMENTS 这个文件编写单元测试：
4

5
1. 分析文件里所有导出的函数和类
6
2. 用项目已有的测试框架（查看 package.json 确认）
7
3. 覆盖正常路径和边界情况
8
4. 测试文件命名规则：原文件名加 `.test` 后缀，放在同目录下

调用方式：

1
/test-file src/utils/parser.ts

适合做成 Skill 的场景#

有固定检查清单的任务（部署检查、发布前检查）
需要跨多个文件协调操作的任务（生成 CRUD 全套代码）
团队内需要统一输出格式的任务（代码审查、技术方案评审）
重复性但每次对象不同的任务（为新模块写测试、生成 API 文档）

编写高质量 Skill 的建议#

明确输出格式：告诉 Claude 输出什么，而不是只说”分析一下”。

1
# bad
2
分析这段代码的问题。
3

4
# good
5
分析这段代码，用以下格式输出：
6
- [严重] 影响功能或安全的问题
7
- [建议] 影响可维护性的问题
8
- [可选] 风格或性能改进
9
每条问题注明文件路径和行号。

加入约束条件：明确说明不做什么，减少 Claude 自作主张。

1
只修改有问题的函数，不要重构周边代码，不要改变函数签名。

分步骤描述：复杂任务拆成有序步骤，Claude 的执行准确率更高。

Claude Code 的其他使用技巧（Projects、上下文管理、MCP 接入）参考 Claude 使用技巧。想了解 Claude Code 在 AI 工具体系里的位置，见 AI 工具推荐。