用了大半年 AI 编程工具，我才搞懂 Skill 到底是什么

不知道你有没有这种感觉，打开 AI 编程工具的那一刻，满屏都在蹦词。Agent、MCP、Prompt 还算眼熟，可 Skill 这个词，我是真被它绕了好一阵。

最早看到它，是在别人的分享里，动不动就是「我写了个 Skill 一键搞定」「这个 Skill 直接把流程串起来了」。我当时心里咯噔一下，怎么又冒出来一个要学的东西。前端这边框架还没完全吃透呢，AI 这边又铺开了一层新名词，那种被甩在后面的慌，做我们这行的应该都懂。

我第一次对 Skill 这个词犯怵

说真的，我不是不爱学。可这两年新东西来得实在太密，今天一个范式明天一个协议，看都看不过来。有一回组里前辈顺嘴提了句「你可以把它做成 Skill 复用」，我表面嗯嗯，转头就懵了，Skill 到底是个文件、是个功能、还是个概念？

怕就怕在，越是听不懂，越不好意思问。周围人聊得飞起，好像谁都默认你早该知道。我这种刚写页面没多久、还在慢慢爬坡的人，最怕的就是露出「这个我也不会」的表情。

有次周会， leader 说下周把几个重复活儿都做成 Skill 提效，我旁边同事立刻接话「对对，我们组那个早该沉淀了」。我低头记笔记，其实连从哪建文件都没听清，又不敢当场问，怕显得我连基础概念都跟不上。散会后我一个人在工位上搜了半天，越搜越乱，什么 SKILL.md、什么触发词，词都认识，连起来就发懵。那天我挺丧的，不是因为学不会，是因为发现自己连「该从哪学」都摸不着门。

于是它在我脑子里挂了好几天，像个没拆的快递，知道里面有东西，就是没勇气拆。

后来我逼自己坐下来查了查，才发现问题出在我把它想太重了。

原来它没那么神

Skill 拆开来看，其实特别朴素。我们平时跟 AI 说一段话，那段话叫 Prompt，是这一次临时吩咐。可有些事你会反复做，比如每次让 AI 帮我把产品丢来的口头需求理成能开发的任务，要求又长又容易漏。Skill 干的事，就是把这类反复要说的标准，提前写成一张作业卡，下次直接调。

说白了，不是每次口头吩咐实习生，而是给他一张写清先做什么、交什么的卡片。

形式上更简单，一个文件夹里放一份 SKILL.md 就够了。文件开头写清楚这个技能叫什么、什么时候该用，正文写触发以后怎么干、最后交出来长什么样。我用的工具是放在项目里的 skills 目录，新建文件夹再塞一份 md，基本就齐活。没有要装的环境，也没有要配的依赖，这点对怕折腾环境的我来说，意外地友好。

我特意记住一句话：Skill 不是越长越好，写清判断和交付，比写成作文重要得多。这条对我这种怕写长文的人特别友好。

我给自己写了一个前端小技能

琢磨明白之后，我没敢搞大的，先拿自己每天真会碰到的场景开刀。

我做前端，最烦的一件事，就是设计师或者产品在群里丢一句「那个按钮再往下挪一点，颜色换个浅的，顺便把间距统一下」，零碎、口语、还散在好几条消息里。每次让 AI 帮我校理，都得重新把背景交代一遍，累。

于是我写了个叫 demand-card 的小 Skill，专门干一件事：把群里的口头需求，整理成一张能直接开干的任务卡。SKILL.md 里我大概写了这么点东西：

name: demand-card
description: 把群聊里的口头需求整理成开发任务卡。
  在用户发来零散的产品/设计需求、口头改版要求时使用。

根据对话内容，只输出 2 到 4 条任务，不要写大段说明。
每条必须包含：
- 改什么（具体元素，如首页登录按钮）
- 改成什么样（可验收的描述）
- 涉及文件或组件（如能判断）
禁止：编造没提过的需求；把一句话拆成多条凑数。

写完我就在对话里试了一句「帮我把上面几条需求整理成任务卡」，出来三四条，元素、验收、组件都对得上。那一刻挺开心的，不是因为它多厉害，而是我终于亲手把一团乱麻变成了一张能执行的卡。原来那些看起来高冷的词，落到一个小场景里，也就那么回事。

不过第一次没那么顺。我头回写的时候，description 写得含糊，只说「整理需求」，结果 AI 给我吐了一大段分析，还把产品随口提的一句玩笑也当真需求列了进去。我这才懂卡片上「禁止编造没提过的需求」那行不是摆设，是踩过坑才写上的。改了两轮，把触发条件写死、把交付格式卡死，输出才稳下来。小东西虽小，该有的试错一点没少，反而让我更踏实，因为每一步都是我自己调出来的。

写完才发现，怕的东西变具体了

回头想，我之前对 Skill 的怕，一半是它名字唬人，一半是不敢承认自己跟不上。真动手写了一个，怕反而小了。

可我还是没法说完全不慌。AI 这趟车跑得太快，今天 Skill 明天不知道又是什么，我这种普通前端，真怕哪天连「该学什么」都看不清。身边能聊这些的人不多，我也半懂不懂，很多时候是边搜边试，错了再改。

所以我今天把这段写出来，一半是记给自己，一半是想看看有没有和我一样的人。你也在被这些新词推着走吗，你第一次写 Skill 是什么时候，有没有那种「原来就这」的瞬间，或者反过来，越学越迷糊的时刻。

我不指望这篇能教谁什么，我就是个还在爬坡的前端小卡拉，写下来，是想确认自己不是一个人瞎紧张。要是你也在学，或者已经跑在前面，愿意留句经验或哪怕一句鼓励，我都会很感激。咱们互相打打气，总比一个人对着满屏新概念发呆强。

计划大概率明天就会被我推翻重来，但总得先迈出脚。先把这张小卡片用熟，再慢慢看能不能给它加更多场景。比如测试妹子提的 bug，经常是「点这儿闪退了」一句带过，我想再加一张复现卡，把现象、步骤、预期结果理清楚，免得我每次都反反复复去问。这种小打算攒多了，说不定哪天我真能成一个会做工具的人，而不只是被工具追着跑的人。

一步一步来吧，至少今天，我没被那个词吓退。