Communitygithub.com

高级设计评审

用基于证据的高级设计评审对UI设计提案或现有界面进行压力测试,生成可实施的细化规范和增删改留清单。

高级设计评审 是什么?

这个技能旨在将模糊的“把它改得更好”转化为可证伪的设计决策。它通过结构化的评审流程,输出一份详细的评审报告,内容包括TL;DR、结构批评、信息架构、交互语义、视觉与动效、可访问性与国际化,以及一个细化规范,最后附带一份“删除/新增/修改/保留”清单。该技能支持在Claude Code、Cursor等AI代理平台上使用,要求用户提供设计令牌、现有组件、实现截图和平台约束等输入。它的核心价值在于提供具体、可操作的反馈,避免空泛的套话,并强调基于证据的决策——每项主张都必须引用文件、令牌或参考模式。同时,它严格定义了适用与不适用场景,比如不适合只调整边距或颜色的小改动,也不适用于构建交互原型或非UI代码审查。输出包括提案和评审文档,能帮助开发者和设计师在实施前发现潜在问题,提升UI设计质量。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jamesonedge/design-agent-kit/tree/main/skills/senior-design-review

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

高级设计评审 是做什么的?

将模糊的“把它改得更好”转化为可证伪的设计决策。输出是一份结构化的评审报告,引用真实文件、令牌和参考模式,随后是可工程师直接实施的规范。

何时使用

当用户要求以下任意一项时使用此技能:

  • 审查、批评或“压力测试”现有界面、流程或组件;
  • 评估他人(例如初级设计师或其他智能体)撰写的提案;
  • 在实施前决定删除、新增、修改或保留哪些内容;
  • 通过截图纠正移动端流程。

何时不使用

  • 小型、局部的修复,例如“增加这张卡片的边距”或“将此标签改为‘保存’”。应直接进行修改;完整的评审是噪音。
  • 构建交互原型。应使用交互式模型流程;此技能可为其提供输入。
  • 非UI代码审查、性能调优或后端设计。
  • 品牌或营销策略,没有具体界面的。

输入

收集仓库或用户可以安全提供的内容。缺少的输入将列为开放问题,不得凭空捏造。

  1. 设计令牌(颜色、字体、间距、圆角、动效)——文件路径。
  2. 目标应与之相似的规范现有组件。
  3. 先前批准的类似工作示例(可选,但有用)。
  4. 目标实现和/或截图。
  5. 已知的平台约束(导航模型、操作系统惯例、最低目标)。
  6. 用户的投诉,尽可能逐字引用。

上下文填写表单见 templates/context.md。

工作流程

1. 起草一份明确的初步提案

在任何批评之前,使用 templates/proposal.md 写下提案:问题、引用痛点、设计原则、信息架构草图、操作和开放问题。如果用户提供了提案,则原样使用作为输入。

2. 以全新的视角进行评审

评审者按以下顺序阅读:令牌、规范组件、先前示例、目标实现/截图、平台约束,然后才是提案。先阅读证据可防止受提案框架的影响。

  • 如果你的运行环境能启动一个真正独立的上下文(一个子智能体或不共享历史记录的新会话),请使用它并明确说明。
  • 如果不能,自行进行一次独立的审查,并诚实地标注:“单智能体独立审查——非独立同行评审。”

评审者角色是质量透镜(一位要求严格的高级产品设计师)。切勿代替角色声称任何工作经历、资质或经验年限。

3. 撰写评审报告

使用 templates/review.md。各部分如下:

  • TL;DR — 三至五行:结论和最重要的变更。
  • A. 结构批评 — 这是否是合适的界面/流程?
  • B. 信息架构与层级
  • C. 操作语义 — 主要、次要、破坏性、撤销、命名。
  • D. 机制与手势 — 点击、滑动、拖拽、键盘、可发现性。
  • E. 视觉与动效 — 令牌、节奏、密度、过渡。
  • F. 可访问性与国际化
  • G. 缺失的问题 — 目标为五个,但只包含有意义的问题。
  • H. 细化规范 以及 删除/新增/修改/保留清单。

每个透镜的详细指南见 references/review-lenses.md。可访问性和国际化检查清单见 references/accessibility-i18n.md。

使评审值得阅读的规则

  • 压力测试,而非走过场。 每项主张都需要一个具体的引用:文件路径、令牌名称、组件名称、截图区域或命名的参考模式(例如“iOS Mail 滑动存档”)。
  • 不说空话。 “改善视觉层级”不是发现。“‘截止日期’使用 text.secondary 且与标题大小相同,因此截止时间在扫视时不可见”才是发现。
  • 不强制删除。 如果当前结构正确,请说明并记录一个有理有据的保留。为改变而改变是缺陷。
  • 不编造数据。 除非你计算或测量过并展示方法,否则不要说明对比度、WCAG 通过/失败级别或性能数据。否则应写“未测量——请使用对比度工具验证”。
  • 覆盖各种状态。 空、加载、错误、离线、长内容和非常短的内容。
  • 非颜色信号。 状态绝不能仅依赖颜色。
  • 键盘和屏幕阅读器路径适用于每项操作,包括自定义手势。
  • 文本扩展(为多种语言允许约 30-40% 的更长的字符串)以及相关的从右到左布局。
  • 针对每个动画的减少动效替代方案。

可选:与之前的工作比较

如果存在先前批准的示例,请在 E 或 H 部分下添加简短的“与先前工作的一致性”备注。这很有用,但非强制。

输出

  • proposal.md(如果你起草的)
  • review.md 包含 TL;DR、A-H 和清单
  • 向用户提供简短总结:结论、前三项更改,以及阻碍实施的开放问题

验收检查

见 references/review-lenses.md#acceptance-checks。如果清单的任何一行缺乏理由和引用,或者将未测量的数字陈述为事实,则评审不合格。

许可声明

以下声明随此独立技能及其支持文件一起传播。

MIT License

版权所有 (c) 2026 jamesonedge

特此免费授予任何获得本软件及相关文档文件(“软件”)副本的人,不受限制地处理本软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,并允许向提供本软件的人这样做,前提是满足以下条件:

上述版权声明和本许可声明应包含在本软件的所有副本或实质性部分中。

本软件按“原样”提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途的适用性和不侵权的保证。在任何情况下,作者或版权持有人均不对任何索赔、损害或其他责任负责,无论此类责任是合同、侵权行为或其他方式引起的,与本软件或本软件的使用或其他交易有关。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能