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

很多人第一次看到 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

0个评论
点击登录,快来和大家讨论吧~
表情
图片
暂无评论
鱼友7295
作者分享
GitHub Trending周报:Claude Code生态大爆发,这些项目值得收藏 每周一,我都会刷一遍GitHub Trending,看看这一周又有什么新东西。 这一周的关键词就一个:Claude Code生态。 从mattpocock/skills到free-claude-code,从GitNexus到Beads,整个GitHub Trending几乎被Claude Code相关的项目承包了。 今天就给大家梳理一下这周最值得关注的几个项目。 1. mattpocock/skills(23.5K⭐)—— Claude Code实战技能库 这是本周Star增长最快的项目之一,由Vercel前员工mattpocock维护。 这个项目的核心价值是:他把自己在实际项目中使用Claude Code的经验整理成了一套"技能脚本"。 包含的内容很实用: Git操作:自动生成commit信息、智能处理merge冲突 代码审查:自动review代码、生成改进建议 测试生成:根据代码自动生成单元测试 文档撰写:自动生成README和技术文档 这些脚本不是"玩具",而是可以直接用到生产环境的实战工具。 对于刚上手Claude Code的开发者来说,这套技能库能帮你快速建立正确的工作流。 顺嘴提一句,技术大厂,前后端-测试机会,全国一线及双一线城市均有坑位(https://jsj.top/f/o38ijj),待遇和稳定性还不错,感兴趣看看。 2. Alishahryar1/free-claude-code(13.5K⭐)—— 免费的Claude Code方案 本周涨势最猛的项目之一,一天涨了7000+ Star。 这个项目解决了一个很现实的问题:Claude Code要钱,Copilot也涨价了,有没有免费的替代方案? 它提供了一套在终端、VSCode、甚至Discord里使用Claude Code的方案,完全免费。 适合人群:学生党、个人开发者、想尝鲜但不想花钱的程序员。 不过要注意,免费方案可能有稳定性风险,生产环境还是建议用官方版本。 3. abhigyanpatwari/GitNexus(30K⭐)—— 浏览器里的代码知识图谱 这个项目的创新点很有意思: 不需要服务器、不需要安装任何软件,直接在浏览器里生成整个代码库的知识图谱。 你只需要拖一个GitHub仓库进去,它就会自动分析代码结构、依赖关系、函数调用链…… 然后给你生成一张交互式的知识图谱。 对于接手老项目的开发者来说,这个工具简直是神器。 你不再需要花几天时间读代码,只需要看看这张图,就能快速理解整个项目的结构。 4. gastownhall/beads(新增项目)—— 给AI Agent装"记忆" 这是本周新上榜的项目,关注度很高。 核心功能:解决AI Agent的"金鱼记忆"问题。 用过Claude Code的朋友应该知道,它每次对话都是从零开始,不记得之前聊过什么。 Beads通过在代码仓库中插入结构化的"记忆文件",让Claude Code能够跨会话记住重要的上下文。 比如你定义了一个API版本同步规则,下次对话时Claude Code就能自动应用这个规则。 这个思路很有意思,为AI Agent的长期记忆提供了新的解决方案。 总结 这一周的GitHub Trending,释放了一个很明确的信号: Claude Code生态正在快速成熟。 从技能库到免费方案,从知识图谱到长期记忆,开发者们正在围绕Claude Code构建完整的工具链。 如果你还没开始用Claude Code,建议从mattpocock/skills开始,先学习正确的工作流。 如果你已经在用Claude Code,那GitNexus和Beads这两个项目值得你花时间研究。 AI编程工具的时代已经来了,你准备好了吗?
6
MyBatis中的 10 个宝藏技巧!
3
OD入职半年,聊聊我的真实体验和建议 本人普通二本院校,去年秋招拿了几个offer,最后选了OD后端开发。入职半年多了,来发个帖分享一下真实感受,给大家一个参考。 为什么选 OD 秋招的时候拿了几个offer,有中厂的正式offer,也有OD的。最后选OD的原因: 平台大:想第一份工作去个大平台,见见世面 技术成长:面试的时候和面试官聊得挺好,感觉团队技术不错 待遇还可以:综合下来不比中厂正式差多少 面试流程快:从一面到拿offer不到一个月,不用一直等 当时也搜了很多关于OD的帖子,什么说法都有,越看越纠结。最后决定:反正还年轻,试错成本低,去了不行再跳呗。 入职体验 新人培训 入职后有为期两周的新人培训,不是走过场那种,是真的有东西学: 公司文化和价值观(这个听听就好) 技术栈培训(语言、框架、内部工具) 业务背景介绍 安全合规培训 培训完还有考试…不过不难,认真听都能过。 团队氛围 这个必须重点说!分到的组氛围真的超好: mentor 是个工作三年的老哥,人特别耐心,我问的傻问题都认真答 leader 不卷,到点就催大家下班(真的!) 组里每周有技术分享,每月有团建 同事们都很好相处,没有勾心斗角那一套 OD身份这个事,组里没人提,大家都是一起干活的。至少在我们组,完全感受不到区别。 工作内容 我做的是后端开发,工作内容和正式员工没区别: 需求评审、技术方案设计 编码、单元测试、code review 发布、线上问题排查 技术调研、方案优化 成长速度确实快,半年时间学到的东西比大学四年加起来都多(不是说大学没用,是实战和上课真的不一样)。 大家最关心的几个问题 Q1:OD和正式员工到底有什么区别? A:合同主体不同,这个是本质区别。日常工作层面,至少我的体验是没差别的。一样的工作内容、一样的办公环境、一样的培训福利。 Q2:会不会被歧视? A:至少我没遇到过。组里没人会特意问你是什么身份,大家都是干活的。当然不排除个别组有这种情况,但我觉得是少数。 Q3:加班多吗? A:看组看项目。我们组一般是正常下班,项目上线前会忙一阵。没有996那么夸张,但也不是完全不加班。 Q4:食堂怎么样? A:这个必须吹一波!三餐免费,种类很多,味道也不错。入职半年胖了五斤… Q5:适合应届生去吗? A:个人觉得适合。第一份工作,平台和成长比什么都重要。大公司的工程体系、项目体量、技术氛围,这些对新人来说都是宝贵的资源。 Q6:以后好跳槽吗? A:我觉得简历上有大厂项目经验,跳槽的时候是加分的。面试官更关注你做过什么、能力怎么样,而不是你是什么用工模式。当然这个我还没验证过,仅供参考。 一些建议 不要被网上的言论吓退,也不要被洗脑,自己去面一次、和团队聊聊,比什么都真实 选团队很重要,同一个公司不同组的体验天差地别,面试的时候可以主动问问团队情况 技术永远是王道,不管什么身份什么模式,能力到位了就有选择权 第一份工作,成长比钱重要,当然钱也不能太少(狗头) 网上的信息看看就好,每个人情况不一样,不要人云亦云 写在最后 半年多下来,我觉得这个选择不后悔。学到了很多,认识了很多优秀的人,也对互联网行业有了更真实的认知。 OD不是洪水猛兽,也不是什么天上掉馅饼的好事,它就是一个选择而已。适合不适合,只有自己试过才知道。 祝大家都能拿到心仪的offer! 有问题可以在评论区问,知道的都会答~
7
在OD写了两年代码,聊聊技术成长这件事
6
Agent-Reach实测:让AI Agent一键搜索全网,我踩了3个大坑
4
下载 APP