mcpField
F
flutter-audit

flutter-audit

github.com/musabekisakov-imj设计与 UI445 次安装14 周前更新
代码仓库

关于 flutter-audit

Flutter UI Audit 是用于诊断 Flutter 界面问题的只读技能,先检查再提出改动建议。它检查实现和渲染状态,按影响优先级整理发现,并区分观察事实与视觉判断。

主要功能

  1. 01检查界面、状态、导航和测试
  2. 02评估无障碍性与响应式布局
  3. 03检查加载、错误等界面状态
  4. 04按影响程度排列发现
  5. 05引用证据并建议补救方案

适用场景

  1. 01改版前审查 Flutter 界面
  2. 02评估无障碍性和自适应表现
  3. 03发现界面状态及恢复流程的缺漏

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/musabekisakov-imj/flutter-design-engineer --skill flutter-audit

安装后在 Claude Code 中输入/flutter-audit确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
anti-slop.md
connected-product-workflows.md
layout-and-density.md
visual-qa.md

详细介绍

Flutter UI 审查

先诊断,再开方。除非用户要求修改,否则审查工作应保持只读。

检查

  1. 阅读屏幕、相关状态、导航、主题、共享组件和测试。
  2. 有条件时运行应用或检查屏幕截图。记录每项观察对应的视口、主题、语言区域和状态。
  3. 评估:
    • 产品目标和主要操作;
    • 层级、分组、浏览顺序、信息密度、排版、颜色和表面使用;
    • 导航、表单、反馈、破坏性操作和恢复机制;
    • 加载、空、部分、错误、离线和成功状态;
    • 紧凑和展开布局;
    • 语义、焦点、文本缩放、对比度、触控目标、RTL 和减少动态效果;
    • 组件边界、硬编码尺寸、重建范围和主题一致性。
  4. 阅读 references/anti-slop.md、references/layout-and-density.md 和 references/visual-qa.md,了解适用的检查项。 对于涉及多个领域的界面,还要阅读 references/connected-product-workflows.md,并确认各部分之间的连接不只是相邻卡片。

排定优先级

对发现的问题分类:

  • P0:阻碍核心任务、造成数据丢失或安全风险,或使界面无法使用。
  • P1:严重影响理解、无障碍、任务完成或自适应行为。
  • P2:损害一致性、完善度或可维护性,但不阻碍任务。
  • P3:对用户影响有限的可选改进。

对于每项可执行的发现,注明对应的屏幕/状态和相关文件或渲染证据。说明对用户的影响以及最小可行的补救方案。区分事实与视觉判断。

交付

首先指出影响最大的问题模式,而不是罗列冗长的检查清单。列出应保留的优点、按优先级排序的发现、缺失的证据和建议的处理顺序。对于未渲染或检查过的状态,不要声称已验证。

评论

支持 Markdown