SuperAPI AI 工具集

review-design

设计与创作

查看项目

更新于 10-15 21:56

技能介绍

用途:review-design 是 agentic-workflow 评审包中的内部 UI/UX 设计评审环节,由 review-change 或 product-audit 在对话中组合调用,作为被路由的步骤内联执行。它只产出评审发现,从不编辑或重构代码。

主要能力:按固定清单逐项评估,包括先阅读项目设计文档(如 docs/frontend/DESIGN.md)并为每条发现引用规则;检查变更组件是否复用设计系统、是否避免一次性样式/颜色/间距;每个新增或变更视图是否覆盖 loading、empty、error、success 全部状态;响应式行为是否按项目断点声明并落实;声明 i18n 的项目中是否避免硬编码面向用户的字符串;视觉层级是否清晰、每视图是否只有一个主操作;与同类页面模式是否一致;破坏性操作是否需确认且视觉上可区分;每个用户操作是否有反馈。

使用方式:调用方传入 diff 或路径/glob,默认对比当前变更与默认分支,并在返回表格顶部声明范围。返回固定格式:REVIEW DESIGN — scope、发现表格(#、Finding、Sev、Evidence、Suggested fix)、Checklist 统计、Summary 与 Decision(PASS 或 FAIL)。存在未解决的 critical 或 major 发现即 FAIL,否则 PASS;minor 不阻塞,交由调用方分诊。

适用场景:适用于对前端变更做设计一致性、状态覆盖与交互反馈的评审。

限制:仅报告会改变合格用户结果或违反项目明确声明规则的问题;注释/标点错别字、纯格式漂移、无规则依据的风格偏好、超出 SPEC 命名场景的假设性健壮性均不算发现。格式良好的变更应返回空表并 PASS,不得为凑数填充。完成条件是每项清单均以证据(file:line 或命令输出)评估,或明确标注 n/a 及原因,且不修改任何代码。其他细节暂未提供。