SuperAPI AI 工具集

token-audit

设计与创作

查看项目

更新于 10-16 01:31

技能介绍

用途:审计设计令牌架构,检查 primitives、semantics 及可选的 component 层是否清晰,找出令牌结构对使用团队造成阻碍之处;不强制统一命名规范。

主要能力:发现令牌来源(CSS 自定义属性、SCSS 变量、JSON/YAML、DTCG、Style Dictionary、Tailwind、TS/JS 对象、Figma/Tokens Studio);映射层级结构;检查命名描述性、层级泄漏、歧义名、约定一致性、平台后缀、语义或组件层的硬编码值、重复原始值、越层引用;检查交互状态与主题别名覆盖;做一次孤立令牌检测,并说明仅表示“仓库内无消费者”,外部消费方未核实。输出 PASS/WARN/FAIL 及证据(令牌路径与文件行号),严重度分为 Critical/High/Medium/Low。

使用方式:先确认 frontmatter 引用存在,否则安装不完整,需按 1-INSTALL.md 重装并运行 verify-install.sh;可选读取 .ds-ops-config.yml 做严重度覆盖、主题、样式、Style Dictionary/Terrazzo、Figma、GitHub 与定期对比配置。可从代码库自动发现令牌,或由用户提供 JSON、YAML、DTCG、Figma、CSS、SCSS、TS/JS、Tailwind 等来源。若用 Style Dictionary,可运行 npx style-dictionary build --config [path](或 npx terrazzo build)解析别名。

适用场景:设计系统或前端团队的令牌架构评审、重构前评估、定期趋势对比。

限制:缺少组件层不算问题;无值输入时只能做命名与结构审计;孤立结论不覆盖未扫描的消费仓库;收费、价格等信息暂未提供。