SuperAPI AI 工具集

review

设计与创作

查看项目

更新于 10-24 16:17

技能介绍

用途

该技能用于执行严格的界面审查,并产出一份可操作的修改清单。审查的成果是一系列“需要修改的事项”,每项都包含:位置、当前状况、修改建议和原因。它拒绝模糊的意见,要求所有发现都有证据支撑。

主要能力

  • 范围界定:在审查前明确审查对象(如某个屏幕、流程、组件或差异),并说明覆盖的状态和断点(375px 和 1440px)。如果范围过大,会缩小到一个完整的流程并说明排除了哪些部分。
  • 技术侦察:快速了解框架、样式系统、组件库、动效库、图标集,以及设计令牌(颜色、间距、缓动、圆角、z-index)的位置,并查阅项目中的书面约定(如 CLAUDE.md、AGENTS.md 等)。
  • 固定顺序检查:按照从基础到表面的顺序检查十个领域:功能、无障碍、状态、文案、间距、字体、表面、交互、动效、打磨。每个领域都有对应的详细规则技能(如 a11y、states、ux-copy 等),审查时会根据需要加载,而非凭记忆重建规则。
  • 严重程度分级:将发现的问题分为阻塞、高、中、低四个级别,并依据影响范围和发生频率排序。
  • 结构化输出:最终输出一个表格,仅包含范围行、侦察行、问题表格、结论和排除列表。每个问题行必须包含位置(文件:行号或选择器)、现状(具体值或行为)、修改建议(符合项目习惯的具体替换)和原因(对用户的影响)。最多列出15个问题,按影响排序。
  • 结论:给出三种结论之一:就绪、修复阻塞问题后就绪、未就绪,并指明哪些问题构成门槛。

使用方式

该技能以技能描述的形式提供,用户可通过引用该技能来触发审查流程。审查过程分为六个步骤:范围界定、侦察、按序检查、严重程度分级、输出、避免事项。审查者需遵循“证据而非品味”的原则,不重写组件,不按实例重复列出同一问题,不报告范围外不需要的内容,不评分,不因整体良好而弱化阻塞问题。

适用场景

  • 对某个界面屏幕、用户流程、组件或代码差异进行系统性审查。
  • 在开发过程中或发布前对界面质量进行把关。
  • 需要具体、可执行的修改清单而非泛泛而谈的反馈时。

限制

  • 审查依赖于可访问的代码或运行中的界面;仅源码审查时会明确说明。
  • 最多列出15个问题,超出部分仅提及存在但未展开。
  • 审查不包含修复步骤,修复是独立的后续操作。
  • 需要审查者具备对项目技术栈和约定的基本了解。
  • 该技能不提供评分或等级。