1.6
第一章 · 第 6 节

让它好看(二):认识 skills

这一节你会拿到

你把一个前端 skill 放进 Agent 能读到的目录,让它生效,再用一句话指挥它把同一个页面重做一版,亲眼对比同一句需求在安装 skill 前后产出的差距。

回头一题

这道题不考这一节,考前面学过的。想不起来就回去翻一眼再答——记不住的东西,真用的时候一样会卡。

一个页面看起来「乱、不专业」,通常你该最先动手调什么?

上一节(1.5 设计基础)你用四条原则点评页面、让 Agent 去修改。还有一种更高效的方式:给 Agent 安装一个前端专长包,不必每次手把手教,它自己就带着审美能力工作。这个专长包叫 skill

skill 是什么

把 Agent 想象成一个聪明、但什么都只懂一点的新员工。skill 就是你塞给它的一本专长手册,里面写着某个行当的规矩、审美、老经验。它读完这本,再干这一行的活,就跟换了个老师傅一样。

一句话

skill 是给 Agent 的一份专长说明书,它能读懂、能照着办。装上前端 skill,它写的页面就自带审美;装别的 skill,就多一门别的本事。

你的 Agent聪明 · 但什么都只会一点
+
skill 前端审美包(taste-skill)
skill 设计评审包(abel-ux)
skill 以后还能装更多

装上一个专长包,还是同一个 Agent,但多了一门老师傅级的本事。这一节要装的是前端那套。

一个 skill 到底是什么形态

别把它想复杂了。一个 skill 说白了就是你电脑上的一个文件夹。文件夹的名字就是这个 skill 的名字,里面有一个叫 SKILL.md 的文本文件(文件名全大写),那就是写给 Agent 看的说明书正文,可能还附带一些参考素材。就这么简单。

这门课已经把整套前端 skill 备好,放在教材的 tools/ 目录里,随教材一起发给你。打开看,大概长这样:

教材里的 tools 文件夹(随课程发给你)
tools/
taste-skill/
skills/
minimalist-skill/ 一个 skill = 一个文件夹
SKILL.md 写给 Agent 的说明书正文
brutalist-skill/
brandkit/ … 还有好几个,各管一种风格
abel-ux/
SKILL.md 100 多条设计原则的说明书

这一节要装的就是这两套:

怎么装:把文件夹放到 Agent 能读到的地方

操作 · 把 skill 文件夹复制到 OpenCode 的 skills 目录,或让 Agent 代劳。

这一步要用到终端(打开终端、找文件夹这些基础操作,前面 0.4 安装1.4 造出第一版 已经带你做过,这里照着用)。下面分系统给你目标目录,选你的系统看。

  1. OpenCode 在 Mac 上读这个目录:~/.config/opencode/skills/(~ 是你的用户主目录;名字以 . 开头的是隐藏文件夹,访达里默认看不到,用命令行进最稳)。
  2. 把教材 tools/taste-skill/skills/ 里的每个 skill 文件夹,和 tools/abel-ux/ 整个,复制进上面那个目录。不熟悉怎么复制文件夹?直接让 Agent 帮你搬(下面有原话)。
  3. 放好后,目标目录里应该出现一个个 skill 文件夹,每个里头都有 SKILL.md。这就算放对位置了。
更省事的办法:让 Agent 自己搬

这门课从头到尾就是"你指挥、它执行"。装 skill 也一样,在 OpenCode 里直接跟它说:

教材 tools 目录里有 taste-skill 和 abel-ux 两套前端 skill。
请把它们都装进 OpenCode 的 skills 目录,让你能调用。
装好后告诉我每个 skill 的名字。
它会自己找目录、复制文件、跟你报告装了哪些。装哪个目录、Mac 还是 Windows,它比你清楚。

装好后,长什么样

文件放好之后,得确认 Agent 到底认没认。在项目文件夹里启动 OpenCode,让它列一下现在认得哪些 skill。装上了的话,终端会给你类似下面这样的输出,列出 taste-skill、abel-ux 这些名字(下面是仿终端示意,不是真实输出,你机器上的措辞会略有不同)。

终端 · steve-repair
steve-repair $ opencode
OpenCode 启动,正在扫描 skills 目录…
 
你 › 你现在装了哪些 skill?列一下
已加载的 skills:
  design-taste-frontend  前端审美(taste-skill 主包)
  minimalist-skill      极简风
  brutalist-skill       粗野风
  abel-ux              设计评审
 
能看到这些名字,就说明装上了。

看到名字列出来,就装好了。如果列表是空的,或者找不到你刚搬进去的那几个,多半是文件夹没放对目录,要么就是 OpenCode 还没重启、没重新扫。把情况说给你的 Agent,它会替你核对路径。

怎么让它真的用上

操作 · 对 Agent 说下面这段话,让它用前端 skill 重做首页。
用前端 skill(taste-skill / abel-ux)把首页重做一版,
走干净、专业的极简风,要有清晰的层级和留白。
做完保留旧版,我要把新旧两版并排对比一下。

两个关键:一是明确说"用前端 skill",让它知道该调动那身本事;二是让它保留旧版,你才能把新旧两版摆一起看。觉得方向不对,再补一句,比如"换成更暖一点的风格""按钮再醒目些"。

发出去之后,终端大致是这样(仿真示意):

终端 · steve-repair
steve-repair $ 用前端 skill(taste-skill)把首页重做一版,走干净、专业的极简风…
正在加载 skill: design-taste-frontend…
分析现有的 index.html,保留内容,重新组织视觉呈现…
应用:层级系统、留白规则、品牌调色板、排版比例
已生成新版本,保存为 index-v2.html
旧版保留为 index-old.html,在浏览器里打开对比吧。

看到新文件已生成、旧版已保留,就说明 skill 生效了。在浏览器打开两个文件对比。

同一页面:无 skill vs 有 skill

下面两块都是真实渲染的网页,都是 Steve's Repair 首屏。给的需求一字不差:"做一个维修店首屏,有店名、一句话、一个预约按钮"。左边是 Agent 没装 skill 交的活,右边是装了前端 skill 交的活。扫一眼就知道差在哪。你待会儿自己跑完,看到的也是这种差距。

无 skill 版(没装)
有 skill 版(装了前端 skill)

同一句需求,未安装 skill 的结果:功能可用,但视觉上缺乏层次 同一句需求,装了前端 skill 的结果:有层级、有留白、有品牌感

看懂关键

两边信息差不多,都是店名、一句话、按钮、四项服务。差的全在怎么呈现:字号分了层级,间距留了白,配了色,按钮有了质感,服务做成了卡片。这些呈现上的讲究,就是前端 skill 给 Agent 补上的东西。你一个字没多写,只是换了个有审美的师傅来做。

动手自检:你真的装上、用上了吗

下面四项,每一项都得你在自己电脑上真做完了再勾,看懂了不算。四项都勾上,这一节才算拿到手。

1.6 · 装上前端 skill 自检卡

四项都做到了,这节的目标拿到手。

在自己机器上做完一项就勾一项,四项都勾上就过。

装不上、没效果?这三种最常见


一、让它列 skill,列表是空的、找不到刚搬的那几个:多半是文件夹没放进对的目录,或 OpenCode 没重启没重扫。退出 OpenCode 重新启动一次,再让它列;还不行,把目录路径发给你的 Agent帮你核对。
二、它做出来的新版和旧版差不多、没变好看:八成是你没在需求里点名"用前端 skill",它就没去翻那本说明书。把那句话补上重说一遍。
三、新旧两版找不到、不知道哪个文件是新版:让 Agent 明确告诉你新版存成了哪个文件,再用浏览器打开它(怎么在文件夹里找到文件、用浏览器打开,见 1.4)。
都试过还卡着?把现在的情况用文字写清楚发给你的 Agent,它会带你一步步装好、用上。

动手:你来当裁判

装 skill 的真本事,是能看出"它到底有没有变好"。下面是同一个需求("做一张维修预约卡片")交上来的两版。先选出更好的那版,再指出一处具体差别。选完有反馈。

第一步:这两版,哪一版更好?

A 版
B 版

小测:装了却没效果

你装好了前端 skill,但让 Agent 重做的页面还是一样寡淡。最可能漏了哪一步?

不知道 skill 文件夹该放进哪个目录、让它列却列不出来、想换风格不知道怎么说?把情况(最好连终端画面一起)发到群里问问大家,或者直接向 Abel 或助教提问。

答对了!