
Flawless UI/UX 推出面向编码代理的设计技能与检查 CLI
来源标题:Flawless UI-UX Skill 3.0.0
Flawless UI/UX 发布了一套工具,包含引导编码代理设计并实现界面的技能,以及一个本地 CLI,用于在修正后收集证据并检查界面变化。该工具支持 Codex 和 OpenCode,CLI 要求 Node 22.12+,可通过 npx、pnpm dlx 或 bunx 安装,支持按代理、全局或指定项目安装。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
围绕产品设计界面,再根据结果不断打磨。
flawless-ui-ux 帮助编码智能体创建、重新设计并打磨 Web 界面,让界面的视觉风格契合产品本身。其中包含一套指导设计与实现的 skill,以及一个本地 CLI,用来收集证据、检查修正后的变化。它支持 Codex 和 OpenCode。
在项目目录中,按你使用的包管理器安装适用于 Codex 和 OpenCode 的 skill。CLI 需要 Node 22.12+,无需检出代码,也不需要 Bash。
npx flawless-ui-ux@latest install pnpm dlx flawless-ui-ux@latest install bunx flawless-ui-ux@latest install
运行上述任意一条命令即可。下面的示例使用 npx;如需执行同样的操作,将其替换为 pnpm dlx 或 bunx。
如需为指定智能体安装,或在多个项目之间安装:
npx flawless-ui-ux install --codex npx flawless-ui-ux install --opencode --global
默认会为当前项目中的两个智能体都安装。使用 --codex、--opencode 或 --all-agents 选择目标。--global 会明确安装到用户配置目录;--project <directory> 用于选择另一个项目。如安装后未被发现,请启动一个新的智能体会话。
已有安装永远不会被覆盖,包括链接和本地改动。复制前会先检查所有选定的目标位置。重新安装前,请自行查看或移除已有安装。全局路径遵循 CODEX_HOME 和 XDG_CONFIG_HOME;项目路径分别为 Codex 的 .agents/skills/flawless-ui-ux 和 OpenCode 的 .opencode/skills/flawless-ui-ux。
bash ./install.sh --codex --project bash ./install.sh --opencode --project
请在目标项目目录中运行这些命令;如果代码检出在其他位置,请使用脚本的绝对路径。使用 --all-agents 可同时安装到两者。旧版 Bash 脚本在本地安装时必须提供 --project,否则会安装到全局。在 Windows 上,这一替代方式需要 Git Bash 或 WSL。
在 Codex 中,选择 $flawless-ui-ux 并描述你想构建的内容:
Use $flawless-ui-ux to build a financial dashboard for freelancers.
在 OpenCode 中,按名称请求已安装的 skill。在同一对话中继续开发,以完善结果:
该 skill 将产品意图与构图、排版、色彩、密度、图像和交互联系起来。它会结合你项目的技术栈和现有约束工作,并在需要回答设计问题时使用针对性的参考资料。打磨可以增强存在感、重新分配视觉重点或提升完成度;它并不规定某种通用的审美。
你可以直接使用 CLI,也可以让智能体在任务中运行它。设计与修正仍由你和你的智能体负责;CLI 提供观察结果和对比。
从项目上下文或选定的源文件开始:
npx flawless-ui-ux context --project . --format json npx flawless-ui-ux inspect --project . --source src/App.tsx --format json
如需进行渲染检查,请启动应用,并使用以下命令之一准备浏览器:
npm
npx playwright@1.64.1 install chromium
pnpm
pnpm dlx playwright@1.64.1 install chromium
Bun
bunx playwright@1.64.1 install chromium
该版本与 CLI 的浏览器适配器相匹配。或者,通过 --browser-executable 或 FLAWLESS_BROWSER_EXECUTABLE 选择一个已安装的兼容 Chromium 可执行文件。
检查实际的开发服务器 URL,并保存基线:
npx flawless-ui-ux inspect --project . --source src/App.tsx --url http://localhost:5173 --output ../app-before --format json
可重复使用 --source 添加更多文件,使用 --selector 指定特定区域,或重复使用 --viewport WIDTHxHEIGHT 选择宽度。默认采样为 1440×900 和 390×844。
查看检查结果,进行相关修正,然后按已保存的范围重复检查:
npx flawless-ui-ux verify ../app-before/run.json --output ../app-after --format json
验证会将问题分为持续存在、新增和不再观察到三类。如果确认过的目标缺失或条件发生变化,结果会保持未验证状态,而不会被计为已修复。两次运行之间请保持相同的浏览器选择。
不指定 --output 时,结果输出到 stdout。指定后,新目录会接收 run.json 以及所有截图;父目录必须已存在。已有输出目录永远不会被覆盖。如果只是做审查工作,请将产物保存在项目之外。
领域 证据 无障碍 选定的 axe 对比度和可访问名称规则,保留上游证据和不完整结果。 可读性与布局 在指定宽度下计算出的文本大小和水平溢出情况。 资源与运行时 采样状态下可见的损坏图片和未捕获的 JavaScript 错误。 文案与图标 精确的重复短语和箭头提示,供上下文审查。 源码 选定文件中的字面像素字体大小和箭头/图标提示。
小字号、溢出和重复需要结合判断。仅字号小并不构成 WCAG 失败,箭头数量也不能决定界面是否良好。该 skill 的上下文审查会考虑每个元素对产品的贡献。
检查不会编辑源码、启动服务器、下载浏览器或提交表单。这些初始状态采样不能确立完整的 WCAG 合规性、键盘操作路径、业务流程正确性或视觉质量。
在本地检出中使用固定版本的 Bun 工具链:
bun install --frozen-lockfile bun test
有关浏览器测试夹具、分发检查和 Windows/Ubuntu CI 的信息,请参阅测试指南。自动化测试验证运行时和打包行为;设计质量和耗时方面的同主机/同模型评估仍在手动评估套件中待进行。
CLI 选项、保存的上下文和对比限制 设计理念与产品契约 工作流指南 架构 交付计划 变更日志 许可证 MIT。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。