创建 Skill
把你的工作流程固化成可复用的 Skill。
什么时候该自己写
先问自己 3 个问题：
- 这个流程我重复做了 3 次以上吗？
- 每次做的步骤基本一样吗？
- 现有的 Skill 都不能满足吗？
如果 3 个都是"是"，那就值得写成 Skill。
最简单的开始方式
方法 1：让 AI 帮你写
# 先装 skill-creator
npx skills add anthropics/skills/skill-creator然后直接对话：
我想创建一个 skill，用来：
[描述你的流程]
每次的步骤是：
1. [步骤 1]
2. [步骤 2]
3. [步骤 3]
请帮我生成一个 SKILL.md方法 2：从模板开始
最简单的 SKILL.md 结构：
---
name: my-workflow
description: |
[描述这个 Skill 做什么]
触发条件：当用户提到 [关键词] 时使用
---
# [Skill 名称]
## 使用场景
[什么时候用这个 Skill]
## 执行步骤
### 1. [第一步]
- [具体要做什么]
- [注意事项]
### 2. [第二步]
- [具体要做什么]
- [注意事项]
### 3. [第三步]
- [具体要做什么]
- [输出格式]
## 示例
输入：
[示例输入]
输出：
[示例输出]Skill 的解剖学
必需部分：SKILL.md
---
name: code-reviewer # 唯一 ID（小写，用连字符）
description: | # 触发条件（最重要！）
审查代码是否符合团队规范。
使用场景：用户请求 review 代码、提交 PR 前、或提到"代码审查"时。
---
# Code Review Skill
[主体内容：详细的执行步骤]description 是关键：
- 要写清楚什么时候触发
- 包含相关的关键词
- 说明适用场景
可选部分：scripts/
如果有确定性的任务（格式化、计算、API 调用），写成脚本：
my-skill/
├── SKILL.md
└── scripts/
├── format.py # Python 脚本
├── upload.js # Node.js 脚本
└── check.sh # Bash 脚本为什么用脚本？
- 执行结果准确、稳定
- 不消耗推理 Token
- 可以复用现有工具
可选部分：references/
复杂的参考文档放这里：
my-skill/
├── SKILL.md # 核心流程（< 500 行）
└── references/
├── guide.md # 详细指南
├── examples.md # 更多示例
└── edge-cases.md # 边缘情况处理渐进式披露原则：
SKILL.md只写核心流程- 复杂的细节放
references/ - AI 只在需要时才读 references
可选部分：assets/
模板、配置文件放这里：
my-skill/
├── SKILL.md
└── assets/
├── template.json # 输出模板
├── config.yaml # 配置文件
└── style.css # 样式文件写好 Skill 的 3 个技巧
1. 先手工跑通一次
不要直接写 Skill，先这样做：
- 手工完成一次完整流程
- 记录每一步做了什么
- 记录遇到的问题和解决方法
- 整理成标准化步骤
- 再写成 SKILL.md
2. 脚本优于提示词
能写脚本就别写提示词：
❌ 不好的方式：
## 格式化 JSON
请将 JSON 格式化，确保：
- 缩进为 2 个空格
- 键名按字母排序
- 删除空值✅ 好的方式：
## 格式化 JSON
运行脚本：
`python scripts/format_json.py input.json`3. 提供清晰的示例
好的示例包含：
- 典型的输入
- 预期的输出
- 边缘情况的处理
## 示例
### 典型场景
输入：[...]
输出：[...]
### 边缘情况：空数据
输入：[]
输出：提示"没有数据可处理"
### 边缘情况：格式错误
输入：[错误格式]
输出：提示"格式错误，请检查：[具体问题]"实战案例
案例 1：文章多平台适配
需求： 一篇文章要发到公众号、小红书、知乎，每个平台格式不同。
手工流程：
- 调整标题（小红书要加 emoji，知乎要更正式）
- 调整正文（公众号要加引导关注，小红书要分段）
- 调整配图（不同平台尺寸不同）
- 生成摘要（不同平台字数限制不同）
固化成 Skill：
---
name: multi-platform-adapter
description: |
将文章适配到不同平台（公众号、小红书、知乎）。
触发条件：用户提到"多平台发布"、"适配"、"转换格式"时。
---
# 多平台内容适配
## 执行步骤
### 1. 识别目标平台
询问用户要发布到哪些平台（可多选）：
- 公众号
- 小红书
- 知乎
### 2. 按平台调整
#### 公众号版本
- 标题：保持原标题
- 正文：
- 开头加引导语
- 结尾加关注引导
- 保持段落完整
- 配图：16:9 横图
- 摘要：120 字以内
#### 小红书版本
- 标题：添加相关 emoji
- 正文：
- 每段不超过 3 行
- 多用换行增加可读性
- 关键词加 # 标签
- 配图：3:4 竖图
- 摘要：80 字以内，口语化
#### 知乎版本
- 标题：更正式，突出专业性
- 正文：
- 保持完整段落
- 添加小标题
- 适当添加数据支撑
- 配图：16:9 横图
- 摘要：150 字以内
### 3. 输出格式
为每个平台生成独立文件：
- `wechat.md`
- `xiaohongshu.md`
- `zhihu.md`
## 示例
[提供具体示例]案例 2：代码发布前检查
需求： 每次发布前都要检查一遍：测试、文档、版本号、changelog。
固化成 Skill：
---
name: release-checklist
description: |
发布前的完整检查清单。
触发条件：用户提到"发布"、"上线"、"release"时。
---
# 发布前检查清单
## 执行步骤
### 1. 代码检查
- [ ] 所有测试通过
- [ ] 代码已 review
- [ ] 没有 TODO 或 FIXME
- [ ] 没有 console.log 或调试代码
### 2. 文档检查
- [ ] README 已更新
- [ ] CHANGELOG 已更新
- [ ] API 文档已更新
- [ ] 版本号已更新
### 3. 依赖检查
- [ ] 依赖版本已锁定
- [ ] 没有安全漏洞
- [ ] 许可证兼容
### 4. 配置检查
- [ ] 环境变量已配置
- [ ] 生产配置已确认
- [ ] 备份策略已确认
### 5. 回滚准备
- [ ] 回滚方案已准备
- [ ] 数据库迁移可回滚
- [ ] 监控已配置
## 输出
生成检查报告：
- ✅ 已完成的项目
- ❌ 未完成的项目
- ⚠️ 需要注意的项目
如果有未完成项，询问是否继续发布。测试和优化
测试 Skill
-
用真实数据测试
- 不要只用理想情况
- 测试边缘情况
- 测试错误输入
-
多次测试
- 至少测试 3 次
- 看结果是否稳定
- 记录不符合预期的地方
-
让别人测试
- 给团队成员用
- 收集反馈
- 持续改进
优化 Skill
常见问题和解决方法：
| 问题 | 原因 | 解决方法 |
|---|---|---|
| Skill 没被触发 | description 不够明确 | 增加更多触发关键词 |
| 输出不稳定 | 步骤描述模糊 | 提供更详细的步骤和示例 |
| 执行太慢 | 提示词太长 | 把细节移到 references/ |
| 结果不准确 | 应该用脚本的地方用了提示词 | 改用脚本实现 |
分享你的 Skill
发布到 GitHub
# 1. 创建仓库
mkdir my-skill
cd my-skill
git init
# 2. 添加文件
# SKILL.md
# README.md（使用说明）
# LICENSE
# 3. 推送到 GitHub
git add .
git commit -m "Initial commit"
git remote add origin <your-repo-url>
git push -u origin main提交到商店
- skills.sh - 提交 PR 到 Vercel Labs
- ClawHub - 注册并上传
- Anthropic 官方 - 提交高质量 Skill
写使用文档
好的 README 包含：
- 这个 Skill 解决什么问题
- 如何安装
- 如何使用（带示例）
- 常见问题
- 贡献指南
进阶话题
Skill 组合
多个 Skill 可以组合使用：
---
name: content-workflow
description: |
完整的内容创作工作流。
触发条件：用户提到"内容创作流程"时。
---
# 内容创作工作流
## 执行步骤
### 1. 写作
使用 `writing-assistant` skill
### 2. 编辑
使用 `editor` skill
### 3. 多平台适配
使用 `multi-platform-adapter` skill
### 4. 发布检查
使用 `publish-checklist` skill团队 Skill 库
建立团队共享的 Skill 库：
team-skills/
├── code-standards/ # 代码规范
├── doc-templates/ # 文档模板
├── release-process/ # 发布流程
└── onboarding/ # 新人入职