用途:该技能依据 uxuiprinciples 框架(195 条有研究支持的 UX/UI 原则,分为 6 个部分)评估界面描述,返回结构化 JSON 发现,而非散文。每条发现指明具体原则、严重程度、违反内容及原因,并给出具体修复建议。
主要能力:可调用 audit 对界面描述执行完整结构化审计,返回发现、严重程度、修复建议、检测到的异味、优点和总分;可用 lookup_principle 按 slug 获取原则元数据;可用 list_principles_by_part 列出某个部分的所有原则。框架分为基础、核心原则、设计系统、界面模式、AI 原生与专用、以人为本设计六部分,原则代码格式为 F.[部分].[章节].[序号]。
使用方式:设置 UXUI_API_KEY 后优先调用 audit,其返回即为可直接使用的输出;若 audit 不可用,则对每条违规调用 lookup_principle 用返回的 aiSummary 和 businessImpact 补充。未设置密钥时,可依据内部知识应用框架,并在输出中注明限制。评估流程包括分类界面、选择相关部分、识别违规、用工具补充、评分分级、输出 JSON。评分从 100 起扣:critical 扣 15,warning 扣 7,suggestion 扣 3,分数不低于 0。分档:85-100 excellent,65-84 good,40-64 fair,0-39 poor。
适用场景:适用于仪表盘、表单、结账、引导、导航、AI 对话、模态框、落地页等界面描述的质量审查,帮助发现认知负荷、选择过多、层级不清、缺少反馈等可用性问题。
限制:完整审计和全部 195 条原则需要 pro 层 API 密钥,免费层仅返回 12 条原则;若 API 返回 403 需回退到内部知识;描述少于 30 词时应先提一个澄清问题;描述模糊时不得臆造细节;无 AI 相关信号时跳过第 5 部分评估。输出必须为合法 JSON,不添加额外说明文字。