📋 需求研发流程(按 SOP 阶段)
模式 1 一句话需求
还没有 PRD,只有一个想法 → 先把"要补哪些信息"列清楚
请先读取:
- .cursor/rules/course-dev-sop.mdc
- doc/dev/sop/README.md

一句话需求:<一句话描述>

本轮要求:不写代码,只做
1)【阶段判定】五要素
2)阶段1:结构化需求分析
3)输出 PRD 补充清单(产品经理需要补什么)
4)给出方案目录和 Story 草案(供产品经理评审+测试参与)
替换 <一句话描述> 即可,其余不用改
模式 2 完整需求(有 PRD)
已有 PRD 或 spec.md → 先做需求分析,弄清缺口与风险
请先读取:
- .cursor/rules/course-dev-sop.mdc
- doc/dev/sop/README.md
- <PRD/spec 路径>

当前任务:<需求名/编号>

本轮要求:不写代码,只做
1)【阶段判定】五要素
2)阶段1:结构化需求分析
   (角色×站点矩阵/范围与不做/现状摸底/缺口/风险清单)
替换路径和任务名即可
模式 3 阶段2:方案设计(9章)
需求分析完成后 → 输出可评审可验收的技术方案
请先读取:
- .cursor/rules/course-dev-sop.mdc
- doc/dev/sop/README.md
- doc/dev/sop/02-需求到方案设计-大模型转化提示词.md
- <PRD/spec 路径>

当前任务:<需求名/编号> 进入阶段2方案设计

本轮要求:不写代码,只输出 9 章方案文档
(背景目标/现状/目标架构/风险/实施阶段/验收清单/优化项/决策待办/文件索引)
方案文档建议落盘到 specs/xxx/plan.md
模式 4 阶段3:Story 拆解
方案完成后 → 拆成可供产品经理评审和测试的 Story 卡
请先读取:
- .cursor/rules/course-dev-sop.mdc
- doc/dev/sop/README.md
- doc/dev/sop/03-方案到迭代计划与Story分解-大模型转化提示词.md
- <plan 方案路径>
- <PRD/spec 路径>

当前任务:<需求名/编号> 进入阶段3拆 Story

本轮要求:不写代码,输出 Backlog(Epic→Sprint→Story)
每个 Story 包含:
  编号/Sprint/T1~T7类型/用户故事/AC(checkbox)
  /技术要点/涉及文件/SP/依赖/DoD
输出格式便于产品经理参与评审和验收测试。
产品经理直接拿 AC checkbox 做验收走查
模式 5 阶段5:单 Story 代码实现
Story 评审通过后 → 严格单卡实现,不混入其他 Story
请先读取:
- .cursor/rules/course-dev-sop.mdc
- <本 Story 卡内容/路径>

当前任务:实现 STORY-<x.x>(只做这一张卡)

要求:
- 先输出:修改计划/允许范围/禁止范围/验收方式
- 再开始实现
- 完成后输出:变更清单/测试证据/验收步骤/风险与跟进
禁止混入其他 Story。
每次只推进一张卡,便于回滚和评审
🔧 修复与排查
模式 6 Bug 修复(根因优先)
先给根因与方案,不直接改代码,要有回归用例
请先读取:
- .cursor/rules/bugfix-root-cause-first.mdc

问题描述:<现象/报错/复现步骤/日志>

本轮要求:先定位根因 + 给修复方案 + 回归验证计划
不要直接改代码,等我确认方案后再执行。
线上/联调问题,根因闭环 + 人工验收证据
模式 7 极简排查模式
你明确要"最小范围快速收敛",不要大展开
极简排查模式。

问题描述:<现象/复现/日志>

要求:只读、只看最相关 2~4 个文件
不开子代理、不生成任务单、不大范围搜索
先拿到根因证据再说。
说"极简排查模式"这几个字就会触发
🚀 部署与文档
模式 8 PRD 部署到 eyubook.com
PRD 写完后 → 构建 isv-fe 并上传到服务器
请先读取 @doc/dev/deploy-isv-prd.md

当前任务:<需求名> PRD 已写完,需要部署到 eyubook.com

需要你帮我:
1)确认改动影响的入口/路由/页面
2)给出构建命令 + 上传命令
3)给出验证步骤(HTTP 200 + hash 留证)
服务器:root@39.106.1.123
目录:/app/nginx_root/eyu/yuanxing/isv-app/
密码在终端手动输入,不放对话框
模式 9 纯文档修订 / 复盘归档
改文案、补版本记录、写复盘 → 不进入方案/Story/代码
请先读取:
- doc/dev/sop/README.md

当前任务:纯文档修订

目标:只输出"文档修订说明/变更记录/复盘报告"
不进入阶段2~5,不改业务代码。

修订内容:<说明要改什么>
改 PRD 文案、补 changelog、写复盘等轻量场景
📌 关键信息速查
你只需要补充的 3 类信息
任务类型 一句话需求 / 完整PRD / 方案 / Story / 部署 / Bug
权威输入路径 specs/.../spec.md、PRD 抓取、原型组件路径、plan/story 清单
本轮产出目标 只做阶段1?还是要到阶段3(Story 给产品经理评审/测试)?
SOP 六阶段一览
阶段0 PRD / 需求输入(产品经理提供)
阶段1 PRD → 需求分析(01号SOP)
阶段2 需求 → 方案设计(02号SOP)
阶段3 方案 → 迭代计划+Story(03号SOP)
阶段4 Story → Prompts工作台(04号SOP)
阶段5 代码实现(单Story单卡执行)
强约束命中(DB变更/鉴权/跨3模块/Story≥10)→ 必须完整走完阶段1+2+3
服务器快查
服务器 root@39.106.1.123
nginx root /app/nginx_root/eyu
ISV 目录 /app/nginx_root/eyu/yuanxing/isv-app/
构建 base /yuanxing/isv-app/
yuanxing-dev 服务器 /app/nginx_root/eyu/yuanxing-dev/(只读基线)
部署详情 doc/dev/deploy-isv-prd.md
密码不放对话框,在终端手动输入