pm-user-story

Preamble (run first)

bash "$(dirname "${BASH_SOURCE[0]}")/../../check-update.sh" 2>/dev/null || true
# 检查方案设计目录
mkdir -p docs/02-方案设计

# 检查前置文档
echo "📊 正在检查前置文档..."

if [ -f "docs/02-方案设计/PRD产品需求文档.md" ]; then
  echo "✅ PRD文档 - 已找到"
else
  echo "⏳ PRD文档 - 未找到"
fi

if [ -f "docs/02-方案设计/功能细节拆解.md" ]; then
  echo "✅ 功能细节拆解 - 已找到"
else
  echo "⏳ 功能细节拆解 - 未找到"
fi

---

跨 Agent 交互规则

当流程要求与用户交互时：

1. 如果当前环境支持 AskUserQuestion，使用 AskUserQuestion（最佳体验）。
2. 如果当前环境不支持 AskUserQuestion，必须用普通聊天消息提出同样问题。
3. 一次只问一个问题。
4. 提问后必须停止当前回合，等待用户回答（STOP and WAIT）。
5. 不得在用户回答前生成文档、写入 docs。
6. 已有 docs 文件不能替代本轮用户回答。

---

执行流程

步骤 1: 选择用户故事范围

使用 AskUserQuestion 询问：

您需要编写哪方面的用户故事？

A) 全部功能用户故事（基于PRD功能列表） B) 单个模块的用户故事（请指定模块） C) 单个功能的用户故事（请指定功能） D) Epic级用户故事（高层次需求） E) 其他（请手动输入）

💡 提示：

• Sprint规划 → 推荐单个模块的用户故事
• 产品规划 → 推荐Epic级用户故事
• 开发准备 → 推荐全部功能用户故事

记录到变量 STORY_SCOPE

---

步骤 2: 读取前置数据

根据范围读取相应文档：

必需文档：

• PRD产品需求文档（如果存在）
• 功能细节拆解（如果存在）

可选文档：

• MVP方案
• 用户画像

读取失败处理：

如果 PRD 文档不存在：

⚠️ 未找到 PRD 文档

用户故事需要明确的功能需求作为输入。

您可以选择： A) 执行 /pm-docs 生成 PRD B) 使用功能细节拆解作为输入 C) 手动输入功能需求（快速模式）

---

步骤 3: 用户故事编写原则

📝 用户故事标准格式：

作为 <角色>
我想要 <功能>
以便于 <价值>

验收标准（BDD格式）：

GIVEN <前置条件>
WHEN <触发操作>
THEN <预期结果>

是否继续编写？

A) 理解了，开始编写 B) 我需要更多示例 C) 我有特定的编写规范

---

步骤 4: Epic级用户故事

4.1 识别Epic

基于PRD识别出Epic：

Epic ID	Epic名称	描述	包含Story数
E001	用户管理	用户注册、登录、信息管理	5
E002	商品浏览	商品列表、搜索、详情	4
E003	购物车管理	加入购物车、编辑、结算	3
E004	订单管理	订单创建、支付、查看	6

是否需要调整Epic划分？

A) 划分合理，继续 B) 需要调整 C) 我有其他划分方式

4.2 Epic详细描述

对每个Epic进行描述：

**Epic: E001 用户管理**

作为 产品系统
我想要 提供用户管理功能
以便于 用户可以注册登录，管理个人信息

业务价值：
- 用户可以拥有个人账号
- 支持个性化服务
- 提供用户数据用于数据分析

包含Story：US001-US005
优先级：P0
预估工时：5人天

逐个对每个Epic确认后继续。

---

步骤 5: Story级用户故事

5.1 逐个编写Story

对每个功能，按以下模板编写用户故事：

US001: 用户注册

作为 新用户
我想要 通过手机号注册账号
以便于 拥有个人账号，享受个性化服务

验收标准 - 场景1：正常注册

GIVEN 用户未注册过，打开注册页面
WHEN 用户输入手机号、验证码、密码，点击"注册"
THEN 创建账号成功，自动登录，跳转到首页

场景2：手机号已注册

GIVEN 手机号已注册
WHEN 用户输入该手机号
THEN 提示"已注册，请直接登录"

场景3：验证码错误

GIVEN 用户已获取验证码
WHEN 输入错误验证码
THEN 提示"验证码错误"，允许重新输入

技术备注：验证码5分钟有效，密码bcrypt加密 依赖：无 风险：验证码发送失败 → 提供邮箱注册备选

这个用户故事是否完整？

A) 完整，继续下一个Story B) 需要调整 C) 需要补充更多场景