dev-implement

Dev Implement - 开发实现阶段

适用场景

完整开发流程的核心阶段。前置条件：

• 已通过 /dev-understand 或手动方式生成 ~/Projects/_requirements/[feature]/ 的需求文档
• 目标项目 B 已确定

本阶段产出：实际代码 + 自查报告。

核心原则

1. 先垂直切片再水平铺开：避免 3 个 subagent 同时朝错方向跑
2. 复用优先于新建：必须先做复用审计
3. 原子 commit：每子任务完成立即 commit，不要堆积
4. 强制卡点：方案确认 + 切片确认 用 AskQuestion 阻塞

启动参数收集

使用 AskQuestion 工具一次性收集：

1. 需求名称（用于定位 ~/Projects/_requirements/[feature]/）
2. 目标项目 B 路径
3. 是否新建 git 分支（默认是，分支名 feature/[feature-name]）

启动前必须验证：~/Projects/_requirements/[feature]/ 存在且包含 BUSINESS_FLOW.md / API_CONTRACT.md / DATA_MODEL.md。否则提示用户先跑 /dev-understand。

流程执行

前置：加载需求上下文

1. 必读 ~/Projects/_requirements/[feature]/ 下所有文档作为本次开发的输入
2. 加载 ~/Projects/_requirements/_lessons.md（如存在）作为经验背景
3. 输出对需求的理解摘要，让用户快速校对

阶段 3：B 项目地形勘察 + 复用审计

1. move_agent_to_root 切到 B 项目
2. 确保是 Agent 模式（如在 plan 模式则 SwitchMode 切回）
3. 并行派 3 个 explore subagent：
   • 项目骨架（栈/结构/构建启动/规范/git 工作流）
   • 类似功能定位（项目里有没有类似实体？已有 CRUD 模板？字段命名习惯？）
   • 横切关注点（鉴权/日志/校验/错误处理/测试约定）
4. 输出 docs/PROJECT_CONVENTIONS.md（B 项目规范摘要）
5. 输出 docs/REUSE_AUDIT.md（复用审计），格式见 ~/.cursor/skills/dev-flow-full/templates/REUSE_AUDIT.md

阶段 4：方案设计 + 影响分析 ⏸ 卡点

1. 创建 git 分支：git checkout -b feature/[feature-name]（如用户选择）
2. 输出 docs/IMPLEMENTATION_PLAN.md，包含：
   • A 概念到 B 实现的翻译映射表
   • 新建文件清单（必做/应做/可选标注）
   • 修改文件清单
   • 数据库迁移方案（如需）
   • 依赖检查（B 是否缺必要的库）
3. 输出 docs/IMPACT_ANALYSIS.md：
   • 反向依赖链
   • 回归风险点
   • 建议回归测试范围
4. 调用 /plan-eng-review 评审方案
5. 调用 AskQuestion 阻塞等待：

   prompt: "方案设计完成。核心改动：[摘要]。请选择："
   options:
     - "方案通过，进入切片验证"
     - "需要修改方案（请提供修改意见）"
     - "需要重新做复用审计"
   

阶段 5：垂直切片验证 ⏸ 卡点

1. 选最具代表性的端到端场景（通常是核心 CRUD 中的"列表"或"读"）
2. 实现最小切片：1 个接口 + 1 个页面 + 1 个测试
3. 手动跑通切片，验证：
   • 技术栈假设正确
   • 与现有代码协同无冲突
   • 性能/规范符合 B 项目要求
4. 切片代码独立 commit：

   git commit -m "feat([scope]): 实现垂直切片验证"
   

5. 调用 AskQuestion 阻塞等待：

   prompt: "垂直切片完成并通过验证。请选择："
   options:
     - "切片 OK，水平铺开剩余功能"
     - "切片暴露问题，回方案设计阶段"
     - "需要先做更多切片验证"