跳转到使用指南
Design Token Audit作者 owl-listener

Design Token Audit Skill.

找出现有设计变量被绕过或使用不一致的位置。

  • 设计变量审计
  • 迁移
源文件解读 · design-token-auditSKILL.md
任务 找出现有设计变量被绕过或使用不一致的位置。 产出 说明设计变量采用情况和实际检查范围的审计摘要。 开始前的准备 源文件将初始设计变量定义交给独立的 design-token skill。
编辑摘要 · 源文件核查于 2026-11-02 · 非生成示例

01 功能说明

找出现有设计变量被绕过或使用不一致的位置

审计设计文件与代码中的设计变量覆盖率、不一致和缺口,并制定有优先级的迁移计划。

基于来源的工作流并非执行基准测试

工作方法

Design Token Audit 检查产品如何使用现有设计变量系统。它查找硬编码的颜色、间距和其他视觉值,核对所用变量层级是否正确,并识别冗余或已弃用变量。目标是产出具体的差异清单,供团队迁移。

源文件区分覆盖情况、一致性和缺口。某个值可能绕过变量、使用错误的语义角色,也可能暴露现有系统确实未覆盖的需求。将这些情况分开,可以避免清理时盲目把每个字面值替换为看起来最接近的变量。

预期交付物

  • 说明设计变量采用情况和实际检查范围的审计摘要。
  • 硬编码值及建议替换变量的分类清单。
  • 缺失变量的建议和按优先级排序的迁移计划。
查看示例简报

从简报到审查

  1. 01
    盘点视觉值

    同时阅读相关设计文件和实现代码。提取颜色、间距、文字排版及其他属性,再按可比较的类别分组。

  2. 02
    映射到现有系统

    将使用情况对应到现有变量及其层级。标记硬编码值、不一致的角色、冗余定义和对已弃用变量的引用。

  3. 03
    区分缺口与偏离

    识别可能需要新增变量的情况,而不是强行采用不合适的替代。按频率和影响排序,优先处理影响较大的颜色与间距问题。

  4. 04
    规划迁移

    产出可执行的替换清单和建议。说明检查范围,让后续审计能基于一致范围比较采用情况。

02 适用场景

适合什么场景

源文件将初始设计变量定义交给独立的 design-token skill。

适合的场景

  • 系统已存在,但使用逐渐偏离组件越来越多地绕过约定的设计变量基础。
  • 迁移需要证据团队希望先得到有优先级的映射,再替换字面值或已弃用名称。

需要检查的限制

  • 已有基础源文件将初始设计变量定义交给独立的 design-token skill。
  • 覆盖率必须可量化采用百分比需要明确检查范围和分母;局部搜索不等于覆盖整个产品。

请提供这些输入

  • 设计变量定义提供当前全局、语义和组件级变量值。
  • 实现范围指出审计应覆盖的代码和设计文件。
  • 已知迁移包含团队已认可的弃用名称或替换指导。

03 关键决策

影响结果的关键选择

  1. 具体替换

    审计结果将硬编码值与建议的变量名称关联起来。

  2. 识别缺口

    真正缺失的角色可以与意外偏离区分开。

  3. 可重复的后续检查

    有明确范围的审计为持续跟踪采用情况提供基础。

04 示例任务

从一份具体的需求开始

以下示例任务说明尚未经过测试。使用前请检查该技能的设置。

查看源文件和环境要求

提供当前全局、语义和组件级变量值。

上游源文件
https://github.com/owl-listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/designer-toolkit/skills/design-token-audit/SKILL.md

下方链接会打开上游使用说明。使用前请查看仓库的环境配置要求;这不是安装命令。

先完成一项明确的交付物

运行该技能之前,请根据需要调整此需求中的范围、来源材料和约束。

示例简报
使用 design-token-audit 审计报表页面及其共享组件。阅读当前设计变量定义和对应设计规范。盘点颜色、间距和文字排版值,再将发现分类为硬编码值、错误语义变量、已弃用变量或缺失角色。只有现有变量确实合适时,才提出准确替换建议。优先处理重复出现、影响较大的问题,产出包含受影响位置的迁移清单。说明检查范围,以及覆盖百分比的计算方式。本轮只做审计,不执行替换。

检查结果

根据以下可观察标准检查实际输出。

  • 审计结果指出真实使用位置和相关变量类别。
  • 建议替换匹配语义角色,而不只是数值相等。
  • 覆盖率声明说明范围和计数方法。

OpenDesign 为编码智能体提供本地设计工作区。此条目并不表示该技能已内置,也不表示其中包含其外部工具、凭据和软件依赖项。

05 来源与许可证

来源与许可证

本页面描述的是下方链接所指向的固定来源修订版本。上游行为和要求可能会发生变化。

来源所有者
owl-listener
技能文件
SKILL.md
许可证
MIT
已审查的快照
2026-11-02 · 9a6930cf84a8
编辑来源摘要
找出现有设计变量被绕过或使用不一致的位置。

由 OpenDesign 根据所链接来源撰写的原创摘要。仓库星标数只是带有时间属性的受欢迎程度指标,并不代表技能使用量或质量评分。

06 开始前的问题

开始前可能想问

它会创建第一套设计变量系统吗?

源文件聚焦审计现有变量,初始定义交给独立 skill。

所有无法匹配的值都应变成新变量吗?

审计会区分缺口与不一致,只有使用情况暴露出缺失角色时才建议新增变量。

它除了代码也检查设计文件吗?

是的。源文件建议同时检查二者,以发现规范和实现之间的差异。

OpenDesign

让需求和设计工作保存在一起。

将简报、来源材料和设计工作集中保存在本地工作区中。将该技能添加到工作流程前,请检查其自身的设置说明。

上游源文件
https://github.com/owl-listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/designer-toolkit/skills/design-token-audit/SKILL.md