关于 flutter-audit
Flutter UI Audit 是用于诊断 Flutter 界面问题的只读技能,先检查再提出改动建议。它检查实现和渲染状态,按影响优先级整理发现,并区分观察事实与视觉判断。
主要功能
- 01检查界面、状态、导航和测试
- 02评估无障碍性与响应式布局
- 03检查加载、错误等界面状态
- 04按影响程度排列发现
- 05引用证据并建议补救方案
适用场景
- 01改版前审查 Flutter 界面
- 02评估无障碍性和自适应表现
- 03发现界面状态及恢复流程的缺漏
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ musabekisakov-imj/ flutter-design-engineer --skill flutter-audit安装后在 Claude Code 中输入/flutter-audit确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/anti-slop.mdconnected-product-workflows.mdlayout-and-density.mdvisual-qa.md详细介绍
Flutter UI 审查
先诊断,再开方。除非用户要求修改,否则审查工作应保持只读。
检查
- 阅读屏幕、相关状态、导航、主题、共享组件和测试。
- 有条件时运行应用或检查屏幕截图。记录每项观察对应的视口、主题、语言区域和状态。
- 评估:
- 产品目标和主要操作;
- 层级、分组、浏览顺序、信息密度、排版、颜色和表面使用;
- 导航、表单、反馈、破坏性操作和恢复机制;
- 加载、空、部分、错误、离线和成功状态;
- 紧凑和展开布局;
- 语义、焦点、文本缩放、对比度、触控目标、RTL 和减少动态效果;
- 组件边界、硬编码尺寸、重建范围和主题一致性。
- 阅读
references/anti-slop.md、references/layout-and-density.md和references/visual-qa.md,了解适用的检查项。 对于涉及多个领域的界面,还要阅读references/connected-product-workflows.md,并确认各部分之间的连接不只是相邻卡片。
排定优先级
对发现的问题分类:
- P0:阻碍核心任务、造成数据丢失或安全风险,或使界面无法使用。
- P1:严重影响理解、无障碍、任务完成或自适应行为。
- P2:损害一致性、完善度或可维护性,但不阻碍任务。
- P3:对用户影响有限的可选改进。
对于每项可执行的发现,注明对应的屏幕/状态和相关文件或渲染证据。说明对用户的影响以及最小可行的补救方案。区分事实与视觉判断。
交付
首先指出影响最大的问题模式,而不是罗列冗长的检查清单。列出应保留的优点、按优先级排序的发现、缺失的证据和建议的处理顺序。对于未渲染或检查过的状态,不要声称已验证。
评论
支持 Markdown