用途:review-design 用于对照设计标准评估用户可见产物,指出其偏离所属体裁设计规范之处。它只做评审:负责发现和解释,由作者决定并修改;不修复产物。若该技能被用于评审自己产出的作品,应把评估交给新的上下文,因为作者重读自己的构建会重读自己的意图。
输入:$ARGUMENTS 携带要评审的对象——文件路径、目录、URL,或正在运行的应用及其访问方式。可显式指定体裁(如 genre=dashboard、genre=deck)以覆盖自动检测。manifest gate 的正文会在所选评估器下激活此技能,gate 可指定体裁及固定参考(定义阶段确定的 mock、示例或标准)。无参数时,评审工作树中最近修改的用户可见产物并说明所选对象;若有歧义,应询问而非猜测;作为 gate 评估器且无人可问时,返回 BLOCKED 并说明歧义。
渲染证据或 BLOCKED:仅阅读标记、样式或组件得出的结论不构成设计评估。需渲染产物——在浏览器中打开,按已加载设计标准指定的桌面与窄移动视口截图评审覆盖的每个界面,若声称支持双主题则两种主题都截——并实际操作:点击主要操作、错误提交表单、触发数据产生的空状态与错误状态、调整尺寸。无法渲染或执行时,结论为 BLOCKED,并明确说明解除阻塞所需条件(构建步骤、数据夹具、浏览器),绝不静默回退到代码检查。阅读代码用于在渲染暴露缺陷后定位原因,以及仅代码能显示的检查(token 纪律、语义标记)。
标准:所依据的标准与 design 技能放在一起,避免两者漂移:../design/SKILL.md(六项决策、布局须追溯到的任务模型块、register 表、压缩底线清单)、../design/references/registers.md(web/app 之外的体裁、成功指标、失败征兆、各体裁行为探针)、../design/references/floors.md(完整底线数值、密度规则、禁止理由)、../design/references/craft.md(各领域工艺清单,加载产物涉及的领域)、../design/references/calibration.md(当前过度使用外观的带日期列表)、../design/references/figures.md(图描绘什么、选项如何比较、内联 SVG 机制、图表统一刻度)。按该文件自身的加载表加载 ../design/SKILL.md 及产物体裁和涉及领域所需的参考。这些路径是插件完整安装时的位置;若缺失(单技能安装或宿主布局不同),先按名称搜索,确实找不到就说明,并只报告无需这些文件即可支持的发现,而非凭记忆中的规则评审。
流程:先一行说明所评判的体裁与 register,再给出任何发现;显式 genre= 参数优先,否则从产物职责检测,检测确实均衡时说明并询问,无人可问时按更接近的 register 评判并在报告中说明。再一行说明产物服务的循环:使用者、重复序列、每步需同屏可见的内容。运行机器检查:对任何 HTML 产物执行 node ../design/scripts/design-check.mjs <artifact.html>(路径相对本技能目录)。按上文渲染并操作,自行运行循环两次并观察每次成本。按顺序评判:任务契合(布局是否让循环运行、所需内容是否同屏、重复操作是否无需寻找、顺序是否匹配阅读顺序,以及结构性或比较性主张是否由循环所需的编码承载)、register 契合、功能底线(状态、错误路径、恢复)、构图与层级(含模糊测试)、工艺一致性、文案、独特性。任务契合优先,因为其修复会重构产物。
分级:CRITICAL——产物未完成体裁职责;HIGH——正常使用会遇到的底线违规;MEDIUM——细心受众会注意到的规则违规;LOW——打磨。阈值除非 gate 另有规定:无 MEDIUM 及以上发现即 PASS。
报告:每条发现给出严重度与规则领域、位置(元素、屏幕、状态,附截图或机器检查行)、标准要求及为何失败、具体修复。按严重度再按位置排序。干净产物是真实结果,应直接说明并停止,不要为显得彻底而堆砌边缘发现。同一模式多处出现时报告一次并给两三个示例和计数。规则应用确属判断时在发现中说明,而非当作缺陷。
范围:本技能按请求或 manifest gate 评估已完成或进行中的产物。构建与重设样式属于 design 技能;报告后应用修复是单独请求,属普通编辑。它不评审文字风格——文档写作质量属 review-writing 技能;本技能评判同一文档的布局、层级、排版与阅读结构。