目录
- 编写需求文档
- 一句话总规范（你可以直接写进团队规范）
- PM 需求文档必须满足的 6 大规范（核心）
- 1️⃣ 必须“显式声明用户与阶段”（禁止隐含）
- 2️⃣ 所有“触发条件”必须可判断（No vibes）
- 3️⃣ 目标必须是「用户行为变化」，不是业务口号
- 4️⃣ 策略 = 意图级，不得写执行手段
- 5️⃣ 约束必须显式写成“禁止项”
- 6️⃣ 决策分支必须写“判定依据”，而不是结果
- 1. 用户与阶段
- 2. 触发条件（可判断）
- 3. 问题定义
- 4. 目标（可观察）
- 5. 策略意图（非执行）
- 6. 约束（禁止项）
- 7. 决策分支定义
编写需求文档
3️⃣ 推荐做法
-
保留敏捷风格的 User Story
- 作为团队沟通、迭代和 backlog 使用
-
在 User Story 上增加 Spec Kit 辅助字段（可以称作“增强 PRD”）
- 用户状态（User State）
- 可判定触发条件
- 决策分支
- 策略意图
- 明确约束
这是一个非常关键且前置的问题。你已经走到 Vid Coding / Spec-driven Development 的“地基层”了。
我直接给你结论型答案，然后给一套可直接要求 PM 执行的文档规范，目标只有一个：
让 PM 写的文档，能被 AI 稳定、低歧义地转换为 Spec Kit 输入。
一句话总规范（你可以直接写进团队规范）
PM 需求文档必须“语义完整、结构稳定、避免隐式决策”，
但不包含任何系统实现细节。
PM 需求文档必须满足的 6 大规范（核心）
1️⃣ 必须“显式声明用户与阶段”（禁止隐含）
为什么
Spec Kit 的核心是 state / decision。
AI 无法从模糊描述中稳定推断用户阶段。
强制要求 PM 写清楚：
- 用户是谁（Persona）
- 当前所处阶段（Funnel / Journey）
✅ 合格：
用户：独立站新访客
阶段：Consideration（已询价，未下单）
❌ 不合格：
用户在犹豫
2️⃣ 所有“触发条件”必须可判断（No vibes）
Spec Kit 不能执行“感觉”。
PM 必须用可判断信号描述触发：
- 行为
- 频次
- 语义特征
✅ 合格：
触发条件：
- 连续 2 次询问价格
- 未出现支付相关关键词
❌ 不合格：
用户看起来很纠结
3️⃣ 目标必须是「用户行为变化」，不是业务口号
AI 需要 可观察的 success criteria。
✅ 合格：
目标：
- 用户询问支付方式
- 或明确提出反对点
❌ 不合格：
提高转化率
4️⃣ 策略 = 意图级，不得写执行手段
这是最容易写错的地方。
PM 写 “想达到什么心理或决策效果”，
不要写 “系统怎么做”。
✅ 合格：
策略：
- 建立价值对比
- 降低价格敏感度
❌ 不合格：
发送一个带按钮的限时优惠卡片
（这是 Spec / 实现层的事）
5️⃣ 约束必须显式写成“禁止项”
AI 默认会“为了达成目标不择手段”。
PM 必须明确什么不能做。
✅ 合格：
约束：
- 不得强制跳转支付
- 不得虚构库存紧张
❌ 不合格：
注意用户体验
6️⃣ 决策分支必须写“判定依据”，而不是结果
Spec Kit 需要 decision tree，不是 if-else 结果。
✅ 合格：
如果用户提出“太贵了”：
- 归类为价格异议
❌ 不合格：
如果太贵，就给优惠
（“给优惠”是 action，不是 PM 该写的）
1. 用户与阶段
- Persona：注册用户
- 当前阶段（Funnel / Journey）：Authentication（用户需要访问受限功能，但尚未登录）
2. 触发条件（可判断）
- 行为信号：
- 用户访问需要登录才能操作的页面（如购物车、订单详情）
- 页面检测到当前 session 未认证
- 频次 / 阈值：
- 每次访问受限页面
- 语义特征：
- 点击“登录”按钮或尝试访问受限资源
3. 问题定义
- 当前阻碍用户推进的核心原因是什么？
- 用户未登录，无法访问受限功能
4. 目标（可观察）
- 期望出现的用户行为变化：
- 用户成功输入正确凭证并完成登录
- 登录失败时用户收到明确错误提示并重新尝试
5. 策略意图（非执行）
- 决策/心理层面的策略：
- 提供清晰登录入口和反馈，减少用户困惑
- 对登录失败给出明确指导（例如“密码错误”或“用户不存在”）
6. 约束（禁止项）
- 明确不能做的事情：
- 不得在登录失败时泄露敏感信息（如完整密码或系统内部状态）
- 不得绕过验证机制
- 不得自动将用户重定向到支付页面或其他敏感操作
7. 决策分支定义
- 如果用户输入正确用户名和密码，则判定为“登录成功”
- 如果用户输入错误密码，则判定为“登录失败-密码错误”
- 如果用户输入不存在的用户名，则判定为“登录失败-用户不存在”
- 如果用户连续 5 次登录失败，则判定为“账户锁定”，需触发额外验证