文章目录前言1. 先上干货去哪薅现成的Skill2. 标准范式写Skill的规矩先讲明白2.1 一个Skill文件夹的基本构成2.2 元数据Skill的“相亲简历”2.3 正文指令给AI写的工作SOP3. 实操环节手把手搓一个Skill3.1 手动创建从零开始搭3.2 自动创建用Skill生Skill4. 写好的Skill怎么装两种安装方式4.1 全局安装走到哪用到哪4.2 项目级安装专属定制互不干扰5. 扯点原理Skill为啥这么设计P.S. 挖到宝藏AI教程全程通俗易懂风趣幽默零基础轻松入门 传送门https://blog.csdn.net/qq_34419312前言我发现很多人现在张口闭口Skill用得挺溜但真让他自己写一个直接卡壳。就跟天天点外卖的人你让他进厨房炒个菜他连油和酱油都分不清楚。光会用不会写本质还是个消费者主动权永远在别人手里。今天咱就从薅现成的开始到手把手搓一个再到背后的原理一次性给你唠明白。1. 先上干货去哪薅现成的Skill别一上来就喊着要自己写没必要。就像学做饭先从加热预制菜开始现成的Skill一大堆够你先用半年。我整理了一波靠谱的渠道收藏夹先吃灰为敬。官方渠道首推anthropic的官方仓库根正苗红质量兜底踩坑概率最低。社群类的比如Skills社群网站、Skillstore相当于AI界的应用商店啥花活都有做视频的、剪油管的、发社交平台的只有你想不到没有人家做不到。还有各路大佬整理的精选合集比如ComposioHQ、JackyST0的仓库相当于帮你筛过一遍的好物清单省得你自己大海捞针。最狠的是agent‑skills.md里面塞了六千多个技能相当于给你一本AI武功秘籍大全翻都能翻半天。别问哪个最好用问就是先存着。囤技能总比囤口罩有用对吧。2. 标准范式写Skill的规矩先讲明白薅完现成的咱再说说自己写的规矩。别觉得写Skill是什么高深技术活本质就是给AI写一份岗位说明书操作手册。你把规矩说死了它干活就不会跑偏。2.1 一个Skill文件夹的基本构成先说结构一个标准Skill文件夹核心就一个必须文件剩下的都是配菜。SKILL.md是主心骨必须有。剩下的scripts、references、assets都是可选的。scripts放可执行脚本就是让AI直接跑的代码干确定性的活references放参考文档相当于给它备的工具书assets放模板资源比如报表模板、PPT模板之类的。说白了就是说明书工具参考书模板一套齐活。2.2 元数据Skill的“相亲简历”SKILL.md分两部分前面的元数据后面的正文指令。先讲元数据这玩意是核心中的核心相当于你的相亲简历。Agent扫一眼就知道你这个Skill是干嘛的该不该叫你上场。最关键的两个字段name和description。name必须和文件夹名一模一样就像身份证名字得和工牌一致不然系统认不出你。只能小写字母、数字和连字符别整花里胡哨的 emoji 或者中文。description是重中之重一两句话说清楚功能、场景、触发条件。我见过太多人写这个上来就“一款强大的效率工具”废话不强大谁用它就像外卖店名叫“好吃的饭”谁知道你卖啥的你得写“黄焖鸡米饭 20分钟送到”人家才知道该不该点你。剩下的version、author、allowed‑tools这些都是可选的相当于简历上的兴趣爱好有了更丰满没有也不耽误入职。2.3 正文指令给AI写的工作SOP正文部分就是给AI写的完整工作流程。别写散文就用命令式语气一步一步说清楚。我给你们拆成固定模块照着填就不会出大错。第一个角色定义。先给AI焊死人设比如“你是资深软件测试工程师”“你是专业财务审计员”身份定了它才不会乱跑题。第二个核心指令与步骤。这是主体把任务拆成123步啥情况该干啥啥时候调用脚本啥时候查文档都写明白。就像给新员工写的操作手册越细越不容易翻车。第三个输出规范。最终要输出啥格式分几个部分用不用表格代码要不要加注释都规定死。不然AI放飞自我给你整出一篇抒情散文你哭都没地方哭。第四个示例。给个输入输出的例子相当于给它打个样。这招特别好使比你说十句“要专业”都管用。第五个资源引用。告诉它啥时候读参考文档啥时候用模板文件别放一堆资源在那它假装看不见。3. 实操环节手把手搓一个Skill规矩讲完了上手干。分两种玩法手动版和自动版丰俭由人。3.1 手动创建从零开始搭手动版适合想搞懂原理的同学虽然麻烦点但做完一遍你就通透了。第一步建个文件夹名字按规矩来小写加连字符比如testcase‑creator。第二步建SKILL.md文件先写元数据name必须和文件夹名对齐description写清楚功能和触发场景。第三步写正文指令就按刚才说的五个模块往里填把步骤、规则、输出格式都写明白。第四步把需要的脚本、参考文档、模板资源对应放进scripts、references、assets文件夹里。完事一个纯手工打造的Skill就出炉了主打一个原汁原味。3.2 自动创建用Skill生Skill懒人福音来了。既然Skill是给AI用的那能不能让AI自己写Skill当然可以。官方早就想到了出了个专门用来创建Skill的Skill叫skill‑creator。操作特别简单先把官方的skill‑creator下载下来装到你的Agent里。然后直接跟它说你的需求比如“给我做一个生成测试用例的Skill”它就自己给你搓出来了。相当于你招了个HR让它帮你招员工你只需要说要啥岗位、干啥活就行。主打一个能用机器干的绝对不自己动手。4. 写好的Skill怎么装两种安装方式Skill写好了总得装到Agent里才能用吧分两种安装模式全局和项目级。4.1 全局安装走到哪用到哪全局安装就是把Skill放到Agent的全局技能目录里。好处是不管你开哪个项目这个Skill都能用相当于给你电脑装了个通用软件开机就有。不同的Agent工具全局目录不一样给你们列几个常用的Claude Code~/.claude/skills/Cursor~/.cursor/skills/OpenCode~/.config/opencode/skills/Windsurf~/.windsurf/skills/把Skill文件夹丢进去重启Agent就加载上了。4.2 项目级安装专属定制互不干扰项目级安装就是只在当前项目里能用别的项目不影响。适合那种项目专属的技能比如某个项目特有的代码规范检查没必要全局装省得别的项目跟着乱。操作也简单在项目根目录建对应工具的文件夹比如OpenCode就建.opencode/skills/把Skill丢进去就行。相当于给这个项目单独装了个插件干净卫生互不串味。5. 扯点原理Skill为啥这么设计最后唠点干的Skill背后的核心逻辑叫“渐进式披露”。听着挺玄乎其实道理特别简单。你想啊要是把所有Skill的内容都塞给AI那它的上下文直接炸了。就像你脑子里同时装着语文数学英语物理化学考试的时候反而啥都想不起来纯纯内存溢出。渐进式披露就是按需加载。平时只放个名片在外面就写个名字和一句话介绍占不了多少地方。等用户提了需求匹配上对应的Skill了再把完整的指令、步骤、资源加载进来。相当于用到哪个专家就把哪个专家请过来不用一屋子专家都坐着待命费钱还费地方。拆成三层就更好理解了第一层元数据层负责识别触发。就像医院的导诊台先问你啥症状给你分到对应的科室效率拉满。第二层指令层负责思考规划。科室医生接诊了按专业流程给你问诊、开检查单一套标准SOP比你自己瞎琢磨靠谱多了。第三层资源层负责执行校验。该做检查开药方直接调用对应的设备和药典准确又高效不容易出错。说白了Skill就是把提示工程给标准化、封装化了。别光收藏不用也别光用不写。自己动手写两个你对Agent的理解直接上一个台阶。P.S. 挖到宝藏AI教程全程通俗易懂风趣幽默零基础轻松入门传送门https://blog.csdn.net/qq_34419312 从零吃透AI Skill：从薅资源到手写部署，保姆级全教程
文章目录前言1. 先上干货去哪薅现成的Skill2. 标准范式写Skill的规矩先讲明白2.1 一个Skill文件夹的基本构成2.2 元数据Skill的“相亲简历”2.3 正文指令给AI写的工作SOP3. 实操环节手把手搓一个Skill3.1 手动创建从零开始搭3.2 自动创建用Skill生Skill4. 写好的Skill怎么装两种安装方式4.1 全局安装走到哪用到哪4.2 项目级安装专属定制互不干扰5. 扯点原理Skill为啥这么设计P.S. 挖到宝藏AI教程全程通俗易懂风趣幽默零基础轻松入门 传送门https://blog.csdn.net/qq_34419312前言我发现很多人现在张口闭口Skill用得挺溜但真让他自己写一个直接卡壳。就跟天天点外卖的人你让他进厨房炒个菜他连油和酱油都分不清楚。光会用不会写本质还是个消费者主动权永远在别人手里。今天咱就从薅现成的开始到手把手搓一个再到背后的原理一次性给你唠明白。1. 先上干货去哪薅现成的Skill别一上来就喊着要自己写没必要。就像学做饭先从加热预制菜开始现成的Skill一大堆够你先用半年。我整理了一波靠谱的渠道收藏夹先吃灰为敬。官方渠道首推anthropic的官方仓库根正苗红质量兜底踩坑概率最低。社群类的比如Skills社群网站、Skillstore相当于AI界的应用商店啥花活都有做视频的、剪油管的、发社交平台的只有你想不到没有人家做不到。还有各路大佬整理的精选合集比如ComposioHQ、JackyST0的仓库相当于帮你筛过一遍的好物清单省得你自己大海捞针。最狠的是agent‑skills.md里面塞了六千多个技能相当于给你一本AI武功秘籍大全翻都能翻半天。别问哪个最好用问就是先存着。囤技能总比囤口罩有用对吧。2. 标准范式写Skill的规矩先讲明白薅完现成的咱再说说自己写的规矩。别觉得写Skill是什么高深技术活本质就是给AI写一份岗位说明书操作手册。你把规矩说死了它干活就不会跑偏。2.1 一个Skill文件夹的基本构成先说结构一个标准Skill文件夹核心就一个必须文件剩下的都是配菜。SKILL.md是主心骨必须有。剩下的scripts、references、assets都是可选的。scripts放可执行脚本就是让AI直接跑的代码干确定性的活references放参考文档相当于给它备的工具书assets放模板资源比如报表模板、PPT模板之类的。说白了就是说明书工具参考书模板一套齐活。2.2 元数据Skill的“相亲简历”SKILL.md分两部分前面的元数据后面的正文指令。先讲元数据这玩意是核心中的核心相当于你的相亲简历。Agent扫一眼就知道你这个Skill是干嘛的该不该叫你上场。最关键的两个字段name和description。name必须和文件夹名一模一样就像身份证名字得和工牌一致不然系统认不出你。只能小写字母、数字和连字符别整花里胡哨的 emoji 或者中文。description是重中之重一两句话说清楚功能、场景、触发条件。我见过太多人写这个上来就“一款强大的效率工具”废话不强大谁用它就像外卖店名叫“好吃的饭”谁知道你卖啥的你得写“黄焖鸡米饭 20分钟送到”人家才知道该不该点你。剩下的version、author、allowed‑tools这些都是可选的相当于简历上的兴趣爱好有了更丰满没有也不耽误入职。2.3 正文指令给AI写的工作SOP正文部分就是给AI写的完整工作流程。别写散文就用命令式语气一步一步说清楚。我给你们拆成固定模块照着填就不会出大错。第一个角色定义。先给AI焊死人设比如“你是资深软件测试工程师”“你是专业财务审计员”身份定了它才不会乱跑题。第二个核心指令与步骤。这是主体把任务拆成123步啥情况该干啥啥时候调用脚本啥时候查文档都写明白。就像给新员工写的操作手册越细越不容易翻车。第三个输出规范。最终要输出啥格式分几个部分用不用表格代码要不要加注释都规定死。不然AI放飞自我给你整出一篇抒情散文你哭都没地方哭。第四个示例。给个输入输出的例子相当于给它打个样。这招特别好使比你说十句“要专业”都管用。第五个资源引用。告诉它啥时候读参考文档啥时候用模板文件别放一堆资源在那它假装看不见。3. 实操环节手把手搓一个Skill规矩讲完了上手干。分两种玩法手动版和自动版丰俭由人。3.1 手动创建从零开始搭手动版适合想搞懂原理的同学虽然麻烦点但做完一遍你就通透了。第一步建个文件夹名字按规矩来小写加连字符比如testcase‑creator。第二步建SKILL.md文件先写元数据name必须和文件夹名对齐description写清楚功能和触发场景。第三步写正文指令就按刚才说的五个模块往里填把步骤、规则、输出格式都写明白。第四步把需要的脚本、参考文档、模板资源对应放进scripts、references、assets文件夹里。完事一个纯手工打造的Skill就出炉了主打一个原汁原味。3.2 自动创建用Skill生Skill懒人福音来了。既然Skill是给AI用的那能不能让AI自己写Skill当然可以。官方早就想到了出了个专门用来创建Skill的Skill叫skill‑creator。操作特别简单先把官方的skill‑creator下载下来装到你的Agent里。然后直接跟它说你的需求比如“给我做一个生成测试用例的Skill”它就自己给你搓出来了。相当于你招了个HR让它帮你招员工你只需要说要啥岗位、干啥活就行。主打一个能用机器干的绝对不自己动手。4. 写好的Skill怎么装两种安装方式Skill写好了总得装到Agent里才能用吧分两种安装模式全局和项目级。4.1 全局安装走到哪用到哪全局安装就是把Skill放到Agent的全局技能目录里。好处是不管你开哪个项目这个Skill都能用相当于给你电脑装了个通用软件开机就有。不同的Agent工具全局目录不一样给你们列几个常用的Claude Code~/.claude/skills/Cursor~/.cursor/skills/OpenCode~/.config/opencode/skills/Windsurf~/.windsurf/skills/把Skill文件夹丢进去重启Agent就加载上了。4.2 项目级安装专属定制互不干扰项目级安装就是只在当前项目里能用别的项目不影响。适合那种项目专属的技能比如某个项目特有的代码规范检查没必要全局装省得别的项目跟着乱。操作也简单在项目根目录建对应工具的文件夹比如OpenCode就建.opencode/skills/把Skill丢进去就行。相当于给这个项目单独装了个插件干净卫生互不串味。5. 扯点原理Skill为啥这么设计最后唠点干的Skill背后的核心逻辑叫“渐进式披露”。听着挺玄乎其实道理特别简单。你想啊要是把所有Skill的内容都塞给AI那它的上下文直接炸了。就像你脑子里同时装着语文数学英语物理化学考试的时候反而啥都想不起来纯纯内存溢出。渐进式披露就是按需加载。平时只放个名片在外面就写个名字和一句话介绍占不了多少地方。等用户提了需求匹配上对应的Skill了再把完整的指令、步骤、资源加载进来。相当于用到哪个专家就把哪个专家请过来不用一屋子专家都坐着待命费钱还费地方。拆成三层就更好理解了第一层元数据层负责识别触发。就像医院的导诊台先问你啥症状给你分到对应的科室效率拉满。第二层指令层负责思考规划。科室医生接诊了按专业流程给你问诊、开检查单一套标准SOP比你自己瞎琢磨靠谱多了。第三层资源层负责执行校验。该做检查开药方直接调用对应的设备和药典准确又高效不容易出错。说白了Skill就是把提示工程给标准化、封装化了。别光收藏不用也别光用不写。自己动手写两个你对Agent的理解直接上一个台阶。P.S. 挖到宝藏AI教程全程通俗易懂风趣幽默零基础轻松入门传送门https://blog.csdn.net/qq_34419312