Phase 1 · 第 1.6 节 · 主资源:taste-skill(Anti-Slop 前端 skills)

让它好看(二)· 认识 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 的名字,里面有一个叫 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 自行搬运。本课程的核心理念就是"你来指挥,Agent 来执行"。装 skill 这件事也一样,在 OpenCode 里直接对它说:
教材 tools 目录里有 taste-skill 和 abel-ux 两套前端 skill。
请把它们都装进 OpenCode 的 skills 目录,让你能调用。
装好后告诉我每个 skill 的名字。
它会自己找目录、复制文件、跟你报告装了哪些。装哪个目录、Mac 还是 Windows,它比你清楚。

装好后,长什么样

文件放置到位后,确认 skill 是否已被 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              设计评审
 
能看到这些名字,就说明装上了。

看到名字列出来,就装好了。如果列表为空,或找不到你刚才放入的 skill 文件夹,通常是文件夹未放置在正确的目录中,或者 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 或助教提问。

课程术语表 上一节:设计基础 下一节:为什么不一直用 HTML 深入:taste-skill