Skip to main content
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/ 则全局可用
目录结构示例： 
project/
└── .claude/
    └── skills/
        ├── commit.md       # git commit 规范化（安装型或自定义）
        ├── review-pr.md    # PR 代码审查
        └── deploy-check.md # 自定义 Skill

​
调用 Skill

在 Claude Code 对话中，输入 /skill-name 即可调用： 
/commit
/review-pr 123
/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 署名。 
git add .
/commit
# Claude 输出：feat(auth): add OAuth2 login flow

​
/review-pr

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

​
/simplify

简化和重构刚修改的代码，专注于可读性。调用后 Claude 只处理最近改动的部分，不触碰其他代码。 适合在功能实现完成后，快速做一轮代码整洁处理。

​
/loop

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

​
自定义 Skill

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

​
基础示例

# deploy-check

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

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

​
带参数的 Skill

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

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

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

​
适合做成 Skill 的场景

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

​
编写高质量 Skill 的建议

明确输出格式：告诉 Claude 输出什么，而不是只说”分析一下”。 
# bad
分析这段代码的问题。

# good
分析这段代码，用以下格式输出：
- [严重] 影响功能或安全的问题
- [建议] 影响可维护性的问题
- [可选] 风格或性能改进
每条问题注明文件路径和行号。
加入约束条件：明确说明不做什么，减少 Claude 自作主张。 
只修改有问题的函数，不要重构周边代码，不要改变函数签名。
分步骤描述：复杂任务拆成有序步骤，Claude 的执行准确率更高。
Claude Code 的其他使用技巧（Projects、上下文管理、MCP 接入）参考 Claude 使用技巧。想了解 Claude Code 在 AI 工具体系里的位置，见 AI 工具推荐。