design-polish 是一个设计打磨技能(v2.0),把设计知识库、实时视觉对比、WCAG 无障碍自动检查与趋势检索整合到一次流程中。它通过 /design-polish 命令执行。
【用途】 对现有前端项目进行系统化的 UI 打磨:检测服务类型、截图当前界面、对照参考站点与设计知识库找出差距,并按优先级给出可执行的改进建议,必要时直接应用到代码。
【主要能力】
- 设计知识库:knowledge/ 目录提供服务类型 UI 规则、组件检查清单、UX 规则(Markdown 直接读取)。
- 数据检索:data/ 目录包含 66 种设计风格、96 套配色、57 种字体排印、13 种技术栈指南(JSON + BM25 检索),由 scripts/search.cjs(Node.js BM25 搜索引擎)执行。
- 实时视觉对比:通过 Puppeteer 截图当前页面与参考站点。
- WCAG 无障碍检查:基于 axe-core,检查颜色对比(文本 4.5:1、大文本 3:1、UI 组件 3:1)、最小文本尺寸(建议 12px 以上)、触控目标(移动端 44x44px)、链接区分等。
- 趋势检索:通过 WebSearch 按功能单元检索参考(如 site:mobbin.com onboarding flow)。
- Gap 分析:从布局、字体、颜色、交互、组件、状态、无障碍、服务类型适配性、风格匹配等维度对比。
- 8 级优先级改进建议:P1 无障碍(CRITICAL)、P2 触控/交互(CRITICAL)、P3 性能(HIGH)、P4 布局/响应式(HIGH)、P5 字体/颜色(MEDIUM)、P6 动画(MEDIUM)、P7 风格适配性(MEDIUM)、P8 图表/数据(LOW)。
【使用方式】 命令与参数:
- /design-polish:整体自动打磨 + WCAG 检查
- /design-polish --apply:打磨并应用代码
- /design-polish --wcag-only:仅做 WCAG 无障碍检查
- /design-polish --no-wcag:跳过 WCAG 检查
- $1(可选):参考站点,未指定时按项目类型自动选择
- $2(可选):功能关键词,未指定时做整体打磨 示例:/design-polish mobbin、/design-polish godly hero、/design-polish --apply godly hero
执行流程:前置条件检查 → 0 阶段项目分析与服务类型检测及截图 → 1 阶段 WCAG 检查 → 1.5 阶段加载设计知识 → 2 阶段选择参考站点 → 3 阶段趋势检索与参考截图 → 4 阶段 Gap 分析 → 5 阶段生成改进建议 → 6 阶段输出结果 → 7 阶段代码应用(仅 --apply)。
前置条件:需先启动开发服务器(如 npm run dev),并确认插件依赖已安装(cd ~/.claude/plugins/marketplaces/design-polish && npm install),以及 Node.js 可用。
【适用场景】 Web 与 App 界面打磨、SaaS 仪表盘、电商、医疗、金融、教育、作品集、政府服务、AI 聊天、餐饮、旅游、房产、游戏、新闻、社交、健身、奢侈品牌、创意机构、健康养生、管理后台、开发者工具等 20 类服务类型的 UI 优化;也可仅用于无障碍合规检查。
【限制】
- 需要开发服务器运行、插件依赖安装、Node.js 环境。
- 代码应用(--apply)不会安装新库、不做大规模重构、不引入破坏性变更;需要新库的改动会列为手动项。
- 参考站点检索失败时会自动降级(改用替代站点、去掉 site: 或泛化关键词)。
- 具体收费、价格、平台支持范围等资料暂未提供。