用途:在设计屏幕或编写代码前,把用户完成任务的路径显式化,覆盖有意义的分支而非仅顺利路径。
主要能力:梳理用户目标、角色、入口点与成功结果;逐步映射顺利路径;补充校验错误、空状态、API 错误、权限失败、取消、返回导航、重复操作和成功等分支;识别各分支所需 UI 状态与提示;识别数据/API/认证触点;区分 v1 必需步骤与可延后路径。
使用方式:按固定输出格式产出,包含用户流标题、用户、入口点、成功结果、步骤链、分支与边界情况、所需 UI 状态、数据/API/认证触点、V1 范围/延后路径、开放问题。资料给出“创建项目”示例:从仪表盘“New project”按钮进入,经创建表单校验通过后 POST /api/projects,最终到达项目详情页;分支涵盖校验错误、API 失败、名称已存在、取消/返回、会话过期等。
适用场景:产品、原型、仪表盘、引导、结账、创建、编辑、审批、账户等流程的前期设计。
限制:页面/路由结构问题应改用 $sitemap-planner;需要组件级行为应改用 $component-spec-writer。最终前需验证流程含入口点、成功目的地、至少一个失败分支和所需 UI 状态;任何数据变更需包含待处理、成功和失败行为。避免只展示顺利路径、只标注失败而无恢复路径、忽略取消/返回/重试后的持久化、遗漏权限和会话过期分支。其他细节暂未提供。