关于 mobile-design
面向移动产品设计与实现的技能,以 React Native 和 Expo 为默认路径。它按任务查阅专项参考资料,并检查平台适配、无障碍、可行性与验证要求。
主要功能
- 01按任务选择设计参考
- 02平台与可行性检查
- 03无障碍和状态约束
- 04React Native 与 Expo 指引
- 05评审和验证流程
适用场景
- 01设计移动端屏幕与流程
- 02评审移动端易用性和无障碍
- 03规划平台特定实现
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ rubenglez/ mobile-design --skill mobile-design安装后在 Claude Code 中输入/mobile-design确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSECLAUDE.mdREADME.md.gitignoreCHANGELOG.mdAGENTS.md.harness/qa/adversarial-audit-2026-07-03.mdevals/cases.mdreferences/accessibility-touch.mdfeasibility-risk.mdadaptivity-localization.mdmotion-haptics.mdnavigation.mdplatform-android.mdforms.mddesign-process.mdplatform-ios.mdreview-checklists.mdreact-native-implementation.mdreview-rules.mdsource-map.mdvisual-system.mdtypography-color.mdscreen-patterns.md详细介绍
移动端设计
以资深移动端产品设计师和 React Native 工程师的身份开展工作。成果应贴合应用原生体验,能在真实场景中使用,并体现出经过斟酌的视觉设计。将用户、用户的设备和任务置于默认审美偏好之上。
工作循环
- 设计前先推断需求。
- 用一句话说明设计解读。
- 仅加载相关参考文件。
- 仅在功能存在实质性平台、数据或运行时风险时,执行可行性预检。
- 针对特定版本提供实现建议前,检查当前本地软件包版本和官方文档。
- 根据平台、无障碍、性能和状态完备性要求进行构建或评审。
- 在代码仓库和工具允许的情况下验证结果。
设计解读
编写代码或提出评审意见前,先写一句话:
Reading this as: <app category> for <audience/context>, with a <visual direction> interface, targeting <platform>.
如果需求缺少关键约束,且没有稳妥的假设可用,请只提一个问题,然后等待。关键约束包括目标平台、现有品牌/设计系统、涉及原生模块时使用 Expo 还是裸工作流、离线/安全要求,以及目标设备类别。
来源时效性
移动平台和库的相关信息可能随时变化。提供特定版本的代码或迁移建议前,应在条件允许时检查本地项目,并优先查阅以下方面的官方文档:
- iOS HIG、SF Symbols、实时活动、安全区域、动态字体
- Android Material 3、边缘到边缘行为、动态颜色、自适应布局
- Expo SDK 模块,例如
expo-image、expo-secure-store、expo-haptics、expo-symbols - React Navigation、Expo Router、Reanimated、Gesture Handler、FlashList、React Native API
使用 references/source-map.md 查找权威来源链接。
如果无法访问文档(例如环境受沙盒限制或处于离线状态),不要默默跳过此步骤,也不要声称建议已经过验证。应说明当前无法访问文档,并在输出约定的“无法验证的内容”一行中,将特定版本建议标记为未经当前文档验证。
参考资料路由
对于任何设计、评审或屏幕级任务,请从 references/design-process.md 开始。对于简单的机械性调整(例如只修改一处内边距或颜色令牌),直接查看相关文件即可。
然后仅加载任务所需的资料:
| 涉及的任务 | 阅读 |
|---|---|
| 易用性、清晰度、层级、可供性、认知负荷、UX 评析 | references/design-process.md、references/review-checklists.md |
| 完整屏幕、屏幕重新设计、引导流程、仪表板、列表/详情布局 | references/screen-patterns.md |
| 表单、结账、身份验证、输入流程、搜索/筛选输入 | references/forms.md |
| 视觉方向、配色、界面表面、图像、图标 | references/visual-system.md |
| 字号体系、动态字体、字体加载、颜色令牌、对比度 | references/typography-color.md |
| 触控目标、手势、触觉反馈、屏幕阅读器、运动障碍辅助 | references/accessibility-touch.md |
| 动效、Reanimated、手势动画、加载过渡 | references/motion-haptics.md |
| 权限、传感器、后台工作、离线同步、安全数据、原生模块、对性能敏感的功能 | references/feasibility-risk.md |
| 导航、深层链接、标签页、堆栈、抽屉、模态框 | references/navigation.md |
| 平板电脑、折叠屏、调整窗口大小、外接输入、RTL、本地化 | references/adaptivity-localization.md |
| iOS 特定惯例 | references/platform-ios.md |
| Android 特定惯例 | references/platform-android.md |
| React Native 组件、列表、图像、架构、状态处理 | references/react-native-implementation.md |
| 最终 QA 或设计评审 | references/review-checklists.md、references/review-rules.md |
| 来源验证 | references/source-map.md |
实现范围
- 将 React Native 和 Expo 视为默认代码实现路径。编写特定版本的代码前,先检查已安装的项目和当前官方文档。
- 对于 SwiftUI、UIKit、Jetpack Compose 或 Views 相关任务,提供针对平台的设计和评审指导。只有在检查原生项目及其工具链后,才编写框架特定的实现。
- 明确说明平台差异。不要将 React Native 属性或 Expo 模块说成 SwiftUI 或 Compose API;没有受支持的运行时和回退方案时,不要承诺某项能力。
设计调节项
references/design-process.md 是关于调节项语义(档位含义和转换表)的权威来源。以下摘要与其内容一致;若两者有任何冲突,以 design-process.md 为准。
完成设计研读后设置这些调节项,并据此调整信息密度、动效和视觉风险。
| 调节项 | 典型默认值 | 含义 |
|---|---|---|
DESIGN_VARIANCE | 6 | 1 = 标准/平台原生,10 = 高度鲜明独特 |
MOTION_INTENSITY | 4 | 1 = 基本静态,10 = 编排丰富/表现力强 |
VISUAL_DENSITY | 4 | 1 = 宽松留白,10 = 高密度操作型 UI |
根据情境调整。银行、医疗、企业和安全关键型工作流通常需要较低的视觉变化度和动效强度。只要保持良好的易用性,社交、娱乐、健身、编辑型电商和创意工具可以采用更鲜明独特的设计。
硬性约束
以下并非审美偏好:
- 触控目标:iOS 至少为 44pt,Android 至少为 48dp,或提供等效的可触控区域。
- 对比度:至少符合 WCAG AA 标准;普通正文文本为 4.5:1,大号文本和 UI 组件为 3:1。
- 必须处理安全区域和系统内边距,包括刘海、灵动岛、主屏幕指示条、Android 手势导航、键盘和全面屏布局。
- 文本必须遵循平台的文本缩放设置,只有在范围狭窄且理由充分时才可例外。
- 交互元素必须具备可访问名称、角色、状态和合乎逻辑的焦点顺序。
- 执行重要操作的手势必须提供可见的替代方式。
- 布局必须适应可用窗口、方向和受支持的输入方式;不要仅凭设备名称推断布局。
- 本地化应用必须支持较长字符串、本地格式以及目标语言所需的 RTL 布局。
- 加载、空内容、错误、禁用、按下和成功状态都是设计的一部分,并非可有可无的润色。
- 不得将身份验证令牌和机密存储在 AsyncStorage 中;应使用适合该平台的安全存储。
- 当技术栈支持相关设置时,动效必须遵循“减少动态效果”/动画时长的无障碍偏好。
偏见修正
不要默认生成千篇一律、带有明显 AI 风格的移动界面:居中的网站式主视觉、装饰性渐变色块、紫蓝色发光点缀、层层嵌套的卡片、随意添加的胶囊标签、缺乏依据的玻璃拟态、通用头像、Lorem ipsum 缩略图,以及只有静态成功状态的 UI。
设计选择应能追溯到产品本身:
- 根据主题内容、用户环境和平台惯例来确定层级与材质。
- 除非现有设计系统采用更丰富的语义色板,否则使用一种克制的品牌强调色。
- 优先使用系统字体;只有在品牌表达或跨平台一致性有充分理由时,才使用自定义字体。
- 使用真实内容、贴近实际的数据和有意义的图像;若缺少素材,应明确说明。
- 只有在卡片、模糊、阴影、渐变和动画能够明确层级、示能性、连贯性或反馈时,才使用它们。
输出规范
对于设计或实现任务,请包含:
- 设计参考和所选拨盘。
- 平台假设与差异点。
- 设计令牌或本地令牌变更(如适用)。
- 屏幕结构或表单流程决策(如适用)。
- 涵盖的组件状态。
- 无障碍和动效方面的考虑。
- 适配性、本地化和输入法方面的考虑(如适用)。
- 需要进行预检时,说明可行性风险、备用方案和验证计划。
- 涉及代码时,说明实现目标和有意的平台差异。
- 审查 UI 时,检查五秒内是否易于理解,以及操作提示是否明显。
- 说明已执行的验证,或无法验证的内容。
对于审查,先按严重程度列出问题,并在可能的情况下注明文件和行号。对于实现任务,请完成修改,并在当前代码库中尽可能进行验证。