鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
8
3
6

5分钟带你认识并手搓一个 Skill!

鱼友7295
鱼友7295
2026-08-05 11:21
阅读 1435
鱼友7295
2026-08-05 11:21
阅读 1435

很多人第一次看到 Skill 这个词,都会下意识觉得: “这是不是给程序员用的?” “是不是要会写很多代码?” 但如果我们把它拆开来看,会发现一件很有意思的事: Skill 其实就是把一件你已经会做的事情, 变成一次“可以反复执行、不容易出错的流程”。 这篇文章不要求你有任何技术背景。 我们会一步一步来,慢慢把这件事讲清楚。

一、先别急着谈 Skill,从每天的按步骤做事说起

先暂时把 Skill 这个词放一边。 想一个非常生活化的场景: 你要做一道固定的菜。 第一次做的时候,你可能会一边看菜谱,一边试探着来; 做多了之后,你会发现流程几乎是固定的:

  • 先准备材料
  • 再按顺序处理
  • 最后得到结果

如果你让别人来帮你做,你大概会说:“你就照这个步骤来,别自己发挥。” Skill,本质上就是做这件事。 只是对象从「人」变成了「机器」。

image.png

二、那 Python 是什么?为什么它这么适合“按步骤做事”? 在继续说 Skill 之前,我们先认识一下 Python。 1️⃣ Python 可以理解成什么? 如果一定要用一个生活比喻: Python 更像“把事情写成清单”的语言。

它不是用来炫技的,而是用来把事情一步一步写清楚的。 先做什么,再做什么,遇到特殊情况怎么办。 你几乎可以把 Python 写下来的内容,当成一种非常严谨的步骤说明。 2️⃣ Python 通常用来做什么? 你暂时不需要知道语法,只需要知道它常被用在这些地方: 处理文件、做重复的事情、在不同格式之间来回转换、把一些枯燥的步骤自动完成。 这些事情的共同点是: 不需要复杂判断,但非常怕「少一步、多一步」。 而 Python 正好擅长把这种事情写得很清楚。

image.png 3️⃣ 那这和 Skill 有什么关系? 现在我们再回到 Skill。 Skill 的核心目标是: 让大模型,严格按照你给定的步骤做事。

而 Python,恰好是一个非常擅长“描述步骤”的语言。 所以在 Skill 里,我们通常会看到: Skill 用来说明 「这件事是什么」, Python 用来说明「这件事怎么一步步做」。 这不是唯一选择,但在「容易理解、不容易出错」这件事上, Python 非常合适。

机会

技术大厂,前端-后端-测试,全国各地等均有机-会,感兴趣可以试试~

​

三、一个 Skill 实际上长什么样? 现在,我们可以正式看看 Skill 了。 请记住一句话: 一个 Skill,本质上是一个文件夹。

这个文件夹里,最重要的不是代码,而是一份说明。 一个最小但完整的 Skill my-skill/ ├─ SKILL.md ├─ scripts/ │ └─ main.py └─ references/ └─ ... 如果你完全不懂技术,也没关系, 我们一句一句解释。 SKILL.md:告诉“机器”和“人”这件事是干嘛的 SKILL.md 里通常会说明三件事: 什么时候用这件事, 输入是什么, 输出会是什么样。 你可以把它当成: 一份「使用说明书 + 注意事项」。 scripts:把说明变成「真的会发生的事情」 scripts 里面的内容,不是给人看的, 而是让机器真正去执行的步骤。 你可以把它理解成: 把你写在 SKILL.md 里的话,翻译成机器能严格执行的版本。 references:防止「理解跑偏」的参考材料 有时候,只靠文字描述还是容易理解不一致。 这时,就可以提供示例输入、示例输出, 让机器对照着来。

image.png

四、现在真的来「手搓」一个最简单的 Skill 前面我们一直在说,Skill 是给大模型用的外部能力。 现在,我们用一个最贴近真实使用方式的例子,把这件事真正走一遍。 假设用户对大模型说了一句话: 帮我整理一下今天要做的事情:买牛奶,下午三点开会,晚上跑步。 这句话对人来说非常自然, 但对系统来说,却是一个结构不稳定的输入。 如果后面还要继续做规划、提醒、拆解任务,这个输入就需要被「定型」。 这正是 Skill 要做的事情。 这个 Skill 要做的事,其实非常简单 我们先把目标说清楚: 用户只说自然语言。 大模型负责理解“这是在描述要做的事情”。 Skill 负责把这段话,整理成一个固定、可复用的结构。 Skill 并不参与理解语义, 它只负责一件事:把结果写成系统后面能稳定使用的形状。

image.png 期望的输出(稳定结构) 不管用户怎么说,只要意思是「要做的事情」, 这个 Skill 返回的结果都应该长成同一种样子: { "tasks": ["买牛奶", "下午三点开会", "晚上跑步"] } 这里的重点不在于解析得有多聪明, 而在于:这个结构本身是稳定的、可依赖的。 一个最小但完整的 Skill 结构 nl-to-tasks/ ├─ SKILL.md └─ scripts/ └─ main.py 这个结构本身,就已经是一个完整的 Skill。 SKILL.md(说明这个 Skill“什么时候被用”) SKILL.md 的作用,不是写给用户看的, 而是写给系统和大模型看的。 它回答的是两个问题: 什么时候该用这个 Skill? 用完之后,能得到什么? --- name: nl-to-tasks description: 将自然语言中的待办事项整理为稳定的 tasks 列表结构,供大模型后续使用。 --- # Natural Language to Tasks 当用户用自然语言描述「要做的事情」时,使用这个 Skill。 ## Input - text: 用户的自然语言输入 ## Output - tasks: 待办事项数组,每一项是一个字符串 ## Rules - 输出必须是 JSON 对象,且只包含 tasks 字段 - 如果无法识别任何待办事项,返回空数组 scripts/main.py(入门级、但真实可用) 下面这段代码并不追求“智能”, 它只做一件事:把一段话拆成一个稳定的列表结构。 import sys import json import re def extract_tasks(text: str): # 使用最直观的分隔规则:逗号、顿号、换行 parts = re.split(r"[,,、\n]", text) tasks = [p.strip() for p in parts if p.strip()] return tasks if name == "main": text = sys.stdin.read() result = { "tasks": extract_tasks(text) } print(json.dumps(result, ensure_ascii=False, indent=2)) 在真实应用中,这个脚本并不是由用户直接运行的。 而是由大模型在判断“需要整理待办事项”时,在后台调用。 用户只是在和大模型说话, Skill 是在背后默默把结果“定型”的那一层。

image.png 这个例子,后面可以天然升级成什么? 一旦你有了这样一个稳定的结构输出, 后面的能力扩展会非常自然:

  • 把 tasks 直接变成真正的 TODO 列表
  • 给每一项加上时间、优先级,做 任务规划
  • 把一句话需求拆成多步,做** 项目拆解**
  • 把结构写入文件或数据库,接入其他自动化流程

而这些升级,都不需要推翻这个 Skill 的基本设计。 你只是不断在这个“稳定结构”之上,往前走。

五、想完全定制自己的 Skill,你只需要补齐这一点:Python 的基础思维 如果你只是照着示例跑一遍,其实已经足够开心了: 原来 Skill 没那么神秘,也能真的帮我把事情自动化。 但当你想更进一步—— 比如把输入换成你自己的格式、把输出改成你想要的结构、把流程拆成多个步骤复用—— 你会发现问题不再是「会不会写代码」,而是: 你能不能清楚地知道, 哪些地方只是换了一种说法, 哪些地方是真的把内容改了。 这听起来不像编程,更像是一件很日常的事。 你给东西起了名字,但改名字,和改东西本身,并不是一回事。 只要你能分清这一点,你写出来的脚本就会非常稳定。 哪些步骤是在生成新结果, 哪些步骤是在原地处理内容, 你心里会非常清楚。 所以,下一篇我会专门把这种最基础、但非常关键的理解方式讲清楚。 帮你真正掌握开发 Skills 时需要掌握的 Python 基础心智模型。

image.png

感谢您的阅读~🌹

——转载自:前端Fusion

AI
8
6
分享
操作
评论
相关内容
0个评论
全部评论
点击登录,快来和大家讨论吧~
表情
图片
🔥 热门文章
1
离谱,DeepSeek 崩了 5 小时,大家却喊:梁圣恩情还不完??
450
2
B 站上 DeepSeek 闹鱼灾了,我发起《大肥鱼清除计划》!
410
3
DeepSeek 全新模型发布,性价比最高的一集!
410
4
自己学习ai,直接买cursor 的套餐,还是买gpt 或者claude 的套餐?
370
5
又一个国产版 Codex 神器,也来卷办公了!
340
6
Vibe Coding 实战:从零构建现代专业级 AI 搜索引擎
330
7
day3-如何写出一个高质量的 Skill(组内分享) 高质量 Skill 不是“一个调得很顺的巨型 Prompt”,而是一个可验证、可回归、可维护的能力包。 先定义“什么算好”,再实现“怎么做好”。评估体系先于 Skill 本身成型。 下面用“故障诊断 Markdown 转 YAML”作为例子,但方法是通用的。 --- 一、先想清楚:Skill 到底是什么 一个 Skill 至少包含四部分: 部分 作用 接口 输入什么、输出什么、边界在哪 流程 分几步做,每步的产物是什么 规则 硬约束、经验规则、失败模式 降级策略 不确定时怎么办,而不是硬编一个看似合理的结果 高质量 Skill 的共同点:职责单一、接口清晰、规则可定位、输出可验证。 反例:把几十条经验全塞进一个主 Prompt,改一条规则要重调整个 Prompt,评估时也不知道是哪条规则退化。 --- 二、核心方法:先建评估,再写 Skill 不要先写转换器再补测试。正确顺序是: 1. 定义输出契约:什么算合法、什么算合格; 2. 建金标准集:一小批人工认可“可放行”的样本; 3. 先写评估 Skill:让它在金标准集上跑出基线; 4. 再迭代生成 Skill:每次修改跑同一套评估,无退化且目标维度提升才算正向。 这就是评估驱动开发:评估是 Skill 的单元测试,金标准集是回归锚点。 --- 三、评估 Skill:三层门禁,逐层递进 前一层不过,后一层不跑。每层留可追溯证据。 第 1 层:确定性硬门禁 用解析器、Schema、校验器完成,不消耗模型成本。 · 输出可解析; · 必填字段齐全,类型/枚举合法; · 引用目标存在,无悬空引用、无不可达节点; · 关键路径至少有一条能到达预期出口。 不通过直接打回。 第 2 层:语义断言 用脚本 + 结构遍历检查“逻辑对不对”,仍然保持确定性。 通用检查项: · 覆盖率:源材料里的关键步骤、分支、条件,输出里是否都有对应? · 完整性:每个判断节点是否都有明确出口?有没有死胡同? · 可达性:每条路径是否都能到达预期终点?有没有无出口循环? · 顺序与依赖:有先后依赖的操作,是否保留了顺序?有没有被拍平成无序列表? 例子:故障诊断转换中,检查“每个判断项是否有是/否/异常出口”“每条路径是否能到根因”。 第 3 层:LLM-as-Judge 只处理解析器表达不了的维度:忠实度、完整性、可执行性。 但 Judge 会漂移,不能单独放行,必须建立在第 1、2 层之上。Judge 的 Prompt、rubric、模型版本都要版本化,换模型必须用金标准集重新校准。 通用 Judge 维度: 维度 问什么 忠实度 输出是否忠实源材料意图?有没有自行发明内容? 完整性 关键步骤、条件、证据是否保留?隐式知识有没有被压成空话? 收敛性 输出是否仍指向原目标,而不是发散? 可执行性 下游不依赖源材料能否直接使用? --- 四、金标准集:回归测试的锚点 不需要一开始就标注几百份。用已认可的样本当种子,扩到 15~30 份,覆盖失败模式而非随机抽样: · 完整正例:典型流程; · 边界/异常分支:异常路径、循环、前置失败回退; · 已知易错模式:实际踩过的坑; · 留出集:不参与调优,只用于最终验收,防过拟合。 金标准不需要完美,只需要当前标准下认可可放行。 回归指标:关键路径用 pass^k(k 次全过),稳定性用 pass@k。 --- 五、工程约束:让批量产出可重放 · 幂等:同输入 + 同 Skill 版本 + 同规则 → 输出一致,否则无法判断变好是 Skill 改了还是随机波动; · 隔离不阻断:单份失败进隔离队列,记录失败层和原因,不阻塞其余; · 版本绑定:规则、rubric、金标准集进 Git;每份报告绑定“源版本 + 生成 Skill 版本 + 评估 Skill 版本 + Judge 模型版本”; · 抽样人工复核:Judge 临界样本 + 易错模式,人工抽检结果反过来校准 rubric。 --- 六、Skill 本身怎么写 · SKILL.md 控制篇幅,写清:输入约定、输出契约、分步流程、硬规则、降级策略; · 经验规则放 references/ 或 rules/,按失败模式分类,不要全塞进主 Prompt; · 不确定时标 needs_review: true,不要硬编看似合理的结果; · 迭代由评估报告驱动:报告告诉你哪层挂了、哪类失败模式,你改对应规则文件,而不是漫无目的调 Prompt。 --- 七、落地顺序(不要反过来) 1. 固化输出契约:Schema + 结构约束; 2. 建金标准集:从已认可的 + 最易出错的样本开始; 3. 先写评估 Skill:跑出基线报告; 4. 再迭代生成 Skill:每次修改对比逐项通过率,无退化且目标提升才算正向; 5. 批量运行 + 隔离回放:失败进队列,结束后人工抽检; 6. 评估 Skill 自身版本化:换 Judge 模型必须重新校准。 --- 八、给组员的三条硬要求 1. 不许凭感觉说“变好了”:每次修改必须附评估报告对比,逐项通过率说话。 2. 不许跳过确定性门禁直接看 Judge 分数:前两层挂了,Judge 分数没有意义。 3. 不许把规则堆进主 Prompt:规则按失败模式分文件,评估报告要能定位到具体文件。 --- 一句话收尾 生成 Skill 决定“能不能做”,评估 Skill 决定“敢不敢用”。 先让评估体系站稳,再让生成器迭代。这样交付的不是一堆“看起来还行”的产出,而是一套可证明、可回归、可交接的 Skill 质量体系。
320
8
我的第一个出海产品!7 天 2 万
310
9
WorkBuddy 本地 API 桥 + dsh 插件:把你的 WorkBuddy 额度,变成手边随手可用的模型
310
10
什么是LLM
300
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
零感AI零感AI
墨得问题墨得问题