第3篇：Skill 技能实战 — 从需求到自动化

前置知识：阅读第1-2篇后食用效果更佳
学习时长：约 20 分钟

你将学到什么

• 理解 Skill 是什么，以及它与 CLAUDE.md 的区别
• 安装现成的 Skill（/install-skill）
• 编写你自己的第一个 Skill 文件
• 配置 Skill trigger，让 Claude 自动激活技能
• 结合 KB_WORKFLOW 实现知识库自动化

---

1. Skill 是什么

定义

Skill（技能）是 Claude Code 的扩展机制，允许你定义可复用的专业能力，工作流程和行为规范。你可以把它理解为：为 Claude Code 编写的角色说明书。

Skill vs CLAUDE.md

对比项	CLAUDE.md	Skill 文件
作用范围	全局项目规则	特定专业能力
加载时机	每次对话自动加载	按需加载或条件触发
粒度	粗粒度	细粒度、可组合
存储位置	项目根目录	~/.claude/skills/

你的项目中已有的 Skill

打开 .claude/skills/ 目录，可以看到本项目配置的技能：

.claude/skills/
├── android-engineer.skill.md      # Android 全栈工程师角色
├── android-architect.skill.md      # 架构师角色
├── kotlin-coder.skill.md          # Kotlin 专家角色
├── bluetooth-hardware-dev.skill.md # 蓝牙/硬件开发角色
├── code-reviewer.skill.md         # 代码审查角色
├── debug-specialist.skill.md      # 调试专家角色
├── worklog.skill.md               # 工作日志记录技能
└── ...（共 11 个角色技能）

每个技能都对应一个特定角色，当你需要该角色的专业知识时，Claude 会自动激活对应的技能。

---

2. 安装现成 Skill

使用 /install-skill

Claude Code 内置了 /install-skill 命令，可以从本地路径或 GitHub 安装技能：

安装方式	命令
本地路径（全局）	/install-skill file:///D:/path/to/skill
本地路径（项目级）	/install-skill D:/path/to/skill --local
GitHub	/install-skill https://github.com/owner/repo/tree/branch/path

安装位置

选项	目标目录
（默认）	~/.claude/skills/（全局）
--local	从当前目录向上搜索 .claude/skills/（项目级）

实际案例：安装 huashu-series-gen

/install-skill D:/dazhao/AI/skill/openProjects/huashu-skills/huashu-series-gen

安装完成后，Claude Code 会提示：

Skill 'huashu-series-gen' 已安装
位置：~/.claude/skills/huashu-series-gen/
使用方式：/huashu-series-gen

---

3. 编写你的第一个 Skill

Skill 文件结构

每个 Skill 文件包含两部分：

1. Frontmatter（元数据）：

---
name: android-engineer
description: Android 全栈工程师角色...
tools: [Read, Edit, Write, Bash]
---

2. Prompt 内容（角色定义）：

# Android 全栈工程师

## 角色定位

你是一位 Android 全栈工程师...

## 技术栈

### 核心语言
- Kotlin: 主要开发语言
...

实际案例：kotlin-coder.skill.md

这是项目中已有的 Kotlin 专家角色：

---
name: kotlin-coder
description: Kotlin 语言专家，精通协程、Flow、扩展函数
tools: [Read, Edit, Write, Bash]
---

# Kotlin 专家

## 核心技能

- Kotlin 协程（Coroutine、Flow、Channel）
- 扩展函数与高阶函数
- 空安全（Null Safety）

调用 Skill

在对话中直接提及即可激活：

以 Kotlin 专家的身份，帮我写一个 Flow 处理网络请求的示例

Claude 会自动加载 kotlin-coder.skill.md，并以 Kotlin 专家的角色回应你。

---

4. Skill Trigger 配置

什么是 Trigger

Trigger 是 Skill 的自动激活机制。当你的对话中包含特定关键词时，Claude 会自动加载对应的技能。

配置示例

在 Skill 文件的 frontmatter 中添加 trigger 字段：

---
name: android-engineer
description: Android 全栈工程师角色
tools: [Read, Edit, Write, Bash]
trigger:
  - "Android 开发"
  - "Kotlin 问题"
  - "协程"
  - "蓝牙"
---

实际触发效果

你说的话	自动激活的 Skill
"帮我写一个 Kotlin 协程的用法"	kotlin-coder
"蓝牙设备连接失败了"	bluetooth-hardware-dev
"帮我 review 这段代码"	code-reviewer
"开始记录工作日志"	worklog

反斜杠转义注意

在 YAML 中，反斜杠是转义字符：

实际想表达	YAML 中写法
pan\daily	pan\\daily
C:\path	C:\\\\path

---

5. 结合 KB_WORKFLOW 实现自动化

KB_WORKFLOW 简介

你已经在项目中配置了 KB_WORKFLOW，这是三个方案的组合：

方案	命令	用途
方案1	/save-kb <分类> <标题>	精准保存
方案2	粘贴自动识别提示词	AI 被动识别
方案3	/skill worklog	工作日志

worklog Skill 实战

激活工作日志：

/skill worklog
开始记录，今天的任务是天通SDK优化

Claude 会：
1. 自动激活 worklog.skill.md 角色
2. 创建/追加 pan/daily/2026年MM.md
3. 等待你随时补充记录

补充记录：

记录：完成了蓝牙扫描功能的测试

结束记录：

今日结束

save-kb Skill 快速保存

/save-kb kotlin "协程Flow用法总结"

Claude 会将当前对话中的 Kotlin 协程内容保存到 kotlin/协程Flow用法总结.md。

---

6. 常见问题

Q: Skill 不可用？

确保：
1. Skill 文件在 ~/.claude/skills/ 或项目 .claude/skills/ 目录下
2. 文件扩展名是 .skill.md
3. 文件名不带空格（用 - 分隔）

Q: 多个 Skill 冲突？

Claude Code 按优先级加载：
1. 显式调用的 Skill（/skill xxx）
2. Trigger 自动匹配的 Skill
3. CLAUDE.md 全局规则

Q: 如何调试 Skill？

在 Skill 文件开头加上调试注释：

<!-- DEBUG: active -->

Claude 会输出 Skill 加载的中间状态。

---

快速回顾

要点	内容
安装命令	/install-skill <path>
Skill 目录	~/.claude/skills/
调用方式	直接提及角色名
Trigger	frontmatter 中的 trigger 列表
KB 保存	/save-kb <分类> <标题>
工作日志	/skill worklog

---

延伸阅读

• 上一篇：第2篇-核心工具实战
• 下一篇：第4篇-知识库与记忆系统

---

下篇预告：深入 CLAUDE.md、Memory 文件、KB_WORKFLOW 的实际运作机制，让 Claude Code 越用越懂你。