什么是技能skill,拆开看就四个文件,跟炒盘菜一样

熊猫办公
最近我创建了一个发票报销助手技能,我只要上传发票给它,它就会帮我提取发票代码、发票号码、开票日期、金额(不含税)、税额、价税合计、销售方名称、销售方纳税人识别号、发票类型(专票/普票/电子发票)。
我很好奇,一个技能skill到底由哪些东西构成的?于是,我把它进行了解构。
一个Skill,本质上就是一个文件夹,里面装着你给它的工作说明书。
什么是技能skill,拆开看就四个文件,跟炒盘菜一样
工作说明书里面包含四个文件,分别是:
SKILL.md:技能说明书(工作流)
References:参考文档;
Scripts:可执行代码;
Assets:输出模板。
看着很复杂,我换个说法你就懂了——咱们拿”西红柿炒蛋”打个比方。
SKILL.md:就是那张菜谱
你进厨房之前,得先知道先炒蛋还是先炒西红柿、火开多大、什么时候加盐。SKILL.md干的就这个活儿——它是技能说明书,把整个工作流程一步一步写清楚。
比如发票助手里,它会写:第一步接收发票文件,第二步调用识别脚本,第三步按模板输出。没有它,后面的东西就是一堆散装零件,谁也不知道先干啥后干啥。
References:相当于你手边的”食材百科”
炒西红柿炒蛋,你得知道西红柿啥时候算熟、鸡蛋打散要顺一个方向、糖放多少能提鲜。这些”背景知识”都放在References里——它是参考文档。
发票这事儿也有讲究啊:专票和普票的字段不一样,电子发票的版式和纸质的又不同。References就负责把这些规则、样例、边界情况都存好,让脚本干活的时候有底可依,不至于碰见张陌生的发票就懵。
Scripts:真正动手开火的那个人
菜谱看了,知识也有了,最后谁把菜炒出来的?是你,以及你手里的锅铲。Scripts就是那个”动手的人”——它是真正能跑起来的可执行代码。
发票助手的Scripts,负责把图片/PDF读进去、把字识别出来、把字段一个个摘出来。SKILL.md说”去识别”,References说”这么识别才对”,Scripts才是真的把这件事干完的那一环。
Assets:装盘的样子
菜炒好了,总不能连锅端上去吧?得盛到盘子里,摆得好看点。Assets就是输出模板——它规定最终给你的结果长啥样。
发票助手跑完,弹出来的不是一堆乱糟糟的文字,而是一张规整的提取结果:发票代码、号码、金额、税额、价税合计……一行一行排得明明白白,你直接复制就能填进报销系统。
串起来看一遍
你扔一张发票进去 → SKILL.md说”按这个流程走” → References告诉它”这种发票长这样、字段这么取” → Scripts真去把信息抠出来 → Assets把结果收拾成你能直接用的样子。
四个文件,一个管”怎么干”,一个管”懂点啥”,一个管”动手干”,一个管”长得好看”。缺哪个,这盘菜都端不上桌。
其中,最重要的是SKILL.md文档,它包含元信息(name名字和descrition描述)和指令,它长这样:
什么是技能skill,拆开看就四个文件,跟炒盘菜一样
其实就是把”说清楚流程、备好资料、写段能跑的程序、定个好看的输出”四件事分开放,谁都不挤谁。下次你再瞅见哪个AI技能,也能一眼看穿它肚子里到底装了啥。
<mp-common-profile class="custom_select_card mp_profile_iframe mp_common_widget" data-pluginname="mpprofile"

© 版权声明

相关文章