一、Skill 是什么？
我们打个比方来说明
想象一下，你去一家新餐厅当帮厨。
老板（用户）对你说："去把土豆切了。"
你心里肯定一堆问题：切多厚？切条还是切块？切完放哪？
但如果老板递给你一张带图的操作卡，上面写着土豆切配标准
步骤：
洗土豆、土豆去皮
先切成 2 毫米厚的片
再切成 2 毫米宽的丝
泡在水里备用
你照着做，次次都能切出一样标准的土豆丝，你就掌握了切土豆的"技能（Skill）"。
AI Skill的概念？
Skill（技能）是封装好、可被调用、用来完成单一具体任务的功能模块。
通俗理解：大模型本身是 "大脑"，Skill 就是它的一个个专业的工具。
例如：
天气 Skill：查询某地实时天气
闹钟 Skill：设置、取消闹钟
点餐 Skill：下单、查订单
总之你可以根据实际需要编写你想要的任何skill
Skill简单应用流程：
大模型理解用户意图 → 找到匹配对应 Skill → 调用执行对应 Skill → 返回对应 Skill的结果
二、为什么需要 Skill？
1、解决 AI 的"失忆症"
大模型本身是有幻觉的，每次新对话都要从零开始介绍，你在不同时间问同一个问题，它回答的都不一样，效率极低。Skill 可以把这些知识通过指定规则固化下来，让 AI 随时取用并准确地进行回答，避免AI"胡说八道"。
2、解决 Token 浪费问题
早期做法（如把所有背景都写进 Prompt）会导致上下文膨胀------信息太多，AI 反而抓不住重点。Skill 采用渐进式披露机制来化解这个问题：
- 固化流程，保证稳定性
靠 AI 临场发挥，结果时好时坏。Skill 把工作流程（SOP）、最佳实践、检查清单全部写死，每次执行都按同一套标准走，输出质量稳定可控。
三、从零到一：做一个 Skill 的完整步骤
第 1 步：明确你要解决什么问题
例如：我们的需求是输入一个城市，判断它是否为省会
第 2 步：创建 Skill 目录
D:\skills\is-capital
第 3 步：编写 SKILL.md（核心入口文件）
在 D:\skills\is-capital\ 目录下创建 SKILL.md，文件名必须精确为 SKILL.md（文件名必须是大写）
SKILL.md是做skill的灵魂，它是AI执行任务时读取的核心指令文件。我们主要的工作也集中在这里。
当然还需要写一些辅助文件，如scripts/、references/、assets/这些文件夹里的内容是按需加载的（不是做skill必须的内容），只有在AI执行具体步骤时才会被调用，这些我们本次先不讲。
SKILL.md文件的内容如下：
--- name: is-capital description: 判断一个城市是否为省会城市。输入城市名称，返回该城市是否为省会，以及所属省份信息。
省会城市判断技能
功能说明 当用户询问某个城市是否为省会时，查询内置的省会城市数据库，返回判断结果和所属省份。
触发条件
- 用户提到城市名称并询问是否为省会
- 用户输入 "判断 城市名 是否为省会"
- 用户直接输入城市名称并说 "省会？"
核心逻辑
1. 省会城市数据库 以下是完整的中国省会城市列表（按省份排序）：
| 省份 | 省会城市 | |------|----------| | 北京市 | 北京 | | 上海市 | 上海 | | 天津市 | 天津
| | 重庆市 | 重庆 | | 河北省 | 石家庄 | | 山西省 | 太原 | | 辽宁省 | 沈阳 | | 吉林省 | 长春 | |
黑龙江省 | 哈尔滨 | | 江苏省 | 南京 | | 浙江省 | 杭州 | | 安徽省 | 合肥 | | 福建省 | 福州 | | 江西省
| 南昌 | | 山东省 | 济南 | | 河南省 | 郑州 | | 湖北省 | 武汉 | | 湖南省 | 长沙 | | 广东省 | 广州
| | 海南省 | 海口 | | 四川省 | 成都 | | 贵州省 | 贵阳 | | 云南省 | 昆明 | | 陕西省 | 西安 | |
甘肃省 | 兰州 | | 青海省 | 西宁 | | 台湾省 | 台北 | | 内蒙古自治区 | 呼和浩特 | | 广西壮族自治区 | 南宁
| | 西藏自治区 | 拉萨 | | 宁夏回族自治区 | 银川 | | 新疆维吾尔自治区 | 乌鲁木齐 | | 香港特别行政区 | 香港 |
| 澳门特别行政区 | 澳门 |
2. 处理流程
- 接收用户输入的城市名称
- 进行城市名称标准化（处理简称、别名等）
- 在省会数据库中查找
- 返回判断结果
3. 响应格式 如果是省会城市：
第 4 步：部署Skill
skill需要被大模型调用后才能运行，本文想通过DeepSeek来调用skill，因此需要安装和配置Deep Code这个大模型开源 AI 编程智能体框架。
1、安装Deep Code
npm install -g @vegamo/deepcode-cli
2、查找Deep Code的如下目录，新建一个settings.json
C:\Users\你的用户名.deepcode\settings.json
3、修改settings.json
{
"env": {
"MODEL": "deepseek-v4-pro",
"BASE_URL": "https://api.deepseek.com",
"API_KEY": "你的sk-开头密钥"
},
"thinkingEnabled": true,
"reasoningEffort": "max"
}
4、将之前编写的SKILL.md文件放到如下目录
C:\Users\你的用户名.deepcode\skills\is-capital
第 5 步：执行自己编写的Skill
运行命令，启动deepcode，就会自动执行Skill
D:>deepcode
运行结果：
