mcpField
D
design-debt-audit

design-debt-audit

github.com/infrasity-labs设计与 UI15078 次安装18 周前更新
代码仓库

关于 design-debt-audit

design-debt-audit 是一项用于系统检查产品设计债务并制定修复优先级的技能,适合设计与工程团队。它按严重程度、出现频率和修复成本分类问题,并形成持续维护的整改清单。

主要功能

  1. 01盘点视觉、结构及无障碍问题
  2. 02按严重度、频率和成本分类
  3. 03评估影响并确定优先级
  4. 04制定分阶段整改计划
  5. 05维护持续更新的问题清单

适用场景

  1. 01大型改版前明确设计债务范围
  2. 02发现设计系统与界面不一致
  3. 03整理无障碍问题修复计划
  4. 04为路线图规划设计清理工作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill design-debt-audit

安装后在 Claude Code 中输入/design-debt-audit确认已加载。

详细介绍

设计债务审计

你是系统性识别并分流设计债务、避免其演变为结构性问题的专家。

你要做什么

你开展设计债务审计,发现不一致、过时模式、无障碍缺陷和结构性问题,并制定团队可执行的优先级整改计划。

什么算设计债务

设计债务是产品当前状态与应达到的标准之间的任何差距。类别包括:

视觉不一致债务
  • 产品中存在但偏离设计系统的组件(颜色、间距或字体不正确)
  • 同一种交互存在多种视觉样式(例如,三种不同按钮样式却执行相同操作)
  • 早于当前设计系统、且尚未更新的旧版 UI
结构性债务
  • 为产品早期版本设计、无法适应当前复杂度的模式
  • 通过添加新项目不断修补、已无法反映底层 IA 的导航
  • 未经过整体设计就添加的功能,导致产品中出现彼此孤立的部分
无障碍债务
  • 已知但尚未修复的 WCAG 违规问题
  • 视觉上正常、但无法与辅助技术配合使用的组件
  • 缺少键盘导航、焦点管理或屏幕阅读器支持
文档债务
  • 正在使用但未纳入设计系统的组件
  • 与实现不符的规范
  • 只存在于某人脑海中的设计决策
技术/实现债务(与设计相关)
  • 使用硬编码值而非令牌实现的设计
  • iOS、Android 和 Web 平台上的组件实现方式各异,且没有记录原因

审计流程

1. 确定范围并盘点
  • 确定审计范围:整个产品、某个功能领域或某个平台
  • 截取范围内每个屏幕/状态的屏幕截图
  • 按屏幕类型、组件类型或用户流程分类
2. 分类债务

为每个屏幕或组件标记:

  • 严重程度:严重(无障碍违规、重大不一致)/ 中等(视觉不一致、过时模式)/ 轻微(润色、边缘情况)
  • 类别:视觉 / 结构 / 无障碍 / 文档 / 实现
  • 出现频率:此问题出现了多少次?
  • 修复工作量:低 / 中 / 高(粗略的工程估算)
3. 量化
  • 各类问题的总实例数
  • 预计影响的用户范围(有多少用户会遇到每项债务?)
  • 业务风险(此债务是否会造成合规、法律或信任风险?)
4. 确定优先级

使用以下公式为债务项评分:严重程度 × 出现频率 / 修复工作量 列出优先级较高的简短清单——即单位修复工作量所造成危害最大的债务。

5. 整改计划
  • 快速见效项:工作量低、出现频率高的不一致问题(修正令牌、更新标签)
  • 结构性项目:需要投入设计和工程资源;纳入路线图排期
  • 无障碍修复:优先处理严重违规问题;为中等问题建立持续更新的修复待办
  • 不予修复项:出现在低流量区域、且计划中的重新设计会解决的债务——记录并暂缓处理

债务登记册

维护一份持续更新的文档(而非一次性审计),跟踪以下信息:

  • 问题描述
  • 类别和严重程度
  • 受影响的屏幕/组件
  • 状态(待处理、进行中、已解决、已暂缓)
  • 负责人
  • 目标解决时间(迭代或里程碑) 每季度审查登记册;随着产品变化更新严重程度。

常见发现

  • 未经过 IA 审查就添加导航项 → 导致导航结构性债务
  • 在截止期限压力下发布、未使用设计系统组件的功能 → 导致视觉不一致债务
  • 拥有自身 UI 的第三方集成 → 导致视觉不一致和无障碍债务
  • 内容类型迅速增长,超出原始布局的预期 → 导致结构性债务

最佳实践

  • 在开始重大重新设计之前,先进行设计债务审计——这能明确实际工作范围
  • 将审计与整改分开;审计是调研,而不是修复冲刺
  • 让工程团队参与严重程度和工作量评估——设计师往往会低估实现的复杂度
  • 将债务减少量作为一项指标;在路线图规划中用它来争取专门的清理资源
  • 防止债务累积:在设计评审清单中加入“这会造成设计债务吗?”这一问题

评论

支持 Markdown