用途:在实现之前先决定用户会看到什么、能做什么,避免让代码反过来约束设计;当实现暴露真实约束时,重新打开拥有该决定的上层环节,而不是绕过代码重新设计。
主要能力:提供按后果与未决不确定性成比例的设计流程。链路为:业务意图变化用 BRD;产品行为变化用 PRD;存在实质体验决定用 XDS;存在实质技术决定用 SDD;然后实现,再验证。只有对应决定存在时才使用该层,条件性不等于允许留下未决决定。新能力或跨界面旅程通常需要每一层。文档各有其所属与不得越界的内容:BRD 负责业务意图、目标用户、结果、范围与不可交易的质量,不负责控件、布局、文案、颜色;PRD 负责产品故事、规则、数据、权限、成功/失败/中断/恢复/返回下的结果与不变量、可观察验收,不负责控件选择、编排、布局、文案、层级、动效与技术实现;XDS 负责旅程、状态与转换、控件与事件、文案、反馈归属、保留、重试、返回、响应式组合、动效与备选,不负责新业务或产品需求及技术实现;SDD 负责模式、API、持久化、性能、安全与技术失败处理,不重新设计体验。顺序上业务意图先于产品行为,产品行为先于其体验,两者都先于技术实现;纯技术 SDD 不需要 XDS。
使用方式:先命名决定,只阅读拥有或约束它的材料;修改正式文档仅当其决定改变,链接到拥有该陈述的位置而非复述。按改变规模选择最小有用材料:无用户可见或交互影响的改变通常不需要材料;小型维护增量写入 issue 或 PR,含角色与任务、当前失败、预期行为、受影响可达状态、保留的上下文、恢复与返回规则、可观察验收;新能力或实质行为变化增加或修改 PRD,必要时增加 XDS 材料;新旅程或跨界面接缝写一份按遍历顺序的 XDS;有后果的技术选择写一份 SDD。没有长度配额,用能不留实质隐含决定的最轻材料,仅在更轻材料未能促成决定时升级。
体验提示:使用能解决本次改变的问题,其余省略而不作说明。产品故事写明谁、在什么情境、做什么、为哪个结果;仅新功能或旅程需要体验论题,一句话说明选定方向与用户应记住的一件事;旅程写入口、决定性时刻、完成、返回或恢复;交互场景写明具名控件与事件、可见响应、终态以及绝不能发生的事,状态感以可观察值表达(如输入 100 毫秒内确认、1 秒内完成或进入设计的慢状态,动效命名并有界),无值支撑的形容词只是愿望;状态模型记录会改变用户所见或所能做的可达状态;恢复写明故障后保留什么、丢失什么、可重试什么、重试在哪里;验收写明有人会实际执行的可观察场景。当布局、密度、动效、时序或响应式适配承载决定时,渲染状态板、模型或原型。
语法:常规故事在情境、努力、放弃或可证伪影响决定时太弱,可用 STORY 语法记录角色、情境、任务、结果、成功到达状态、放弃点、努力与证伪条件;仅在迫使其行成决定时使用完整语法。故事从不选择控件,需将实质故事映射为 SCENARIO,含起始状态、具名控件或事件、即时可见响应、等待/缓慢/中断行为、成功终态、真实失败态、恢复与返回。状态提示从数据(缺失、部分、无效、最大;集合零、一、多、极多)、时间(待处理、慢于 1 秒、成功、失败、被取代、重复、迟到完成)、路径(输入、恢复、默认、获取、认证、刷新)与框架(支持宽度、输入模式、内容极端)四个维度检查,只记录会改变用户可见行为或承载可能失败的可达状态,不序列化笛卡尔积,也不声称穷尽覆盖。每个受影响控件需决定键盘、指针与触摸行为,焦点放置与恢复,以及方向、安全区域与宽度行为。
限制与说明:资料未提供收费、价格、平台或安装步骤等信息;本技能不替代构建期打磨工艺技能,机器检查仅保持机械性(链接可解析、ID 唯一、引用文档存在、格式可解析),文档 lint 只证明机制,从不批准设计。验证上不能以顺利路径截图或 HTTP 状态代替交互验证,静态图不能验证动效;主机或接缝无法执行时须在 PR 记录确切未验证场景且不作完成声明。就绪标准包括:只创建或修改决定所需的材料且按链路顺序;用户、任务、结果与可观察验收清晰到足以证伪;交互、状态、保留、恢复、中断、返回、努力、放弃与非目标决定在改变含有时显式说明,且没有故事选择控件;四维度已考虑而无完整性台账;视觉与时间决定已由评审者渲染并检查;另一智能体可仅从仓库恢复控制性决定与已知缺口;未迫使任何决定的内容已移除。完成标准包括:实现保留所选体验,约束未静默改写它;真实流程及其失败与恢复路径已在代表性主机执行,或记录未验证接缝且不作完成声明;所需检查与相关测试已运行,受阻检查已记录;面向读者的文档描述当前目标并通过受众适配阅读。