以 skill 自身的术语
一个用于处理现有设计系统的斜杠命令 skill,支持三种模式:审计、文档化或扩展。审计模式会报告命名一致性、token 覆盖率和组件完整度,并按 100 分制评分该系统。文档模式会生成组件规范,包含描述、变体、属性、状态、无障碍性以及使用建议与禁忌。
扩展模式会针对系统中已有组件,提出一个新组件或模式的建议,列出其将使用的 token 以及引发的待解决问题。它涵盖设计 token、组件和模式,并在已连接设计工具或知识库时可从中读取信息。读者对象是负责维护系统一致性的设计师和开发者。
它产出什么
- 以按优先级排序的行动建议结尾的设计系统审计报告
- 包含属性、类型、默认值和描述的属性表的组件文档
- 以所解决问题开篇的新组件提案
工作方式
- 01从参数中选择模式
该命令接受一个模式加一个目标:审计整个系统,或对单个组件或模式运行文档化或扩展。
- 02从三个维度运行审计
审计会检查命名一致性、相对于硬编码值统计的 token 覆盖率,以及每个组件的完整度,然后列出优先行动。
- 03编写组件规范
文档模式会填充一个模板,内容包括描述、变体、带类型和默认值的属性、状态、无障碍性以及一个使用建议与禁忌表。
- 04针对现有系统提出扩展建议
扩展模式会将新想法与相关组件进行比较,然后提出 API、变体、状态以及该组件将消耗的确切 token。
- 05在有已连接工具时从中提取信息
在连接设计工具后,该 skill 可以提取组件属性和图层结构用于文档化,并在 Figma 中检查命名、变体和 token 使用情况。