1. 引言在 AI 编程与智能体Agent快速发展的今天我们经常听到一个词——Skill。它到底是什么为什么大家都在讨论它它和 Plugin、Tool、Workflow 又有什么区别简单来说Skill 是一种可复用的能力封装。它把一段特定的知识、流程或操作步骤打包成一个独立单元让 AI 模型能够按需调用从而完成某个具体任务。你可以把它理解为「给 AI 装上一个专业技能包」。本文将从零开始用通俗的语言解释 Skill 的核心概念并手把手带你编写一个简单但真正有用的 Skill让你快速上手。2. 什么是 Skill2.1 一个直观的比喻想象你是一位刚入职的实习生。老板交给你一个任务「把这份 PDF 里的表格提取成 Excel」。你一开始可能不知道怎么做但如果有人给你一份操作手册里面详细写了用什么工具打开 PDF如何识别表格区域如何导出为 Excel遇到扫描件时先做 OCR。这份「操作手册」就是一个 Skill。AI 模型本身是那个实习生Skill 就是那份手册——它让模型在面对特定任务时不需要从零摸索而是直接按照手册里的步骤高效执行。2.2 Skill 的组成一个典型的 Skill 通常包含以下几个部分组成部分作用类比名称与描述告诉模型「这个 Skill 是干什么的、什么时候该用」手册封面指令Instructions详细的执行步骤和规则手册正文示例Examples输入输出示例帮助模型理解手册中的案例资源文件可选脚本、模板、参考文档等手册附带的工具包2.3 Skill 与 Plugin、Tool 的区别很多初学者容易混淆这几个概念这里用一个表格帮你理清概念核心特点举例Skill教模型「怎么做」——知识、流程、方法论如何写周报、如何做代码审查Tool给模型「能做什么」——可执行的外部能力调用搜索引擎、执行 Python 代码Plugin一组 Tool Skill 的打包集成通常带 UI一个能查天气、订机票的插件简单记忆Skill 是「软技能」Tool 是「硬工具」Plugin 是「工具箱」。3. 为什么需要 Skill3.1 让 AI 更专业没有 Skill 的模型就像一个什么都知道一点但都不精通的「通才」。有了 Skill它就能在特定领域表现得像「专家」。比如你写一个「Python 代码审查 Skill」模型就会按照你定义的规范去检查代码质量、安全性、性能等。3.2 让知识可复用你不需要每次对话都重新教模型一遍流程。把流程写成 Skill 后一次编写、处处复用。团队之间还可以共享 Skill沉淀集体智慧。3.3 让复杂任务可拆解一个复杂的任务往往可以拆成多个子任务每个子任务对应一个 Skill。模型可以像流水线一样依次调用不同的 Skill最终完成整体目标。4. 手把手写一个「周报生成 Skill」理论讲完了下面我们动手写一个简单但实用的 Skill——自动生成周报。这个 Skill 会教模型如何根据用户提供的零散工作记录整理成一份结构清晰、重点突出的周报。4.1 定义 Skill 的基本信息首先我们需要给 Skill 起一个名字并写清楚它的用途。这部分是给模型看的「说明书」决定了模型在什么场景下会调用它。name:weekly_report_generatordescription:根据用户提供的本周工作记录可以是零散笔记、聊天记录、待办事项等 自动整理生成一份结构清晰、重点突出的周报。适用于每周五下午或周末 需要提交周报的场景。4.2 编写核心指令这是 Skill 的灵魂部分。我们要告诉模型输入是什么、输出是什么、中间要遵循哪些规则。instructions:|你是一位专业的周报撰写助手。请根据用户提供的工作记录生成一份周报。## 输入用户会提供本周的工作内容可能是-零散的待办事项列表-项目进展描述-遇到的问题和解决过程## 输出格式请严格按照以下 Markdown 格式输出### 本周完成-逐条列出本周完成的主要工作每条以动词开头突出成果### 本周进行中-列出尚未完成、仍在推进中的事项### 问题与风险-列出遇到的问题、风险及应对措施如无则写「无」### 下周计划-列出下周的重点工作安排## 规则1. 语言简洁、专业避免口语化表达。 2. 每条工作描述控制在 20 字以内突出关键信息。 3. 如果用户提供的信息不足以填写某个板块写「暂无」。 4. 不要编造用户未提供的信息。4.3 添加示例示例能极大提升模型的理解准确率。我们给 Skill 加上一个完整的输入输出示例。examples:-input:|这周主要在做登录模块的重构把原来的 Session 认证换成了 JWT。 周二的时候修了一个线上 bug用户反馈登录后偶现 500 错误后来发现是 Redis 缓存失效的问题。 下周打算开始做支付模块的对接。output:|### 本周完成 - 完成登录模块重构Session 认证切换为 JWT - 修复线上登录偶现 500 错误Redis 缓存失效导致### 本周进行中-暂无### 问题与风险-Redis 缓存失效导致登录异常已通过增加兜底逻辑解决### 下周计划-启动支付模块对接4.4 组装成完整的 Skill 文件把上面的内容整合到一个文件中就得到了一个完整的 Skill。实际项目中Skill 通常以目录或文件形式存放例如weekly-report-skill/ ├── SKILL.md # 主文件包含名称、描述、指令、示例 └── assets/ # 可选存放辅助资源 └── template.md # 周报模板其中SKILL.md的内容就是我们上面写的 YAML 配置。有些平台还支持在 Skill 中附带脚本文件让 Skill 不仅能「教」模型还能「帮」模型执行具体操作。5. 如何测试与使用你的 Skill5.1 测试写好 Skill 后建议用几组不同的输入来测试信息完整的情况信息零散、需要归纳的情况信息不足的情况验证模型是否会如实写「暂无」而不是编造。5.2 使用在支持 Skill 的 AI 应用或平台中通常只需要把 Skill 文件放入指定目录或在对话中引用该 Skill模型就会在合适的场景自动调用它。例如用户这周我做了 A、B、C 三件事帮我写周报。 模型自动调用 weekly_report_generator Skill好的已为你生成周报如下……6. 进阶让 Skill 更强大6.1 结合 ToolSkill 可以调用 Tool 来增强能力。比如你的周报 Skill 可以结合「日历查询 Tool」自动读取本周的会议记录进一步丰富周报内容。6.2 支持参数化更高级的 Skill 支持参数输入比如让用户指定周报的语言、详略程度、是否包含数据指标等。这样同一个 Skill 可以适配更多场景。6.3 组合多个 Skill复杂任务可以拆解为多个 Skill 的组合。例如「项目周报 Skill」可以由「数据汇总 Skill」「周报生成 Skill」「邮件发送 Tool」组合而成形成一条自动化流水线。7. 总结本文我们解答了「什么是 Skill」这个问题并通过一个「周报生成器」的实战案例带你完整走了一遍 Skill 的编写流程。回顾一下关键点Skill 是可复用的能力封装教模型「怎么做」一个 Skill 包含名称、描述、指令、示例等核心要素Skill 与 Tool、Plugin 有明确区别但可以相互配合编写 Skill 的关键是清晰的指令 充分的示例 反复测试。现在不妨从你日常最重复、最耗时的工作中挑一个试着把它写成你的第一个 Skill 吧 什么是 Skill？手把手带你写一个简单有用的 Skill！
1. 引言在 AI 编程与智能体Agent快速发展的今天我们经常听到一个词——Skill。它到底是什么为什么大家都在讨论它它和 Plugin、Tool、Workflow 又有什么区别简单来说Skill 是一种可复用的能力封装。它把一段特定的知识、流程或操作步骤打包成一个独立单元让 AI 模型能够按需调用从而完成某个具体任务。你可以把它理解为「给 AI 装上一个专业技能包」。本文将从零开始用通俗的语言解释 Skill 的核心概念并手把手带你编写一个简单但真正有用的 Skill让你快速上手。2. 什么是 Skill2.1 一个直观的比喻想象你是一位刚入职的实习生。老板交给你一个任务「把这份 PDF 里的表格提取成 Excel」。你一开始可能不知道怎么做但如果有人给你一份操作手册里面详细写了用什么工具打开 PDF如何识别表格区域如何导出为 Excel遇到扫描件时先做 OCR。这份「操作手册」就是一个 Skill。AI 模型本身是那个实习生Skill 就是那份手册——它让模型在面对特定任务时不需要从零摸索而是直接按照手册里的步骤高效执行。2.2 Skill 的组成一个典型的 Skill 通常包含以下几个部分组成部分作用类比名称与描述告诉模型「这个 Skill 是干什么的、什么时候该用」手册封面指令Instructions详细的执行步骤和规则手册正文示例Examples输入输出示例帮助模型理解手册中的案例资源文件可选脚本、模板、参考文档等手册附带的工具包2.3 Skill 与 Plugin、Tool 的区别很多初学者容易混淆这几个概念这里用一个表格帮你理清概念核心特点举例Skill教模型「怎么做」——知识、流程、方法论如何写周报、如何做代码审查Tool给模型「能做什么」——可执行的外部能力调用搜索引擎、执行 Python 代码Plugin一组 Tool Skill 的打包集成通常带 UI一个能查天气、订机票的插件简单记忆Skill 是「软技能」Tool 是「硬工具」Plugin 是「工具箱」。3. 为什么需要 Skill3.1 让 AI 更专业没有 Skill 的模型就像一个什么都知道一点但都不精通的「通才」。有了 Skill它就能在特定领域表现得像「专家」。比如你写一个「Python 代码审查 Skill」模型就会按照你定义的规范去检查代码质量、安全性、性能等。3.2 让知识可复用你不需要每次对话都重新教模型一遍流程。把流程写成 Skill 后一次编写、处处复用。团队之间还可以共享 Skill沉淀集体智慧。3.3 让复杂任务可拆解一个复杂的任务往往可以拆成多个子任务每个子任务对应一个 Skill。模型可以像流水线一样依次调用不同的 Skill最终完成整体目标。4. 手把手写一个「周报生成 Skill」理论讲完了下面我们动手写一个简单但实用的 Skill——自动生成周报。这个 Skill 会教模型如何根据用户提供的零散工作记录整理成一份结构清晰、重点突出的周报。4.1 定义 Skill 的基本信息首先我们需要给 Skill 起一个名字并写清楚它的用途。这部分是给模型看的「说明书」决定了模型在什么场景下会调用它。name:weekly_report_generatordescription:根据用户提供的本周工作记录可以是零散笔记、聊天记录、待办事项等 自动整理生成一份结构清晰、重点突出的周报。适用于每周五下午或周末 需要提交周报的场景。4.2 编写核心指令这是 Skill 的灵魂部分。我们要告诉模型输入是什么、输出是什么、中间要遵循哪些规则。instructions:|你是一位专业的周报撰写助手。请根据用户提供的工作记录生成一份周报。## 输入用户会提供本周的工作内容可能是-零散的待办事项列表-项目进展描述-遇到的问题和解决过程## 输出格式请严格按照以下 Markdown 格式输出### 本周完成-逐条列出本周完成的主要工作每条以动词开头突出成果### 本周进行中-列出尚未完成、仍在推进中的事项### 问题与风险-列出遇到的问题、风险及应对措施如无则写「无」### 下周计划-列出下周的重点工作安排## 规则1. 语言简洁、专业避免口语化表达。 2. 每条工作描述控制在 20 字以内突出关键信息。 3. 如果用户提供的信息不足以填写某个板块写「暂无」。 4. 不要编造用户未提供的信息。4.3 添加示例示例能极大提升模型的理解准确率。我们给 Skill 加上一个完整的输入输出示例。examples:-input:|这周主要在做登录模块的重构把原来的 Session 认证换成了 JWT。 周二的时候修了一个线上 bug用户反馈登录后偶现 500 错误后来发现是 Redis 缓存失效的问题。 下周打算开始做支付模块的对接。output:|### 本周完成 - 完成登录模块重构Session 认证切换为 JWT - 修复线上登录偶现 500 错误Redis 缓存失效导致### 本周进行中-暂无### 问题与风险-Redis 缓存失效导致登录异常已通过增加兜底逻辑解决### 下周计划-启动支付模块对接4.4 组装成完整的 Skill 文件把上面的内容整合到一个文件中就得到了一个完整的 Skill。实际项目中Skill 通常以目录或文件形式存放例如weekly-report-skill/ ├── SKILL.md # 主文件包含名称、描述、指令、示例 └── assets/ # 可选存放辅助资源 └── template.md # 周报模板其中SKILL.md的内容就是我们上面写的 YAML 配置。有些平台还支持在 Skill 中附带脚本文件让 Skill 不仅能「教」模型还能「帮」模型执行具体操作。5. 如何测试与使用你的 Skill5.1 测试写好 Skill 后建议用几组不同的输入来测试信息完整的情况信息零散、需要归纳的情况信息不足的情况验证模型是否会如实写「暂无」而不是编造。5.2 使用在支持 Skill 的 AI 应用或平台中通常只需要把 Skill 文件放入指定目录或在对话中引用该 Skill模型就会在合适的场景自动调用它。例如用户这周我做了 A、B、C 三件事帮我写周报。 模型自动调用 weekly_report_generator Skill好的已为你生成周报如下……6. 进阶让 Skill 更强大6.1 结合 ToolSkill 可以调用 Tool 来增强能力。比如你的周报 Skill 可以结合「日历查询 Tool」自动读取本周的会议记录进一步丰富周报内容。6.2 支持参数化更高级的 Skill 支持参数输入比如让用户指定周报的语言、详略程度、是否包含数据指标等。这样同一个 Skill 可以适配更多场景。6.3 组合多个 Skill复杂任务可以拆解为多个 Skill 的组合。例如「项目周报 Skill」可以由「数据汇总 Skill」「周报生成 Skill」「邮件发送 Tool」组合而成形成一条自动化流水线。7. 总结本文我们解答了「什么是 Skill」这个问题并通过一个「周报生成器」的实战案例带你完整走了一遍 Skill 的编写流程。回顾一下关键点Skill 是可复用的能力封装教模型「怎么做」一个 Skill 包含名称、描述、指令、示例等核心要素Skill 与 Tool、Plugin 有明确区别但可以相互配合编写 Skill 的关键是清晰的指令 充分的示例 反复测试。现在不妨从你日常最重复、最耗时的工作中挑一个试着把它写成你的第一个 Skill 吧