dev-flow-full

Dev Flow Full - 完整需求开发流程

适用场景

• PM 给了一个原型/参考项目（A），用于理解业务
• 实际开发在另一个项目（B）中进行
• 需要完整经历"探索 → 理解 → 设计 → 开发 → 测试 → 上线 → 复盘"全流程

核心原则（必须严格遵守）

1. A 项目只读：进入 A 项目立即 /freeze + SwitchMode 进 plan 模式
2. 强制卡点：4 个硬卡点必须使用 AskQuestion 工具阻塞，严禁自行判断"我觉得 OK"继续
3. 垂直切片优先：水平铺开多 subagent 前必须先做最小端到端验证
4. 失败可回退：每阶段失败有明确退路，不允许"将错就错"
5. 产物可复用：所有中间产物落到 ~/Projects/_requirements/[feature]/

启动参数收集

执行流程前，使用 AskQuestion 工具一次性收集以下参数（如用户消息中已提供则跳过对应项）：

1. 需求名称（用于命名知识库目录，建议英文 kebab-case，如 supplier-batch-approve）
2. 原型项目 A 路径（智能扫描 ~/Projects/、~/Developer/、~/repos/ 推断后让用户确认）
3. 原型功能 URL（如 http://localhost:3000/admin/api/suppliers）
4. 目标项目 B 路径
5. PM 联系人（用于沟通记录归档）
6. 截止日期（可选）

收集后写入 ~/Projects/_requirements/[feature]/META.md（模板见 templates/META.md）。

流程执行

阶段 0：上下文初始化

1. 检查/创建 ~/Projects/_requirements/[feature]/ 目录
2. 写入 META.md
3. 加载 ~/Projects/_requirements/_lessons.md（如存在），将其内容作为本次开发的背景知识
4. 输出本次开发的整体计划摘要

阶段 1：A 项目探索（只读）

1. 使用 cursor-app-control MCP 的 move_agent_to_root 切换到 A 项目
2. 立即执行 /freeze 锁定 A 目录，严禁修改
3. 切换到 Plan 模式（SwitchMode 到 plan）
4. 使用 cursor-ide-browser MCP 走查目标 URL：
   • browser_snapshot 抓取页面结构
   • browser_take_screenshot 全页截图
   • 依次点击所有可交互元素，记录 URL 变化
   • browser_network_requests 抓取所有 API 请求
   • browser_console_messages 检查报错
5. 并行派发 3 个 explore subagent：
   • 任务 A：项目骨架（技术栈、目录结构、入口文件、构建脚本、运行环境特征）
   • 任务 B：目标功能的前端实现（路由、组件、状态管理、API 调用层）
   • 任务 C：目标功能的后端实现（路由定义、控制器、Service、数据库 Schema）
6. 抽象化输出 4 份文档到 ~/Projects/_requirements/[feature]/：
   • BUSINESS_FLOW.md - 业务流程（用户故事 + 截图 + mermaid 流程图，禁止包含具体代码）
   • API_CONTRACT.md - 接口契约（业务含义/入参/出参/错误码/幂等性，用通用描述，不绑定框架）
   • DATA_MODEL.md - 数据模型（实体/字段/关系/枚举/校验，用通用 ER 描述）
   • ENV_NOTES.md - A 项目运行环境特征（mock 数据？真实环境？特殊配置？）

阶段 2：需求循环 ⏸ 卡点 1（可循环）

1. 调用 gstack-office-hours 技能视角挑战需求文档
2. 输出 questions-for-pm.md，包含：
   • 模糊不清的业务规则
   • 缺失的边界场景（错误/并发/权限/空状态）
   • 互相矛盾的地方
   • 每个问题给出 AI 的猜测和需要 PM 确认的具体点
3. 调用 AskQuestion 工具阻塞等待，问题示例：

   prompt: "需求文档已生成，请查看 questions-for-pm.md。请选择："
   options:
     - "已和 PM 沟通，提供答复（粘贴在下条消息）"
     - "需求清楚无疑问，进入下一阶段"
     - "需要重新探索 A 项目某些细节"
   

4. 收到 PM 答复后：
   • 更新需求文档
   • 追加到 pm-answers.md 沟通记录
   • 再次 AskQuestion 询问"还有疑问吗？"
   • 循环至用户选择"无疑问，进入下一阶段"