自定义 Skill 开发概述
自定义 Skill 让你能够将团队特有的工作流程、工具集成和最佳实践封装为可复用的能力模块。
什么情况下需要自定义 Skill？
以下场景适合创建自定义 Skill：
- 重复的工作流程 — 每次都要描述的固定流程（如代码审查检查清单）
- 内部工具集成 — 调用公司内部 API、数据库或服务
- 特定领域知识 — 团队特有的编码规范、架构约定
- 文档模板 — 标准化的 PRD、设计文档、周报格式
- 多步骤操作 — 需要按特定顺序执行的复合操作
Skill 的工作原理
用户输入 "/my-skill"
↓
Claude Code 查找 SKILL.md
↓
加载 Frontmatter (name, description, triggers)
↓
加载 Prompt (领域知识 + 工作流程)
↓
加载 Resources (参考文档、模板)
↓
Claude 以 Skill 模式运行创建 Skill 的步骤
- 确定范围 — 明确 Skill 做什么、不做什么
- 设计触发词 — 选择自然、不易误触的关键词
- 编写 Prompt — 描述工作流程和领域知识
- 准备资源 — 补充参考文档和模板
- 测试验证 — 确保触发准确、输出符合预期
- 迭代优化 — 根据使用反馈调整
Skill 的存放位置
| 位置 | 作用域 | 适合 |
|---|---|---|
项目 .claude/skills/ | 当前项目 | 项目特有的工作流 |
用户 ~/.claude/skills/ | 所有项目 | 通用工具 Skill |
下一步
- Skill 文件结构 — 了解 SKILL.md 的组成
- Frontmatter 配置 — 学习元数据配置
- Prompt 设计 — 编写高效的 Skill Prompt