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