| name | review-harmonyos-design |
| description | 严格审视 HarmonyOS、OpenHarmony 与 ArkUI 产品或代码，只报告有证据的设计、导航、跨设备适配、输入状态、动效、异步状态真实性、无障碍和动画性能问题，并给出规则 ID、ArkUI 落点与通过结论。用于用户明确要求 review、audit、审查、验收或评估鸿蒙 UI；不要用于从零设计、直接实现功能、修复构建签名或审查非界面代码。 |
| metadata | {"status":"experimental","version":"1.0.0"} |
严格审视 HarmonyOS 设计
本 Skill 只做审视，不从零设计，不批量改代码，也不审查与界面设计无关的工程问题。
默认立场：通过需要证据，问题也需要证据。
1. 审视范围
- 用户任务和导航；
- 手机、平板、折叠屏、PC、穿戴、智慧屏、车机适配；
- 触摸、鼠标、键盘、遥控器等输入；
- 控件正常、禁用、按下、焦点、激活、悬停状态；
- 视觉 Token、vp/fp、大字体；
- 动效目的、曲线、时长、跟手、速度和可打断；
- 异步状态真实性；
- 无障碍；
- 动画性能；
- 稳定原则与版本化平台层；
- 可交互原型与真实实现证据。
2. 不在范围内
遇到以下请求，说明不适用并指向通用工程审查：
- HAP/APP 签名；
- 编译器错误；
- 网络、权限、数据库；
- 非 UI 业务逻辑；
- 其他移动平台的设计规范；
- 直接实现新功能。
3. 先建立上下文
复用用户已提供的信息：
目标设备:
窗口形态:
主要输入:
API_Level:
主题与字号:
任务路径:
证据:
假设:
缺失信息不会影响当前发现时，不重复提问。证据不足的结论标低置信度。
4. 十三项不可妥协标准
- 导航清晰。 用户知道位置、去向、返回和退出。
- 跨设备不是等比缩放。 必须有具体适配策略。
- 系统优先。 自定义不削弱系统状态和无障碍。
- 输入状态完整。 目标输入下按下、焦点、悬停、激活等可区分。
- 反馈立即。 按下阶段有本地反馈。
- 手势连续。 跟手、离手速度继承、目标变化可打断。
- 运动表达真实关系。 曲线、方向、共享元素和层级一致。
- 异步状态不撒谎。 Pending 不冒充 Confirmed；成功反馈不早于真实确认。
- 基础与版本分层。 当前视觉语言不得推翻方向感、可读性、无障碍和状态真实性；旧原则也不能阻止新平台能力。
- 产品语境优先。 不把所有产品改成同一种玻璃、圆角、弹跳或“高级感”。
- 可执行原型。 高风险手势、转场和跨端方案不能只凭静态稿通过。
- 可访问。 非文本语义、状态、焦点、大字体和自绘内容可用。
- 性能有证据。 避免手写逐帧、连续布局动画和冗余刷新，并进行真机验证。
详细审视标准见 references/STANDARDS.md。
5. 看到即升级的问题
通常标为 BLOCKER 或 MAJOR：
- 关键页面无返回或退出；
- 平板/大字体下核心操作被裁剪；
- 核心按钮没有按下反馈；
- 手势松手后速度归零产生明显停顿；
- 动画期间锁住输入；
- 共享转场和默认 Navigation 转场叠加；
- 远端请求尚未确认就显示或播报成功；
- 图标按钮无可访问名称；
- 焦点陷阱；
- 高频手势每帧修改
width/height；
- 把 House Style 声称为官方规则；
- 用当前视觉趋势为理由移除必要对比度、焦点或方向感；
- 高风险手势只有静态稿，没有可运行原型或目标设备证据。
6. 修复优先级
- 修复任务、导航和状态真实性；
- 恢复系统默认能力；
- 修复跨设备和输入；
- 修复无障碍；
- 删除无目的动效；
- 修复跟手、速度和打断；
- 统一语义 Token；
- 优化性能；
- 最后处理品牌微动效。
7. 必需输出格式
上下文卡
列出已知条件和假设。
Findings 表
| 优先级 | 规则 ID | 证据 | 问题 | 用户影响 | 建议 | ArkUI 落点 | 来源等级 | 置信度 |
|---|
一行一个问题。没有证据的问题不进入 Findings。
影响归纳
按以下顺序，只输出非空类别：
- 任务与导航；
- 异步真实性；
- 跨设备与输入；
- 手势与动效；
- 无障碍；
- 性能；
- 稳定原则与平台版本；
- 视觉一致性；
- 原型与证据；
- 待验证。
最小修复计划
给出依赖顺序、修改范围和验证方法，不直接重写整个项目。
结论
只能是：
- 不通过：存在 Blocker；
- 有条件通过：无 Blocker，但存在未关闭 Major；
- 通过：无 Blocker/Major，关键设备、输入、字号、无障碍和性能已有证据。
8. 来源措辞
- H1：华为官方；
- H2：OpenHarmony 官方；
- H3：官方观察；
- H4：项目建议。
不要把 0.97、统一弹簧、错峰入场、玻璃材质等写成 HarmonyOS 官方要求。
9. 反同质化检查
每次审视补充：
应保留的产品特征：
不应套用的通用风格：
允许的 House Style：
审视的目标是适合，而不是时髦。
