design-review

用途

Design Review 是 ADS（agentic-design-system）中的判断所有者，而不是第二套执行循环。它用于评审实质性的视觉工作与请求的批评意见；对于小改动，只检查受影响的结果及邻近行为。仅复制编辑不需要研究、变体、完整状态矩阵或单独的评分器。评审需尊重 ADS 建立的任务预算与授权。

主要能力

建立评审目标：从请求、来源及现有 DESIGN.md 或指南中恢复当前简报、确切界面与保留清单，检查实际基线、组件与令牌。
按判断顺序评审：产品与任务契合、信息架构、参考与视觉方向、工艺、行为与交付。
执行验证：视觉验证（截图、并排比较、目标视口、状态差异、嵌套披露、模态表面、帮助披露）、设计审计（间距、颜色、排版、模式、交互、术语、完整性、偏好）、诚实性检查。
运行源码预检脚本：anti-pattern-check.py、state-check.py、accessibility-check.py，以及 run-capture.mjs 捕获实际路由。
呈现证据：返回任务结果、保留的基线、相关证据与已知缺口，区分本地准备、实际交付、人工验收与发布。

使用方式

该技能以 SKILL 形式提供，包含核心原则、参考文件与脚本。参考文件按需加载：typography.md、color.md、spacing.md、motion.md、mobile.md、anti-patterns.md、ux-writing.md。子代理根据构建内容读取相关参考文件。验证步骤包括：

视觉验证：截图渲染结果，与参考并排比较，检查目标视口，验证状态差异，展开嵌套披露，测试模态表面与帮助披露。
设计审计：间距、颜色、排版、模式、交互、术语、完整性、偏好检查。
诚实性检查：是否真正完成、是否符合简报、能否经受冷评审。
运行源码预检脚本：

python3 <skills-root>/design-review/scripts/anti-pattern-check.py <your-file.tsx>
python3 <skills-root>/design-review/scripts/state-check.py <your-file.tsx>
python3 <skills-root>/design-review/scripts/accessibility-check.py <your-file.tsx>

对于有意义的视觉更改，捕获实际路由：

node <skills-root>/agentic-design-system/scripts/run-capture.mjs "<running-route-url>" \
  --states default,loading,empty,error --out evidence/<slug>

呈现证据：使用可用的附件或已授权的可访问 URL，区分本地准备、实际交付、人工验收与发布。

适用场景

评审实质性视觉工作与请求的批评意见。
小改动仅检查受影响结果与邻近行为。
新布局或仪表盘、排版密集屏幕、颜色或主题工作、交互打磨、移动/响应式/应用/PWA 评审、界面文案或同一概念竞争名称等场景，按需加载对应参考文件。
需要独立批评者时，仅在授权且可用时使用；未解决的产品方向与品味保留人工判断。

限制

不执行第二套实现循环，仅做判断。
仅复制编辑不需要研究、变体、完整状态矩阵或单独评分器。
无法运行的必需检查保持未验证，不得静默省略。
源码预检脚本故意廉价且可被规避，注释可能满足状态检查而不渲染任何状态；它们提供建议，但不代表工作已通过。
自动捕获可能无法到达所有站点特定状态。
证据格式 2 中的新测量在夹具精度被证明前仅报告。
CI 适配器是源仓库维护，不是发布的运行时依赖；常规设计工作不应添加 CI。
构建、扫描器通过和截图存在不能独立确立实际交付、人工验收或发布。
反馈分类需遵循 ADS：显式偏好保留给当前所有者，产品选择保留在项目上下文，重复可测量缺陷保留在基元/测试，一次性修复保留在任务中。

核心原则

克制就是设计。
间距是第一大破绽。
排版层级优先于颜色用于信息架构。
在添加自己的想法之前，先匹配约定的参考属性与保真度。
现有模式优先于新模式。
交互元素应感觉精致，而非死板。
如果基础错了，任何打磨都无法修复。
好的设计是向心的，不是离心的。

视觉基础契约中的“绝不”规则

绝不在圆角矩形上只给一条边加边框。完整周长仍然有效。
绝不用零模糊或内阴影重现单边处理。
绝不强制大写样式。作者界面文案使用句子大小写或标题大小写，仅对字面外部标识符有狭窄例外。
绝不在界面文案中使用长破折号。
绝不使用静态或动画状态圆点。状态在无颜色时仍可读；仅当图标能实质性改善扫描或理解时才添加图标。
将当前无装饰圆点偏好应用于作者文本分隔符与列表标记，而不仅是圆形状态元素。保留字面数据与数学符号。
当控件有图标等价物时使用真实图标。保留一个连贯的项目家族；否则使用许可的 Nucleo 或一个开放家族，绝不混用。
实用工作从产品字体、系统无衬线字体或其他常规通用家族开始。表现性排版需要合格表面或明确结果。
自定义字母间距与行高来自声明的类型角色，而非装饰性即兴创作。
当正常短语可行时，避免在界面文案中使用冒号。字面时间、链接、代码、协议、结构化数据与逐字外部数据仍然有效。
在添加分隔符之前先使用空白与分组。分隔符密度保持独立评审判断，而非脆弱的自动门。

参考文件

仅读取任务所需内容，保持 SKILL 精简，按需加载细节：

references/typography.md — 层级、比例、配对、行宽
references/color.md — 克制调色板、带色调中性色、对比度、OKLCH
references/spacing.md — 间距系统、节奏、分组、布局密度
references/motion.md — 时序、缓动、减少运动、交互感觉、命名运动词汇
references/mobile.md — 移动评审配置：设计判断与平台缺陷通过、决策分叉、严重性层级
references/anti-patterns.md — 要拒绝的常见代理模式
references/ux-writing.md — 界面文案、术语一致性、标签、错误与空状态

子代理指引

根据构建内容读取相关参考文件：

新布局或仪表盘？读取 spacing + anti-patterns。
排版密集屏幕？读取 typography + spacing。
颜色或主题工作？读取 color + anti-patterns。
交互打磨？读取 motion + anti-patterns。
移动/响应式/应用/PWA 评审？读取 mobile + responsive。
界面文案或同一概念竞争名称？读取 ux-writing。

仅加载能解决相关设计决策或观察到的缺陷的参考文件。

反馈所有权

遵循 ADS 反馈分类。将显式偏好保留给其当前所有者，产品选择保留在项目上下文，重复可测量缺陷保留在基元/测试，一次性修复保留在任务中。不要仅因反馈发生就追加新的一般规则。保留已接受的示例及其接受证据，而非代理的自我评分。