用途:为 iOS 和 Android 应用开发提供移动优先的设计思维与决策框架,帮助在编码前明确平台、框架与交互约束,避免把移动端当作“小桌面”处理。
主要能力:
- 强制在开发前询问平台(iOS、Android 或双端)、框架(React Native、Flutter、原生)、导航模式、状态管理、离线需求与目标设备;未明确时不得假设。
- 触控心理学:Fitts 定律、拇指区布局、手势与触觉反馈、触控目标最小尺寸(iOS 44pt、Android 48dp)及间距要求。
- 移动性能:React Native 使用 FlatList 与记忆化渲染、稳定 keyExtractor、getItemLayout;Flutter 使用 const 构造与针对性状态更新;动画仅使用 transform 与 opacity。
- 平台规范:iOS 的 Human Interface Guidelines、SF Pro、SF Symbols、边缘滑动返回;Android 的 Material Design 3、Roboto、Material Symbols、系统返回键。
- 后端与离线:推送通知、离线同步、移动 API 策略;测试与调试涵盖测试金字塔、E2E、Flipper、Logcat。
- 导航、字体、配色与决策树文件;配色关注 OLED 与深色模式的省电考量。
- 反模式清单:长列表用 ScrollView、内联 renderItem、缺少 keyExtractor、触控目标过小、仅有手势而无按钮替代、缺少加载或错误状态、令牌存 AsyncStorage、硬编码 API 密钥、日志泄露敏感数据、业务逻辑混入 UI 等。
- 提供运行脚本 scripts/mobile_audit.py,用法为 python scripts/mobile_audit.py <project_path>,用于移动 UX 与触控审计。
使用方式:先阅读 mobile-design-thinking.md 等必读参考文件,按目标平台阅读对应平台文件;开发前完成检查点(平台、框架、已读文件、将应用的三条原则、将避免的反模式);按发布前清单检查日志清理、安全存储、SSL 固定、列表优化、内存清理、低端设备测试与无障碍标签。
适用场景:React Native/Expo、Flutter、SwiftUI、Kotlin + Jetpack Compose 项目;跨平台应用需同时阅读 iOS 与 Android 文件并采用条件化平台逻辑。
限制:资料未提供具体收费、价格、许可证与团队规模信息;脚本的实际检测范围与输出格式暂未提供;各参考文件的完整正文暂未提供。