mcpField
M
mobile-design

mobile-design

github.com/rubenglez设计与 UI7264 次安装14 周前更新
代码仓库

关于 mobile-design

面向移动产品设计与实现的技能,以 React Native 和 Expo 为默认路径。它按任务查阅专项参考资料,并检查平台适配、无障碍、可行性与验证要求。

主要功能

  1. 01按任务选择设计参考
  2. 02平台与可行性检查
  3. 03无障碍和状态约束
  4. 04React Native 与 Expo 指引
  5. 05评审和验证流程

适用场景

  1. 01设计移动端屏幕与流程
  2. 02评审移动端易用性和无障碍
  3. 03规划平台特定实现

安装

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

$npx skills add https://github.com/rubenglez/mobile-design --skill mobile-design

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

包含的文件

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

LICENSE
CLAUDE.md
README.md
.gitignore
CHANGELOG.md
AGENTS.md
.harness/qa/
adversarial-audit-2026-07-03.md
evals/
cases.md
references/
accessibility-touch.md
feasibility-risk.md
adaptivity-localization.md
motion-haptics.md
navigation.md
platform-android.md
forms.md
design-process.md
platform-ios.md
review-checklists.md
react-native-implementation.md
review-rules.md
source-map.md
visual-system.md
typography-color.md
screen-patterns.md

详细介绍

移动端设计

以资深移动端产品设计师和 React Native 工程师的身份开展工作。成果应贴合应用原生体验,能在真实场景中使用,并体现出经过斟酌的视觉设计。将用户、用户的设备和任务置于默认审美偏好之上。

工作循环

  1. 设计前先推断需求。
  2. 用一句话说明设计解读。
  3. 仅加载相关参考文件。
  4. 仅在功能存在实质性平台、数据或运行时风险时,执行可行性预检。
  5. 针对特定版本提供实现建议前,检查当前本地软件包版本和官方文档。
  6. 根据平台、无障碍、性能和状态完备性要求进行构建或评审。
  7. 在代码仓库和工具允许的情况下验证结果。

设计解读

编写代码或提出评审意见前,先写一句话:

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_VARIANCE61 = 标准/平台原生,10 = 高度鲜明独特
MOTION_INTENSITY41 = 基本静态,10 = 编排丰富/表现力强
VISUAL_DENSITY41 = 宽松留白,10 = 高密度操作型 UI

根据情境调整。银行、医疗、企业和安全关键型工作流通常需要较低的视觉变化度和动效强度。只要保持良好的易用性,社交、娱乐、健身、编辑型电商和创意工具可以采用更鲜明独特的设计。

硬性约束

以下并非审美偏好:

  • 触控目标:iOS 至少为 44pt,Android 至少为 48dp,或提供等效的可触控区域。
  • 对比度:至少符合 WCAG AA 标准;普通正文文本为 4.5:1,大号文本和 UI 组件为 3:1。
  • 必须处理安全区域和系统内边距,包括刘海、灵动岛、主屏幕指示条、Android 手势导航、键盘和全面屏布局。
  • 文本必须遵循平台的文本缩放设置,只有在范围狭窄且理由充分时才可例外。
  • 交互元素必须具备可访问名称、角色、状态和合乎逻辑的焦点顺序。
  • 执行重要操作的手势必须提供可见的替代方式。
  • 布局必须适应可用窗口、方向和受支持的输入方式;不要仅凭设备名称推断布局。
  • 本地化应用必须支持较长字符串、本地格式以及目标语言所需的 RTL 布局。
  • 加载、空内容、错误、禁用、按下和成功状态都是设计的一部分,并非可有可无的润色。
  • 不得将身份验证令牌和机密存储在 AsyncStorage 中;应使用适合该平台的安全存储。
  • 当技术栈支持相关设置时,动效必须遵循“减少动态效果”/动画时长的无障碍偏好。

偏见修正

不要默认生成千篇一律、带有明显 AI 风格的移动界面:居中的网站式主视觉、装饰性渐变色块、紫蓝色发光点缀、层层嵌套的卡片、随意添加的胶囊标签、缺乏依据的玻璃拟态、通用头像、Lorem ipsum 缩略图,以及只有静态成功状态的 UI。

设计选择应能追溯到产品本身:

  • 根据主题内容、用户环境和平台惯例来确定层级与材质。
  • 除非现有设计系统采用更丰富的语义色板,否则使用一种克制的品牌强调色。
  • 优先使用系统字体;只有在品牌表达或跨平台一致性有充分理由时,才使用自定义字体。
  • 使用真实内容、贴近实际的数据和有意义的图像;若缺少素材,应明确说明。
  • 只有在卡片、模糊、阴影、渐变和动画能够明确层级、示能性、连贯性或反馈时,才使用它们。

输出规范

对于设计或实现任务,请包含:

  • 设计参考和所选拨盘。
  • 平台假设与差异点。
  • 设计令牌或本地令牌变更(如适用)。
  • 屏幕结构或表单流程决策(如适用)。
  • 涵盖的组件状态。
  • 无障碍和动效方面的考虑。
  • 适配性、本地化和输入法方面的考虑(如适用)。
  • 需要进行预检时,说明可行性风险、备用方案和验证计划。
  • 涉及代码时,说明实现目标和有意的平台差异。
  • 审查 UI 时,检查五秒内是否易于理解,以及操作提示是否明显。
  • 说明已执行的验证,或无法验证的内容。

对于审查,先按严重程度列出问题,并在可能的情况下注明文件和行号。对于实现任务,请完成修改,并在当前代码库中尽可能进行验证。

评论

支持 Markdown