superior-ux

卓越的用户体验

让用户通往有意义结果的路径清晰、连贯且可恢复。决策应基于产品证据和可观察行为；绝不虚构项目并不支持的研究、用户画像或信心。

明确体验约定

提出流程之前，先明确：

• 主要用户、任务、情境和入口；
• 成功的结果，以及用户如何识别该结果；
• 必要的决策、信息、权限和约束；
• 现有路径、屏幕、术语、分析数据、研究、支持证据和产品规则；
• 会实质影响任务完成的中断、失败、替代路径和再次访问。

将观察到的证据与假设区分开来。如果相互冲突的假设会改变产品服务的对象、同意的含义或成功的判定标准，请征询指示。否则，采用最小且可逆的假设，并明确说明。

如果工作涉及多个步骤、屏幕、角色、入口或导航层级，请阅读 references/journeys-task-flows-and-information-architecture.md。

规划用户旅程

• 从用户目标出发，而非从当前屏幕布局或组织内部结构出发。
• 让入口、方向指引、下一步操作、进度、完成状态和再次进入方式都易于理解。
• 区分必要步骤与可选补充内容。只有在有助于保障理解、同意、正确性或恢复时，才添加步骤。
• 确保选项便于比较，并在各个界面中保持用语一致。
• 在复杂信息变得相关时再逐步呈现，而不是隐去关键后果，或一次性展示所有选项。
• 保留用户的控制权：在产品约定允许的情况下，提供安全的返回、取消、暂缓、更正或恢复方式。

定义交互与恢复方式

针对每项重要操作，定义用户在操作前、操作中和操作后可以观察到的情况。仅在可能发生时，涵盖等待、成功、部分成功、验证失败、依赖项失败、取消和重试。

如果流程包含表单、异步工作、破坏性操作、外部交接、中断或多步骤状态，请阅读 references/interaction-feedback-and-recovery.md。

不要通过隐瞒成本、同意、安全后果、破坏性影响或有意义的替代方案来优化完成率。在安全的情况下，遇到预期失败后保留已输入的数据，并让用户回到有用的状态，而不是陷入死胡同。

依据证据进行评估

从入口到结果，逐步演练有代表性的场景，其中至少包含一次重要失败或中断。检查用户是否能回答：

1. 我在哪里？在这里可以做什么？
2. 如果继续，会发生什么？
3. 现在正在发生什么？
4. 操作成功了吗？接下来该做什么？
5. 如何安全地恢复或离开？

有关启发式评审、证据质量、场景选择和可用性验证，请阅读 references/ux-evaluation-and-evidence.md。应根据证据所支持的信心水平，将发现描述为风险或观察到的问题；不要把专家演练说成用户研究。

协调职责归属

仅加载其契约会实质性改变的技能：

• superior-ui：负责视觉层级、组件组合和界面实现；
• superior-logic：负责领域行为、状态转换、API 和持久化；
• superior-responsive：负责由视口驱动的重排和自适应导航；
• superior-accessibility：负责键盘操作、焦点、语义、辅助技术和包容性互动；
• superior-copy：负责标签、说明、错误信息和产品语气；
• superior-testing：负责专门的用户旅程、契约或回归测试设计；
• superior-docs：在最终体验契约需要长期留存时使用。

如果用户只要求梳理用户旅程、流程或进行评审，请勿修改实现。用户要求实现时，使用此技能来规范体验契约，并使用负责实现的技能修改代码。

交付内容

报告当前和拟议的用户旅程、已变更的决策或信息结构、交互与恢复契约、支撑证据、尚未解决的假设，以及执行过的验证。如果用文字难以清晰说明流程顺序或分支，优先使用简洁的流程图或状态表。