SuperAPI AI 工具集

ux-scenarios

通用与其它

查看项目

更新于 10-15 23:45

技能介绍

ux-scenarios 属于 super-ux 技能体系,用于维护目标项目中的场景库 docs/ux/scenarios.md。该文件是描述用户可做、可见、可触达一切内容的事实来源,覆盖每个功能、按钮、状态、错误与结果。格式契约见 scenario-format.md(ux-contract v4),写入或编辑前须先阅读,不得偏离其字段名、ID 规则、状态与检查清单。

用途:当创建或更新 UX 场景、启动任何新功能或新项目时使用;空白项目需先补充 vision 与 ux-foundation 层。核心硬性规则是场景先于界面:新功能或项目先起草场景并与既有库校验冲突、重叠、缺口,获得批准后才设计并构建 UI;任何影响用户可见行为的变更需在同一变更中更新 scenarios.md,无场景的新行为属于阻塞项而非警告。只有用户明确说出“no scenarios”/«без сценариев» 才可跳过,且须在交付中说明。

主要能力:提供四种工作流——Init(greenfield)、Init(existing code)、Update、Validate,运行时需声明所用工作流;若 docs/ux/ 缺失则创建并从本技能的 templates/scenarios.md 播种。分层派生:当存在 foundation.md(人物、JTBD、旅程、故事)或 flows.md(任务分析、用户流程)时,场景由其派生,每条 flow 一组场景,覆盖快乐路径、所有错误边界与替代分支,填写 Traces 与故事/流程 ID;缺失上层时建议先做 ux-foundation → ux-flows,小项目或用户明确选择才以 v1 模式(无 Traces)进行。步骤采用用例风格:用户操作 -> 可观察的系统响应,并按 ux-design-principles.md 应用每屏状态、错误恢复、主操作规则。校验流程检查完整性、覆盖、可追溯性与冲突。可按请求从场景库生成可用性测试任务。

使用方式:运行 python3 docs/ux/lint.py 做 lint;场景状态从 draft 起步,Approved 后转为 validated。

限制:不得偏离格式契约;不得编造人物或场景;缺失事实(如价格、平台支持)暂未提供,资料中未给出。最佳实践参考 best-practices.md,按标签过滤并记录 BP-NNN 编号。