Communitygithub.com

fresh-eyes

设计和审查Web产品UI(应用界面、仪表盘、设置、表格、表单、入职流程、空状态和错误状态,以及销售产品的落地页、主页和定价页),使其看起来由用心之人制作,而非模板。每个界面均基于用户任务和真实内容构建,通过渲染和新视角检查,符合WCAG 2.2 AA标准,并避免机器痕迹。

fresh-eyes 是什么?

Fresh-eyes 是一个专业设计审核技能,专为构建或审查 Web 应用、SaaS 产品及其网站界面的 AI 代理(如 Claude Code、Cursor)设计。其核心理念是“为使用它的人设计界面”,从用户的任务和真实内容出发,而非模板或AI习惯。该技能支持通过一系列步骤(理解、规划、写文案、构建、渲染检查、新视角审视、修复)创建或审查界面,并内置了脚本工具(如渲染截图和色彩检查)来辅助验证。它强调使用真实数据、遵守无障碍标准(WCAG 2.2 AA)、避免“机器痕迹”(如边缘色条和破折号),并通过启动独立子代理来模拟“新鲜视线”测试,对比用户的第一印象与设计意图。该技能适用于任何希望设计、改版、优化或审计界面的人,即使他们不直接提及“设计”。它不适用于logo、幻灯片或原生移动应用。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bernardoo-soares/fresh-eyes/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Fresh eyes

为使用它的人设计界面,从他们来的任务和他们将看到的内容出发。 判断力为先;参考资料使其更精确,脚本用于检查。这里没有任何东西凌驾于常识之上:如果某个界面令人困惑且没有规则能说明原因,它依然令人困惑。

下面的 <skill> 指此技能的目录:${CLAUDE_SKILL_DIR}(如果显示为字面变量,请使用读取此文件所在的文件夹)。

设置

脚本需要 Node 20 或更高版本。当脚本提示需要设置时,运行其打印的命令:一个或两个 npm --prefix "<skill>" install 和 node "<skill>/node_modules/playwright/cli.js" install chromium,这些命令可以在任何文件夹和任何 shell 中运行。

如果脚本无法在此处运行(没有 shell、没有 Node、没有网络下载浏览器),不要停止:使用当前会话中的任何浏览器工具截图,或逐行对照 references/floor.md 检查代码,并在报告中说明渲染检查未运行。绝不要仅凭代码进行视觉检查。

循环

用于创建和审查。对于审查,首先阅读 references/review.md:其中的步骤替换步骤 1 到 4,改进版本作为原版的副本放在旁边,除非对方要求修改其文件。

  1. 理解。 谁使用此界面,做什么任务,频率如何,在什么设备上,使用什么真实内容。如果项目中有 DESIGN-CONTEXT.md(参见 references/design-context.md),请阅读。如果没有,则从代码、文案和请求中推断,并记录你的假设。不要停下来先采访用户。
  2. 在样式化之前决定。 在构建之前,在工作笔记或回复中简要写下:此界面的唯一目的;视线应首先落在何处;首屏必须包含主要决策所需的内容(桌面端和手机端);其他所有内容的顺序;唯一的首要操作;你省略了什么。列举该类别用户已经喜欢的两三个产品,你遵循其结构,以及此产品独有的一个标志性动作(references/modern.md)。这是你的意图,步骤 6 将对其进行测试。
  3. 先写文案。 标题、标签、按钮、空状态和错误状态,用用户的语言,基于真实数据(references/words.md)。绝不要虚构数字、姓名、推荐或趋势;没有真实数据时,使用可见的占位符。
  4. 按顺序构建: 结构,然后是层次,然后是工艺,使用项目自己的组件和令牌(如果有,对于 React + shadcn/ui,阅读 references/stacks/react-shadcn.md)。新的视觉系统从 node "<skill>/scripts/tokens.mjs" --accent "<hex>" --out <dir> 开始,该命令会检查每个颜色对。
  5. 渲染并查看。 对于应用,启动其开发服务器并传递 URL。将 --out 写入项目外的临时文件夹:node "<skill>/scripts/render.mjs" <page.html | url> --out <dir>(如果提示需要设置或无法运行,请参阅设置);如果有登录,添加 --storage-state <file>。它会保存桌面端和手机端、浅色和深色的截图,打印它可以测量的问题(对比度、焦点、横向滚动、小目标、冲突的首要按钮、边缘条纹、破折号),然后是一个“目视检查”列表。修复每个问题,或在报告中说明为何保留;审查会修复底层问题、条纹和破折号,并将其他可测量的痕迹作为发现项提供。如果它警告浅色和深色看起来相同,请使用 --theme-mode class 重新运行。查看截图,首先看四张 -first.png,然后检查每个“目视检查”项目:空列表意味着底层是干净的,而不是界面是好的。使用压力内容渲染一次:最长的真实姓名、最大的金额、空的账户。
  6. 新鲜视角。 启动一个没有任何此对话上下文的新子代理(不是其分支);如果列出了 first-look 代理类型,则使用它。其完整提示为:Read <skill>/agents/first-look.md and follow it. The job: <one sentence>. Images: <absolute paths, first-screen ones first>. Open no other file. 不要添加任何关于你的意图或你构建/更改的内容。将其回答与步骤 2 进行比较:错误的“这是什么”、错误的首次点击、犹豫或“感觉不对”都是需要修复的问题;在审查一个已经正常工作的页面时,一个既不会阻塞也不会误导任务的犹豫是可选建议,而不是必须修复的问题。如果没有子代理,仅从首屏图片中自己回答首次浏览的问题,然后再重读你的代码。
  7. 修复并停止。 首先用结构修复每个犹豫(一个标签、一个列表、一个视觉、一个重新分组);只有当其他方法都无法表达时才添加一个句子。对名称的疑问通过更好的名称来修复,绝不能在其下方添加一行解释,并且菜单内永远不要解释任何内容。最多再进行两轮步骤 5 和 6,然后说明仍然存在的问题。回答 references/modern.md 中的测试的三个问题(哪个类别的产品会认为这是当前的;标志性动作在哪里;这个界面是否可能属于任何初创公司),并报告。

最简单路径优先。 主要操作在界面打开时即可使用;额外功能(编辑每一行、批量工具)放在下一层级,绝不要妨碍首屏(references/structure.md)。

完成,而非裸露。 避免痕迹不是目标。界面应看起来像一个完成的产品:用户操作的单元有自己的容器,图标和小型视觉元素在承载意义的地方出现,整个决策在首屏完成。一长列灰色的句子也是失败(references/hierarchy.md)。

根据请求调整范围。 仅文案(标签、错误消息):步骤 1 到 3。一个组件或小修复:步骤 1 到 5。整个界面或审查:全部七个步骤。

决定大多数界面的问题

询问阅读
谁来这里,频率如何,做什么任务?密度应如何(姿态)?事物如何分组、命名和访问?references/structure.md
视线应首先落在何处?是否恰好有一个首要操作?每个数字是否都有其比较、单位和日期?references/hierarchy.md
首次使用者能否看出这是什么、他们在哪里以及下一步要做什么?references/clarity.md
每个区域处于什么状态,并且是否恰好处于一种状态?当用户出错时,是撤销还是确认?references/states.md
文案是否像用户一样称呼事物?每个错误是否指明了修复方法?references/words.md
字体、间距、颜色、深色模式和动效是否经过深思熟虑?references/craft.md
它看起来像完成的产品还是文档?首屏是否承载了决策?references/hierarchy.md
它看起来现代而不像生成的吗?它的标志性特征是什么?references/modern.md
此界面是否可能属于任何产品?哪些东西可以移除?references/tells.md
它是落地页、主页还是定价页?访客必须做出什么决定?references/landing.md
键盘、对比度、重排、名称、目标,在两种主题下?references/floor.md

当某个问题在你面前的界面上未解决时,才阅读相应的参考资料,而不是一开始阅读所有内容。其中每张卡片包含决策、做法、原因及其来源、查找的内容,以及何时不适用(除非)。例外与规则同样重要。

不可动摇的原则

  • 仅使用真实内容:不虚构数字、人物、引文或历史。
  • 无障碍底线(references/floor.md)在浅色和深色模式下均需保持。
  • 元素边缘没有彩色条纹作为强调,文案中没有破折号(references/tells.md)。
  • 在审查中,保留页面上的每一条数据和每一个操作;可以移动或降级,但不要移除。
  • 当没有任何内容给用户造成成本时,“无需更改”是一个完整的审查。绝不要仅仅为了审美而更改。

报告

使用平实的语言,简短:

  • 你构建或更改了什么,每项都与用户的任务及其节省的代价相关联;在审查中,每一项更改,无论多小(大小、间距、颜色),例如以简短的表格形式列出“之前”、“现在”以及它为用户节省了什么:不命名的更改就是违背承诺;
  • 你的假设,最多三项,以及如果某个假设错误会有什么变化;
  • 你检查了什么:渲染前后的测量问题,以及首次浏览与你意图的比较;
  • 你没有测试的内容(手势、真实手机、Safari、屏幕阅读器),以及渲染是否运行。

没有分数、ID 或规则编号。如果项目没有 DESIGN-CONTEXT.md,主动提出根据你的假设编写一个。

相关技能