SuperAPI AI 工具集

theme-audit

设计与创作

查看项目

更新于 10-16 01:31

技能介绍

用途:审计设计系统在多主题(如浅色、深色、品牌变体)下的主题覆盖与视觉一致性,确认每个组件消费的令牌在每个声称支持的主题中都存在且正确定义。

主要能力:发现系统实际定义的主题(DTCG resolver 上下文、CSS 自定义属性作用域、SCSS 变量映射、JS 主题对象、Tailwind 模式、Figma 变量模式);清点语义层与组件层令牌及各自主题中的改写情况;检查主题覆盖缺口(定义于某主题而缺失于另一主题、主题相关令牌未主题化);检查组件层传播失败(组件令牌绕过语义层直接引用原始值,且未按主题单独覆盖);逐主题做内部一致性检查(含按解析值计算对比度,基准为 WCAG 2.2 AA,必要时按团队义务使用 WCAG 2.1 AA);验证 DTCG resolver 的上下文覆盖与集合组合;识别切换主题时易出问题的模式。产出带严重度(关键/高/中/低)的问题报告。

使用方式:技能读取 .ds-ops-config.yml 中的 system.theming、severity、integrations.style_dictionary、integrations.figma、recurring 配置。若 system.theming 为 false 则直接退出。开始前需确认 frontmatter 中 references 的每个路径相对 SKILL.md 存在,若有缺失应停止并提示按 1-INSTALL.md 重新安装并运行 verify-install.sh,除非用户明确同意无参考资料继续。先发现并确认主题范围,再依次执行令牌清点、覆盖检查、组件层传播检查、逐主题一致性检查、resolver 校验与切换回归检查。

适用场景:多主题设计系统的令牌覆盖率审计、主题切换前的发布检查、深色模式或品牌变体上线前的风险排查。

限制:资料未提供具体安装命令、价格或效果数据;继承默认值不等于缺失,仅主题相关令牌(颜色、阴影、边框色等)的继承才标记为缺口;带 alpha 的颜色需先与背景合成再计算对比度,背景未知时应报告为未计算而非猜测;组件层泄漏仅在未按主题覆盖时视为关键。结构校验由 schema-validator 负责,硬编码值的逐文件清单由 token-compliance 负责,本技能引用而非重复。