用途
Polish 是一个用于产品发布前最终质量打磨的技能,目标是在功能完成后进行最后一轮细致检查,修复对齐、间距、一致性和微细节问题,让作品从“能用”提升到“精致”。它强调:打磨是最后一步,不是第一步;不要在功能尚未完成时进行打磨。
主要能力
该技能覆盖以下打磨维度:
- 视觉对齐与间距:像素级对齐、统一使用间距刻度、光学对齐、响应式一致性、基线网格对齐。
- 排版精修:层级一致性、行宽(正文 45-75 字符)、行高、孤行寡行、断词、字距、字体加载无闪烁。
- 颜色与对比度:对比度符合 WCAG、统一使用设计令牌、主题一致性、颜色语义一致、焦点指示可见、中性色带轻微色调、避免在彩色背景上使用灰色文字。
- 交互状态:默认、悬停、焦点、激活、禁用、加载、错误、成功等状态齐全。
- 微交互与过渡:过渡时长 150-300ms、统一缓动(ease-out-quart/quint/expo,避免弹跳或弹性)、60fps、只动画 transform 和 opacity、尊重 prefers-reduced-motion。
- 内容与文案:术语一致、大小写一致、语法拼写、长度适当、标点一致。
- 图标与图片:风格一致、尺寸一致、对齐、alt 文本、加载不引起布局偏移、支持 Retina。
- 表单与输入:标签一致、必填指示、错误信息、Tab 顺序、自动聚焦、验证时机一致。
- 边界与错误状态:加载、空状态、错误、成功、超长内容、无内容、离线处理。
- 响应式:所有断点、触控目标最小 44x44px、移动端文字不小于 14px、无横向滚动、合理重排。
- 性能:快速初始加载、无布局偏移、交互流畅、图片优化、懒加载。
- 代码质量:移除 console 日志、注释代码、未使用导入、命名一致、类型安全、无障碍 ARIA 与语义 HTML。
使用方式
- 强制准备:调用 /impeccable,其中包含设计原则、反模式和上下文收集协议。若尚无设计上下文,必须先运行 /impeccable teach。同时收集质量基准(MVP 还是旗舰功能)。
- 设计系统发现:查找设计系统文档、组件库、样式指南或令牌定义,研究核心模式(颜色令牌、间距刻度、排版样式、组件 API),记录约定,识别偏离。若存在设计系统,打磨应使功能与其对齐;若不存在,则依据代码库中可见的约定进行打磨。
- 打磨前评估:审查功能完整性、需保留的已知问题(用 TODO 标记)、质量基准、发布时间。识别打磨区域:视觉不一致、间距与对齐问题、交互状态缺失、文案不一致、边界与错误状态、加载与过渡流畅度。
- 系统性打磨:按上述维度逐项检查。
- 打磨清单:逐项核对视觉对齐、间距令牌、排版层级、交互状态、过渡、文案、图标、表单、错误/加载/空状态、触控目标、对比度、键盘导航、焦点指示、控制台无错误、无布局偏移、浏览器兼容、减少动效、代码整洁。
- 最终验证:亲自使用功能、在真实设备测试、请他人复查、对照设计、检查所有状态。
- 清理:替换自定义实现为设计系统组件、删除孤立代码、合并令牌、验证 DRY。
适用场景
适用于功能已完成后、上线前的收尾阶段,尤其是需要将界面从“可用”提升到“精致”的场景。用户提到 polish、finishing 等关键词时使用。
限制
- 不要在功能未完成时打磨。
- 如果 30 分钟后就要发布,不要花数小时打磨(需分诊)。
- 打磨时不要引入 bug(需充分测试)。
- 不要忽视系统性问题(若间距到处都不对,应修复系统)。
- 不要只完美一处而其他粗糙(保持质量一致)。
- 不要在设计系统已有等价组件时创建一次性组件。
- 不要硬编码应使用设计令牌的值。
关于收费、价格、平台支持等具体信息,资料中暂未提供。