用编码智能体做大学项目的界面,一开始只是图省事:有时要新开一个页面,有时只是改改已有的页面。反复出现的挫败感很具体——智能体会塞进一些看起来很通用、却和项目对不上的设计选择,于是又得再来一轮修正。

打开网易新闻 查看精彩图片

这个循环逼出了一个工具:flawless-ui-ux,一个免费开源的 UI/UX 技能包加本地检查命令行工具。作者仍在自己的课业里用它,也希望别的开发者能拿去用在自己的项目上。它支持 Claude Code、Codex 以及其他编码智能体。

问题于是换了个问法:怎么给智能体足够的上下文,让它做出更好的判断,然后再去检查它到底建出了什么?

两个改进样本

咖啡店首页和金融科技 SaaS 仪表盘是两个示意案例,不是课程作业。两者都在 Codex 里用 GPT 6.1 Sol、低推理强度起步,随后用同一模型和同样的推理设置,借这个技能包做改进。

这是前后顺序对照,不是受控实验:改进版是在已有界面上再过一遍,因此不能单独归因于技能包的效果,也不能证明每个任务都会以同样方式变好。

咖啡店首页的初版已经有清晰的视觉方向。改进后变的是层级:店名成为主标题,描述说明这家店卖什么,营业时间和位置被挪进首屏。照片仍是视觉中心,但不再扛着一个过大的第二字标。

这样就留下了可以逐项评估的选择:访客能不能看懂这门生意、找到菜单、弄清什么时候去哪里?至于新的字体和配色是否贴合一家真实的咖啡店,仍取决于这家店自己的身份定位。

金融科技仪表盘则是另一类设计问题。改进后减少了互相争抢的界面区块:顶部指标变成更扁平的一行摘要,标题点明这个页面的用途,侧边栏的推广位消失。现金流图表和账户信息仍是核心内容。

仪表盘要的是便于比较、便于反复使用。截图能展示层级和密度,却无法证明底层的计算或交互是对的。

给智能体一个可评估的任务

这个技能包把设计决策和项目的受众、内容、身份绑在一起。提改动需求时,还可以限定范围。比如可以这样要求:用 flawless-ui-ux 技能审查这个仪表盘,它是给自由职业者查看收支用的,在保留现有数据、操作和品牌色的前提下改进层级与可读性,解释改动并检查渲染结果。

这是一个可供读者改写的示例请求,不是上面那两张截图背后的原始提示词。

视觉这一遍过完之后,还要检查实现。命令行工具会给出观察结果供智能体复核。源码检查和浏览器检查覆盖的范围不同:只看一个文件,无法确定页面在某个视口下长什么样。

以使用 src/App.tsx 的项目为例,可以运行 npx flawless-ui-ux inspect --project . --source src/App.tsx --format json 做源码检查。

要做浏览器检查,先单独启动应用,并准备一次 Chromium:npx playwright@1.64.1 install chromium。然后用实际的开发服务器地址检查,并把基线保存到一个新目录:npx flawless-ui-ux inspect --project . --source src/App.tsx --url http://localhost:5173 --output ../app-before --format json。

改完之后,对着保存下来的范围做验证:npx flawless-ui-ux verify ../app-before/run.json --output ../app-after --format json。源码路径和地址换成自己的即可。

浏览器检查覆盖部分无障碍规则、横向溢出、计算后的文字尺寸、可见的破损图片,以及未捕获的 JavaScript 错误。验证环节会区分持续存在、新出现和不再观察到的问题。

这些观察结果只是辅助复核,并不等于无障碍认证,也不衡量设计质量,更不能证明每条用户路径都走得通。截图仍要自己看,关键交互仍要自己测。

在自己的项目里试

命令行工具要求 Node.js 22.12 或更新版本。给 Claude Code 安装这个技能包:npx flawless-ui-ux@latest install --claude-code。也可以通过 Skills CLI 安装:npx skills add smokeeaasd/flawless-ui-ux --skill flawless-ui-ux -a claude-code。

必要时开一个新的智能体会话以便发现技能,然后让它使用这个技能。仓库里还包含面向其他智能体的安装说明,以及命令行工具检查能力的边界。

作者仍在课业里继续用它,遇到问题就改进它。回到那两个样本,哪些设计决策你还会改,在宣布一个界面完工之前,你会先测什么?