Claude Skill 完全入门指南：让 AI 助手学会你的工作流
5 分钟上手，让 Claude 记住你的专属命令
Claude Skill 是可以保存的自定义指令集，让 Claude 记住你常用的工作流程。就像给 AI 助手安装"插件"，一次配置，永久使用。
核心优势：
-
✅ 一次编写，跨会话复用
-
✅ 标准化输出格式
-
✅ 封装领域知识
-
✅ 团队可共享
什么是 Claude Skill？
简单来说，Skill 就是一个 Markdown 格式的指令文件，告诉 Claude：
-
什么时候被触发（触发条件）
-
需要做什么（执行步骤）
-
输出什么格式（模板）
一个最小示例
--- name: meeting-notes description: 整理会议记录为结构化笔记 --- # 会议记录整理 将用户提供的会议内容整理为以下格式： ## 📅 会议信息 - 时间： - 参与者： ## 🎯 核心议题 1. ## ✅ 待办事项 - [ ] 任务 - 负责人 - 截止日期 ## 💡 关键决策
保存为 meeting-notes.md，通过 Claude 的 save_skill 功能保存后，下次只需说"整理这个会议记录"，Claude 就会自动按这个格式输出。
Skill 的三大应用场景
1. 标准化输出格式
适合需要固定格式的任务：代码审查、文档模板、周报生成等。
--- name: code-review description: 标准化代码审查流程 --- 对提供的代码进行审查，输出： ## 🔍 代码质量评分 - 可读性：/10 - 性能：/10 - 安全性：/10 ## ⚠️ 发现的问题 1. **[严重性]** 问题描述 - 位置：文件名:行号 - 建议： ## ✨ 改进建议
2. 领域知识封装
把专业流程固化下来。
比如法律文书审查、医学文献总结、财务报表分析等。你可以把行业术语、审查要点、注意事项都写进 Skill，让 Claude 成为领域专家。
3. 多步骤工作流自动化
串联多个操作。
--- name: deploy-checklist description: 发布前检查清单 --- # 发布前检查流程 依次执行： 1. 运行测试套件 2. 检查 git 状态（未提交的文件） 3. 对比版本号是否已更新 4. 生成 changelog 5. 输出发布准备报告
如何创建你的第一个 Skill
方法一：在对话中创建（推荐）
直接对 Claude 说：
帮我创建一个 skill，名字叫 "api-doc"， 用来生成 RESTful API 文档， 包含端点、参数、返回值和错误码说明。
Claude 会自动调用 save_skill 工具保存。
方法二：手动编写
-
创建 Markdown 文件
-
添加 frontmatter（YAML 格式的元数据）
-
编写指令内容
-
让 Claude 调用
save_skill保存
Frontmatter 必填字段：
--- name: skill-name # kebab-case 命名，如 api-doc description: 简短描述 # 一句话说明用途，触发时显示 ---
Skill 编写最佳实践
1. 清晰的触发描述
❌ 不好的描述：
description: 处理文档
✅ 好的描述：
description: 将技术文档转换为用户友好的使用指南，包含截图占位符和分步说明
描述要具体，让 Claude 知道什么情况下应该用这个 Skill。
2. 结构化输出模板
使用 Markdown 语法定义清晰的输出结构：
## 标题层级 - 列表项 - [ ] 待办事项 **加粗重点** `代码片段` > 引用说明
3. 包含示例
在 Skill 中加入示例输入/输出，让 Claude 理解得更准确：
--- name: commit-message description: 生成规范的 Git commit 消息 --- # Git Commit 消息生成 根据代码变更生成符合 Conventional Commits 规范的提交消息。 ## 格式
<type>(<scope>): <subject>
<body>
```
示例
feat(auth): 添加 OAuth2 登录支持 - 集成 Google 和 GitHub OAuth - 添加用户会话管理 - 更新登录页面 UI Closes #123
### 4. 变量和占位符
需要用户输入的部分用占位符标记：
```markdown
分析 {{产品名称}} 的市场竞争力，
目标市场：{{地区}}，
对比竞品：{{竞品列表}}
Skill 管理技巧
查看已安装的 Skill
对 Claude 说：
show my skills
或
what skills do I have
会显示交互式列表，可以直接点击"Try it"测试。
更新现有 Skill
更新 api-doc skill，增加认证方式说明
Claude 会读取现有 Skill，修改后用 overwrite: true 参数更新。
Skill 组合使用
Skill 之间可以相互引用：
1. 先使用 `code-review` skill 检查代码 2. 如果通过，使用 `commit-message` skill 生成提交信息 3. 最后使用 `deploy-checklist` skill 准备发布
进阶：Skill 与工具联动
Skill 不仅可以定义输出格式，还能调用 Claude 的各种工具能力。
示例：自动化周报生成
--- name: weekly-report description: 从 Git 提交记录生成周报 --- # 周报生成流程 1. 使用 bash 工具执行： git log --since="1 week ago" --pretty=format:"%h - %s" --author="用户名"
-
分析提交记录，按模块分类
-
输出周报：
-
保存为
weekly_report_YYYY-MM-DD.md
调用时 Claude 会自动执行 Git 命令、分析内容、生成文件。
---
## 实战案例：浏览器自动化 Skill
结合我们之前做的 Playwright 自动化，创建一个 Skill：
```markdown
---
name: web-automation
description: 生成浏览器自动化脚本
---
# 浏览器自动化脚本生成器
根据用户描述的操作流程，生成 Playwright Python 脚本。
## 输入格式
用户应提供：
- 目标网站 URL
- 需要执行的操作（点击、填表、截图等）
- 需要提取的数据（可选）
## 输出
1. 完整的 Python 脚本
2. 依赖安装命令
3. 使用说明
## 脚本模板
```python
from playwright.sync_api import sync_playwright
def automate():
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
# 用户操作流程
{{生成的代码}}
browser.close()
if __name__ == "__main__":
automate()
注意事项
-
添加适当的等待时间
-
处理可能的弹窗
-
包含错误处理
--- ## 团队协作：Skill 共享 Skill 文件是纯文本，可以通过以下方式共享： 1. **Git 仓库管理**
skills/ ├── code-review.md ├── api-doc.md └── deploy-checklist.md
2. **导出为 .skill 文件** Claude 可以将 skill 目录打包为 `.skill` 格式（zip 压缩包），方便分享。 3. **企业内部 Skill 库** 建立标准 Skill 集，统一团队工作流。 --- ## 常见问题 ### Q1: Skill 和 Prompt 有什么区别？ | 特性 | Prompt | Skill | |------|--------|-------| | 持久性 | 单次会话 | 永久保存 | | 复用性 | 需要重复输入 | 一次创建，随时调用 | | 格式化 | 依赖每次描述 | 固化模板 | | 适用场景 | 临时任务 | 重复工作流 | ### Q2: Skill 会影响 Claude 的通用能力吗？ 不会。Skill 只在**明确触发**时生效，不会干扰日常对话。 ### Q3: Skill 可以调用外部 API 吗？ 可以！Skill 可以指示 Claude 使用 bash 工具执行 curl 命令，或编写 Python 脚本调用 API。 ### Q4: 如何调试 Skill？ 1. 先用普通对话测试指令是否清晰 2. 查看 Claude 的执行过程，确认理解正确 3. 逐步细化指令，添加约束条件 --- ## 总结 Claude Skill 的本质是 **可复用的结构化指令**，适合： - ✅ 有固定格式要求的任务 - ✅ 需要多步骤协作的流程 - ✅ 包含领域知识的专业任务 - ✅ 团队需要标准化的工作 **开始使用三步走：** 1. 识别你的重复性任务 2. 定义输出格式和执行步骤 3. 让 Claude 保存为 Skill 现在就试试创建你的第一个 Skill 吧！ --- **相关资源：** - Claude Desktop 官方文档 - Claude Agent SDK - 更多 Skill 示例（欢迎留言交流） --- *本文基于0.075倍率中转：tokenstore.one+Claude Sonnet 4 编写。如有疑问欢迎评论交流。*
Agent 垂直技术社区，欢迎活跃、内容共建。
更多推荐
8
0- 0
已为社区贡献2条内容
所有评论(0)