Skills系列-1:了解原理和在AI编程工具中配置过程
·
Claude Skills到底什么?
Skills其实就是工具和流程的一个抽象,抽象的产物就是标准格式的文件夹,该文件夹里面有定义工具的名称,使用场景,工具的定义,调用说明
官方Skill的源码示例。
官方地址: https://github.com/anthropics/skills
基本使用示例

skills构成

- SKILL.md :核心文件,必须存在。里面用YAML写元数据(名字、描述),用Markdown写详细的指令,告诉Claude在什么情况下、以及如何使用这个Skill。
- scripts/ :存放可执行的Python、Shell脚本。比如PDF处理Skill里,就有fill_fillable_fields.py这种确定性极强的代码。
- references/ :存放参考文档。比如API文档、数据库Schema、公司政策等,这些是给Claude看的知识库。
- assets/ :存放资源文件。比如PPT模板、公司Logo、React项目脚手架等,这些是Claude在执行任务时直接使用的文件,而不是阅读的。
因此一个技能(Stills)里面其实解构完之后,就是:
- 任务说明书: SKILL.md
- 工具代码(技能执行代码): scripts/*
- 专业知识: references/*
- 素材资源: assets/*
官方与高质量社区 Skill,几种固定的“骨架模式”:
| 类型 | 结构 | 适用场景 |
| Workflow-based(流程型) | Overview → Workflow decision tree → Step 1 → Step 2… | 适合「有固定顺序」的任务(比如 DOCX Skill 的"先决定是读/写/编辑,再按步骤走") |
| Task-based(任务菜单型) | Overview → Quick start → Task 1 → Task 2… | 适合「同一领域多种操作」的 Skill(比如 PDF:提取文本 / 合并 / 拆分 / 表格识别…) |
| Reference / Guidelines(规范型) | Overview → Guidelines → Specifications → Usage… | 用来固化「品牌规范、写作规范、代码风格」这类标准 |
| Capabilities-based(能力清单型) | Overview → Core capabilities → 1,2,3… | 用于"产品管理 / 数据分析"这类综合性系统能力 |
skills加载过程

- 题图识别:元数据(Name + Description)。这部分信息非常简短,会常驻在Claude的脑海里,Claude只需记住每个Skill的元数据,包括:名称+描述,大概占几十个Token
- 加载skills.md:SKILL.md。当你的请求匹配某个Skill的描述时,Claude才会加载完整的指令和脚本
- 调用外部工具:脚本和参考文档。只有当SKILL.md里的指令明确要求,或者Claude在执行中判断需要时,它才会去读取scripts/里的代码或references/里的文档。这步的上下文消耗是按需的,避免了一次性把所有东西都塞进去。
skills, mcp, prompt 区别
|
层级 |
解决的问题 |
是否执行代码 |
是否接触外部系统 |
|---|---|---|---|
|
Prompt |
怎么想、怎么决策 |
❌ |
❌ |
|
Skill |
我会什么 |
✅ |
✅(通过 MCP) |
|
MCP |
怎么安全调用 |
✅ |
✅ |

🧠 Prompt 层(为什么 & 怎么想)
- 决定是否调用工具
- 决定调用哪个 Skill
- 决定失败时如何兜底
- 不直接执行任何真实动作
🧰 Skill 层(我会什么)
- 封装好的、可复用的领域能力
- 明确输入 / 输出
- 不关心策略,只负责把事做好
🔌 MCP 层(怎么安全地做)
- Skill 与外部世界的桥梁
- 负责调用、权限、沙箱、返回
- 保证模型“能用但不越权”
如何在AI编程工具中使用Skills
trae
方式1:去github下载skills,压缩直接导入

方式2:自定义skills

方式3:让AI帮我们自己写一个skills

antigravity
文档说明: https://antigravity.google/docs/skills
技能所在
反重力支持两种技能:
|
位置 |
范围 |
|---|---|
|
<workspace-root>/.agent/skills/<skill-folder>/ |
工作区专用 |
|
~/.gemini/antigravity/skills/<skill-folder>/ |
全局(所有工作区) |
- 工作区专用

- 在某个技能目录里为你的技能创建一个文件夹
- 在那个文件夹里添加 一个 SKILL.md 文件
.agent/skills/
└─── my-skill/
└─── SKILL.md
2.全局(所有工作区)


claude
项目级别:

全局:

使用其实都一样,先掌握怎么配置和使用,在哪里找好用的skills,这是初期需要理解的就行
skills案例
更多推荐


所有评论(0)