Vibe Coding 需求收敛：锁定目标用户与唯一主路径

“用户可以注册、上传资料、让 AI 分析、管理历史记录并分享结果”看似完整，实际没有主次。编程 Agent 会忠实地为每个名词生成页面，最后得到十个半成品入口，却没有一个人能从真实触发走到有价值的结果。首轮产品必须回答两个单数问题：现在优先服务谁？他最先要完整走通哪一条路径？

这一步承接可验证的问题陈述，但两者不能合并。一个问题可能影响自由职业者、财务助理和客户；同一产品也有操作者、购买者、审批者和被通知者。若不明确首要角色，AI 会把相互冲突的需要平均成通用界面。MVP 垂直切片要以这里选出的路径为骨架，而不是按技术层拆任务。

用行为条件识别人，而不是编造画像

目标用户不是“25 至 40 岁、热爱效率工具的职场人”。年龄和性格若不影响任务，就不能指导取舍。用可观察条件分群：任务发生频率、已有资料量、使用环境、权限、当前替代工具和后果。例如“每周至少收到 20 条客户反馈、目前用表格手工归类、本人能决定标签规则的产品经理”，能直接指导导入格式、批量大小和权限；“追求效率的产品经理”不能。

先列角色表，每行只写 role、goal、trigger、authority、frequency、currentTool、criticalConstraint。随后明确：

• primary user：首轮亲手操作并获得核心结果的人；
• supporting actor：为主路径提供输入或接收输出的人；
• buyer/approver：决定采购或授权，但可能不操作；
• operator：配置、审核或处理异常的人；
• excluded for now：需求真实，但本轮不服务的人。

首轮只能有一个 primary user。不是永久放弃其他角色，而是让冲突有明确裁决。例如分析客户反馈时，产品经理是主用户，客服只提供数据，团队负责人只接收分享链接；若同时为客服设计录入台、为负责人设计组合报表，切片已经扩成三个产品。

英国政府服务手册建议研究计划写清研究对象、需要回答的问题和招募方式。为每个筛选条件准备可核验问题，不问“你是否经常整理反馈”，而问“过去七天整理过几次？请打开最近一次使用的工件”。没法招募到该群体也是发现：要么渠道不成立，要么定义过窄，不能让 Agent 虚构 persona 补齐。

把主路径画成结果链

主路径不是站点地图，也不是页面清单。它从用户在产品外部遭遇的触发开始，到用户能确认的结果结束。使用六列：entry condition -> user action -> system response -> user decision -> completion evidence -> exit。每一步用动词和可见结果表达，不提前规定组件。

以反馈归类工具为例：

1. 产品经理刚导出一份 CSV，希望找出本周前三类问题；
2. 选择文件，看到可识别列和数据范围；
3. 确认分析，系统返回带原文依据的候选主题；
4. 合并或重命名主题，查看每类对应记录；
5. 导出一份含主题、数量和证据链接的结果；
6. 用户能用导出文件完成周会准备，任务结束。

“进入设置”“浏览仪表盘”不是结果，除非它们是不可绕过的决策。注册也常被误当第一步；如果首轮可用一次性本地会话验证价值，就不要为了账户体系中断主路径。反过来，若数据必须隔离到组织，身份和权限就是路径条件，不能靠 Demo 模式回避。

给路径定义唯一完成事件，如 evidence_report_exported，并说明它为何代表用户结果，而非按钮点击。记录完成所需前置数据、允许的中断点和恢复位置。加载、空数据、解析失败和无权限不属于“以后再说”，它们会在UI 状态矩阵中成为这条路径的分支。

同时画出三条反路径

只画 happy path 会把关键产品判断留给 Agent。至少补三条反路径：用户没有合格输入时怎样退出；系统不能产生可信结果时怎样解释且不伪造；用户发现结果错误时怎样修正或撤销。它们不是要求首轮实现所有恢复能力，而是迫使团队决定安全默认动作。

还要写 not a primary path 清单，例如“手工创建复杂分类体系”“邀请全公司协作”“跨月趋势分析”“自动发送报告”。新想法若不减少主路径的阻力，也不满足必须的安全或合规约束，就进入以后列表。这样 Vibe Coding 会话中即使 Agent 建议“顺便增加团队空间”，也有明确依据拒绝。

把路径变成 Agent 可执行的上下文

给 Agent 的输入包括角色表、路径版本、完成事件、反路径和非目标。先要求它输出一张“需求到步骤”映射：每个拟改文件服务哪一步；没有对应步骤的改动为什么必需；哪些信息仍缺失。禁止它在这个阶段补写虚构研究结论。若技术探索发现流程不可行，回到路径工件更新，而不是悄悄在界面中换一种行为。

测试也按用户旅程组织。最小端到端用例从真实入口数据开始，经过关键决策，到完成证据结束；组件测试覆盖局部分支，但不能取代全路径。完成标准和允许交付的制品由Definition of Done 与交付边界收口，路径上的数据关系则由数据模型与业务不变量固定。

W3C 的残障用户故事提醒团队：相同目标可能通过键盘、屏幕阅读器、放大或语音等不同交互方式完成。因此“唯一主路径”指唯一业务结果链，不等于只允许一种输入方式。首轮可以缩小功能范围，但不能把某类用户完成同一核心任务的基本可达性当作装饰。

当团队能用一句话说出“哪类人在什么触发下，经过哪些必要决策，拿到什么完成证据”，AI 才有稳定方向。页面多少、框架选择和动画效果都排在它后面。目标用户负责取舍，主路径负责顺序；两者明确后，快速生成才是在压缩交付时间，而不是加速堆积未完成页面。