smokeeaasd/flawless-ui-ux

项目介绍

flawless-ui-ux 是一套给编程 Agent 用的 UI/UX 技能，外加一个独立的检查 CLI。它围绕产品受众、内容和视觉个性来指导界面设计，避免千篇一律的模板感。技能覆盖四种工作方式：新建界面、重设计现有界面、精修视觉细节，以及针对可读性、导航和可访问性做审查。CLI 负责收集项目上下文、检查源码或运行中的页面，并在修改后做对比；实际改动仍由 Agent 完成。

技能可安装到 Codex、Claude Code、Cursor、GitHub Copilot CLI、OpenCode、Kiro 等多个受支持的 Agent 宿主中。CLI 运行需要 Node 22.12 及以上版本。

快速使用

在项目目录下用 npm、pnpm 或 Bun 安装技能：

npx flawless-ui-ux@latest install

终端菜单里选择项目级或全局范围，勾选一个或多个 Agent，确认安装位置。非交互安装可直接传参：

npx flawless-ui-ux install --codex
npx flawless-ui-ux install --claude-code --global
npx flawless-ui-ux install --project ./app

--yes 会跳过菜单，默认安装到当前项目的所有受支持 Agent。安装后新开一个 Agent 会话，在请求中点名使用该技能，例如：

Use the flawless-ui-ux skill to build a financial dashboard for freelancers.

如需检查运行中的页面，先安装一次 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

对比结果会区分持续存在、新增和不再出现的问题。

检查范围与限制

CLI 默认采样 1440×900 和 390×844 两个视口，可用重复的 --viewport 指定其他尺寸。它会检查选定的 axe 对比度与可访问名称规则、计算后的字号与横向溢出、可见的破损图片、未捕获的 JavaScript 错误、重复文案以及箭头图标线索。这些采样不能证明完整的 WCAG 合规、完整的键盘操作流程或视觉质量；CLI 不会编辑文件、启动服务器或自行下载浏览器。

退出码含义：0 表示检查完成且无确认错误，1 表示检查完成但有确认错误，2 表示输入无效或请求范围未完整覆盖。用 --selector 可缩小到某个区域，重复 --source 可加入更多文件。

安装注意事项

重复安装会保留已有文件、本地修改和链接，因此重装前应先检查或移除旧版本。十二个受支持的 Agent 共用五份项目内技能副本：能发现 .agents/skills 的宿主使用共享副本，其余使用各自的原生目录。Grok Build 需要先信任文件夹才能看到项目技能，DeepSeek Harness 应从最近的 Git 根目录安装。具体路径和兼容性证据见安装约定和测试指南。Bash 安装脚本默认全局安装，本地安装必须加 --project；Windows 上需要 Git Bash 或 WSL。

HotRepo 点评

仓库在 2026 年 11 月 8 日记录了 101 颗 Star，当晚升至 112 颗；新项目榜的一条快照显示五小时窗口内净增 11 颗 Star 和 1 个 Fork。它没有全部语言日榜的名次记录，现有数据不足以说明它是热门项目。

更有参考价值的是围绕发布帖的讨论。有评论者用同一个落地页提示词，对比了这个技能和另外两个「去 AI 味」技能的实际产出，认为这类一次性技能能把人带到可迭代的起点，但很难一步到位 对比示例。也有人希望先看到演示，并质疑设计类技能究竟该如何评估 讨论；作者回应称正在补充示例 回复。仓库已经把手工评测和工作流指南作为方法说明的入口，因此要不要采用，更该先读这些评测材料，而不是看 Star 数。