第三章:Skill 是什么

3.1 一句话定义

Skill 是 Claude Code 的"技能卡片" —— 你写好的提示词模板,放在 .claude/skills/ 目录下,Claude 在相关场景自动调用。

3.2 为什么需要 Skill

没有 Skill 时

你: 帮我写个 Python 函数,读取 CSV 并计算平均值
Claude: (每次都从头理解需求,可能遗漏细节)

有 Skill 后

你: 分析这个 CSV 文件
Claude: (自动加载 "数据分析 Skill",按预设规范执行:检查编码、处理缺失值、生成统计报告)

核心价值

  • ✅ 标准化重复任务的处理流程
  • ✅ 减少每次对话的重复说明
  • ✅ 团队协作时统一代码规范
  • ✅ 复杂任务分解为可复用的步骤

3.3 Skill 的工作原理

用户输入 → Claude 匹配 Skill → 加载 SKILL.md → 按指令执行 → 输出结果

匹配方式:

  1. 文件名匹配python-debug.md → 用户提到 Python 调试时触发
  2. 内容匹配:Skill 文件中的 tags 和描述
  3. 显式调用:用户说 “使用数据分析 Skill”

3.4 Skill 文件结构

my-project/
└── .claude/
    └── skills/
        ├── python-debug.md       # Python 调试 Skill
        ├── code-review.md        # 代码审查 Skill
        ├── stock-trade.md        # 股票交易 Skill(我们即将开发的)
        └── ...

每个 Skill 是一个 Markdown 文件,包含:

# Skill 名称

## 描述
这个 Skill 是做什么的...

## 适用场景
- 什么时候用这个 Skill
- 触发关键词

## 执行步骤
1. 第一步做什么
2. 第二步做什么
3. ...

## 输出格式
结果应该怎么呈现...

## 示例
### 示例 1:简单情况
输入:...
输出:...

### 示例 2:复杂情况
输入:...
输出:...

## 注意事项
- 注意点 1
- 注意点 2

3.5 内置 Skill

Claude Code 自带一些内置 Skill,开箱即用:

内置 Skill 功能 触发方式
git-commit 生成规范的 commit message /git commit 或 “提交代码”
explain-code 解释代码逻辑 “解释这段代码”
fix-lint 修复代码风格问题 “修复 lint 错误”
test-generation 生成单元测试 “给这个函数写测试”

完整内置 Skill 清单见 附录


更多推荐