SuperAPI AI 工具集

tt-polish

通用与其它

查看项目

更新于 10-15 17:25

技能介绍

tt-polish 是一个两阶段打磨流程,而非构建器。它假定 TUX token 合规性已基本到位;若尚未到位,需先运行 /tt-impeccable extract。

用途:对 TikTok 原生(TUX)界面做最终视觉与合规打磨,也可用于“token 正确但气质不对”的界面。

上下文检查:若项目根目录存在 .tt-impeccable.md 则读取其中的保真度层级和设计上下文;若不存在,则依据代码库推断——移动优先 390px 为 Strict TUX-native,暗色 #000000 桌面端为 TT Style。仅当层级确实模糊时才询问。Phase 1 规则主要适用于 Strict TUX-native 浅色主题界面,Phase 2 对两种层级均适用。

Phase 1:视觉提升。加载 reference/polish-rules.md 并系统应用全部 13 条规则,涵盖:标题左对齐并加副标题与顶部径向渐变光晕;页面最大字号低于 20px 时设一个 24–32px 标题并压缩最小正文至 12px;页面水平边距设为 20px、组间距 24–32px;卡片或列表单元格图标替换为上下文 emoji 并用 oklch() 约 5% 色调作背景;圆角升级为 L1 嵌套 14px、L2 浮层 26px;2–5 个 emoji 列表单元格改为两列卡片网格;同类卡片网格统一内部结构;分隔线替换为渐变边缘;屏幕出现 ≥3 种非中性色时 CTA 按钮改为黑底白字;图标尺寸统一为 24px 或 16px;移除大于 30px 的实心非中性填充容器并提升标题为 24px/700;加入入场动画(卡片 fadeUp 错峰 40ms、浮层 fadeScale 220ms、chips fadeIn 错峰 30ms,prefers-reduced-motion 下禁用位移与缩放);弱化分组标签至 13px/600/text-2。TT Style 界面中规则 2、3、5、10、11 仍适用,规则 1、7、12 需适配。

Phase 2:合规扫描。2a 检查 token 漂移,包括 border 相关属性、:hover 边框、backdrop-filter、小字号 letter-spacing、非交互元素上的强调色、硬编码色值、非 4px 网格间距、非 TUX 表圆角与阴影、非 TikTok Sans/系统字体等。2b 确认交互状态齐全:默认、按下、focus-visible、禁用、加载、错误、成功,且触控目标最小 44×44px。2c 复核入场动画与 prefers-reduced-motion。

用法:完成 Phase 1 与 Phase 2 后,按检查清单核对渐变与光晕、排版、间距、卡片与 emoji、填充与色彩克制、表面与结构、渐变边缘、图标、层级与动画,并自行交互验证所有状态与流程,运行 /tt-audit 确认健康分提升,再运行 /tt-critique 验证无anti-pattern。

限制:它是打磨工具而非构建器,依赖已有 TUX token 合规基础;部分细节需查阅 polish-rules.md 与 TUX 规范文件,本资料未提供完整 CSS 和取值表;未提供收费、价格与平台信息。