toMedia
Claude Code CLI

Skills(技能)

Claude Code 的技能系统 — 内置斜杠命令与自定义 Skill 文件

内置斜杠命令

在交互模式中,以 / 开头的命令是内置斜杠命令:

命令功能
/help显示帮助信息
/clear清除当前对话上下文
/compact压缩对话历史,节省 token
/config打开设置菜单
/cost显示当前会话的 token 用量和费用
/doctor诊断 Claude Code 的配置问题
/login切换登录账户
/logout退出登录
/model切换模型
/permissions管理工具权限
/review代码审查当前更改
/fast切换快速模式(相同模型,更快输出)

自定义 Skills

Skills 是可复用的知识和工作流,通过 Markdown 文件定义。

Skill 文件格式

---
name: my-skill
description: 一段简短描述,用于判断何时触发
---

# 技能内容

这里写具体的指令和规则。

## 步骤

1. 第一步...
2. 第二步...
3. 第三步...

Skill 存放位置

~/.claude/skills/           # 全局 Skills(所有项目可用)
.claude/skills/             # 项目级 Skills

创建 Skill 示例

创建一个代码审查 Skill:

---
name: code-review
description: 代码审查 — 检查代码质量、安全性和可维护性
---

# 代码审查清单

## 检查项

1. **类型安全**:是否有 `any` 类型?
2. **错误处理**:是否处理了所有异常情况?
3. **安全性**:是否有 XSS、SQL 注入风险?
4. **性能**:是否有不必要的重渲染或 N+1 查询?
5. **可读性**:命名是否清晰?逻辑是否容易理解?

## 输出格式

对每个问题按以下格式输出:
- 文件:行号
- 问题描述
- 修复建议

调用 Skill

# 在交互模式中
> /code-review

# 或使用 Skill 工具(Claude 会自动匹配)

Skill 元数据

frontmatter 中的关键字段:

---
name: skill-name          # 技能名称
description: 简短描述      # 用于判断何时触发
filePattern: "*.tsx"       # 文件匹配模式(可选)
bashPattern: "npm test"    # Bash 命令匹配(可选)
---
  • filePattern:当操作匹配的文件时自动触发
  • bashPattern:当执行匹配的命令时自动触发

插件系统

Skills 也可以通过插件安装:

# 安装插件
claude plugin add plugin-name

# 列出已安装插件
claude plugin list

# 移除插件
claude plugin remove plugin-name

插件可以提供:

  • 多个 Skills
  • Hooks 配置
  • MCP 服务器

最佳实践

  1. 描述精确:description 越准确,自动匹配越精准
  2. 聚焦单一职责:每个 Skill 解决一类问题
  3. 包含步骤:给出清晰的执行步骤
  4. 团队共享:项目级 Skill 放在 .claude/skills/ 中提交 git
  5. 持续迭代:根据使用反馈优化 Skill 内容

On this page