核心目标：实现研发全流程AI提效，通过自动化工具降低重复工作，依托小龙虾回测工具实现异常自动上报，保障研发质量。

一、平台核心定位

本平台是AI驱动的研发全流程自动化系统，核心是将AI能力嵌入研发全链路，替代产品、研发的重复性工作，实现从业务需求到代码合并提测的标准化、自动化管控，同时搭配小龙虾自动化回测工具，形成“研发+质量校验”的完整闭环。

1.1 技术栈说明

  • 前端：Vue3 + NativeUI（可视化流程管控、在线编辑）
  • 后端：Node.js（核心自动化逻辑、API封装、多系统联动）
  • 联动系统：Jira（需求、Bug管理）、GitHub（代码存储、分支管控）、Cursor（AI代码生成）、Pencil（原型联动）
  • 辅助工具：小龙虾自动化回测工具（独立部署，负责异常巡检与自动上报）

1.2 核心价值

  • 提效：自动化替代PRD撰写、分支创建、基础代码编写等重复工作，聚焦核心逻辑优化
  • 规范：统一PRD格式、代码规范、流程节点，降低跨角色沟通成本
  • 可控：全流程状态可视化、异常可回滚、权限可管控，确保流程可追溯
  • 保障：通过小龙虾自动化回测，实现7×24小时质量巡检，异常自动上报，减少人工测试负担

二、核心研发主流程（全链路落地步骤）

本流程覆盖从产品需求录入到代码合并提测的完整研发链路，各角色各司其职，流程有序推进，不跳过任何关键节点，确保研发过程标准化。

步骤1：产品 - 需求录入与PRD生成

  • 操作角色：产品经理
  • 核心动作：在AI平台输入清晰的业务需求描述（含业务场景、核心目标、约束条件），点击“生成PRD”
  • 平台动作：调用产品特定Prompt的GPT能力，自动生成标准化PRD（Markdown格式），AI自动校验PRD的核心需求完整性、格式规范性，提示产品补充缺失信息
  • 后续衔接：产品在线编辑、优化PRD，确认无误后提交评审

步骤2：产品 - PRD评审与Jira绑定

  • 操作角色：产品经理（协同研发、UI、测试评审）
  • 核心动作：组织线下/线上PRD评审会议，确认PRD无异议后，在AI平台录入对应Jira需求链接，点击“PRD确认”
  • 平台动作：自动提取Jira需求单号（如PROJ-123），同步PRD内容到Jira需求单，更新Jira需求状态为“评审通过”
  • 权限管控：仅产品经理拥有“PRD确认”操作权限，防止误操作

步骤3：平台自动 - 开发分支创建

  • 操作角色：无（平台自动化执行）
  • 核心动作：接收“PRD确认”指令后，自动调用GitHub API，从main分支新建功能开发分支
  • 分支规范：命名格式为「feature/jira-xxx-时间戳」（xxx为Jira需求单号），确保分支与需求强关联
  • 异常处理：若分支创建失败，自动重置流程状态为“分支创建失败”，记录失败日志，提示产品/研发排查问题，支持一键重试

步骤4：平台自动 - AI生成前后端代码

  • 操作角色：无（平台自动化执行）
  • 核心动作：调用Cursor API + Jira/Pencil MCP方案，基于PRD内容、Jira需求信息，自动生成符合技术栈要求的前后端代码（前端Vue3+NativeUI，后端Node.js）
  • 平台动作：同步更新流程状态为“代码生成中”，生成完成后，自动将代码存储到AI平台，关联对应开发分支
  • 联动Jira：自动更新Jira需求状态为“开发中”，添加分支链接备注，便于各角色查看进度
  • 异常处理：若代码生成失败（如Cursor API异常、MCP联动失败），自动回滚已创建的开发分支，更新流程状态为“代码生成失败”，记录失败原因

步骤5：研发 - 代码查看、编辑与Review

  • 操作角色：前端研发、后端研发
  • 核心动作：在AI平台查看自动生成的代码，可在线编辑优化（无需下载到本地），编辑完成后执行人工Code Review
  • 平台增强：AI自动执行二次Review，检查代码规范、是否符合PRD需求、有无语法错误，标注待优化点，降低人工Review成本
  • 权限管控：仅前后端研发拥有“代码编辑”“代码Review”权限，确保代码修改的规范性
  • 后续衔接：研发确认代码无误后，点击“代码确认”，提交至平台

步骤6：平台自动 - 代码提交与分支合并

  • 操作角色：无（平台自动化执行）
  • 核心动作：接收“代码确认”指令后，自动执行以下操作：
    1. 将编辑后的代码提交到对应开发分支
    2. 推送分支到GitHub仓库
    3. 发起PR（合并请求），将开发分支合并到test分支
  • 联动Jira：合并成功后，自动更新Jira需求状态为“待提测”，添加PR链接备注，通知测试人员准备提测
  • 异常处理：若代码提交失败或合并冲突，自动更新流程状态为“提交失败”或“合并失败”，展示冲突详情，通知研发手动处理，处理完成后支持重新提交合并
  • 权限管控：平台机器人账号仅拥有“创建分支、提交代码、合并到test分支”的权限，无法直接操作main分支，保障主分支稳定性

步骤7：测试 - test分支人工验证

  • 操作角色：测试人员
  • 核心动作：从GitHub拉取test分支最新代码，基于PRD需求，执行功能测试、业务流程测试、兼容性测试，验证代码是否符合需求预期
  • 平台联动：AI平台自动同步分支信息、代码详情、PRD内容到Jira，便于测试人员对照测试
  • 后续衔接：人工测试同时，小龙虾自动化回测工具同步启动，开展全量巡检

三、小龙虾自动化回测工具（独立模块）

小龙虾是独立部署的自动化巡检/回归测试工具，不参与研发主流程，仅在代码合并到test分支后启动，负责7×24小时持续巡检项目，发现异常后自动上报Jira Bug，全程无需人工干预，作为研发质量的自动化保障。

3.1 工具定位

  • 核心职能：自动化巡检、自动回归测试、异常捕获、Bug自动上报
  • 运行时机：代码合并到test分支后，实时启动，持续运行（7×24小时）
  • 核心价值：替代人工重复性回归测试，提升异常发现效率，确保问题及时上报、快速修复
  • 与主流程关系：不干预研发主流程，仅作为后置质量校验环节，补充人工测试的不足

3.2 核心功能（异常检测与自动上报）

小龙虾工具实时运行项目，自动检测各类异常（代码报错、接口失败、页面异常、流程卡顿等），发现异常后，全自动完成以下操作，无需人工介入：

1. 异常信息自动抓取（核心重点）

自动抓取完整的异常现场信息，确保研发可快速定位问题，具体包含：

  • 异常类型：代码报错、接口超时、页面渲染失败等
  • 代码关联信息：报错文件完整路径（精确到文件夹+文件名）、报错代码行号、报错堆栈信息
  • 项目信息：当前运行分支（test分支）、代码版本、触发异常的业务场景
  • 辅助信息：异常截图、系统日志、接口请求参数（便于复现问题）

2. Jira Bug单自动提交

基于抓取的异常信息，自动调用Jira API，生成标准化Bug单，无需测试人员手动创建：

  • Bug标题：自动生成，格式为「[小龙虾自动上报] 【test分支】xxx异常」（xxx为异常核心描述）
  • Bug描述：自动填充所有抓取的异常信息，重点标注「文件路径」「代码行号」「报错日志」，格式规范、信息完整
  • Bug属性：自动设置优先级（根据异常严重程度）、严重等级，关联对应Jira需求单号、test分支信息

3. 自动关联与通知

  • 关联逻辑：自动关联对应Jira需求单、GitHub test分支、异常代码文件，确保Bug与研发需求强绑定
  • 自动通知：Bug单创建后，自动指派给对应研发人员（根据代码归属），同时通过Jira消息推送通知，确保研发及时知晓并处理

3.3 运行与维护

  • 部署方式：独立部署在测试服务器，与AI研发平台、Jira、GitHub实现API联动
  • 维护职责：由测试团队负责日常维护，定期检查工具运行状态，处理工具本身异常
  • 异常处理：若小龙虾工具本身出现故障，自动发送告警通知维护人员，不影响研发主流程及人工测试

四、Bug修复与流程闭环

无论是测试人员人工发现的Bug，还是小龙虾自动上报的Bug，均遵循以下流程闭环，确保问题彻底解决：

  1. 研发人员接收Jira Bug通知，查看Bug详情（含小龙虾自动抓取的文件路径、代码行号等信息），定位问题根源
  2. 研发在对应开发分支修改代码，修复Bug，完成后提交代码，推送至GitHub，发起PR合并到test分支
  3. 平台自动合并代码，同步更新Jira Bug状态为“已修复”，通知测试人员复测
  4. 测试人员（人工）+ 小龙虾（自动）共同复测，确认Bug已修复
  5. 测试人员在Jira关闭Bug，流程闭环；若复测未通过，重新指派给研发，重复上述步骤

五、核心管控机制（全流程保障）

5.1 流程状态管控

平台通过数据库维护每个需求的全流程状态，确保流程可追溯、可管控，所有状态实时同步到前端步骤条，各角色可随时查看进度，具体状态如下：

PRD生成中 → PRD评审中 → PRD已确认 → 分支创建中 → 代码生成中 → 代码Review中 → 代码已提交 → 分支合并中 → 待提测 → 测试中 → 已完成（或Bug修复中）

5.2 异常回滚机制

全流程支持异常回滚，避免流程卡死，降低异常处理成本：

  • 分支创建失败：自动删除无效分支，更新状态，记录日志，支持一键重试
  • 代码生成失败：回滚已创建分支，更新状态，提示排查API或MCP联动问题
  • 代码提交/合并失败：保留代码及分支，展示失败原因，支持研发处理后重新提交

5.3 权限管控机制

明确各角色操作权限，防止越权操作，确保流程规范：

  • 产品经理：需求录入、PRD生成与确认、Jira需求绑定
  • 前端/后端研发：代码编辑、Code Review、代码确认、Bug修复
  • 测试人员：人工测试、Bug复测、小龙虾工具维护
  • 管理员：流程重置、权限配置、平台参数调整、异常排查

5.4 Jira全链路联动

平台与Jira实现全流程自动联动，无需人工同步信息，确保各角色信息一致：

  • PRD确认后：更新Jira状态为“评审通过”，同步PRD内容
  • 代码生成后：更新Jira状态为“开发中”，添加分支链接
  • 分支合并后：更新Jira状态为“待提测”，添加PR链接
  • Bug上报后：自动创建Jira Bug单，关联需求，指派研发
  • Bug修复后：同步更新Jira Bug状态，通知测试复测

六、技术实现摘要（核心要点）

6.1 数据库设计

核心数据表用于维护流程状态、权限、异常信息，关键表如下：

  • ai_rd_flow：存储需求全流程状态、PRD内容、代码信息、分支信息、异常日志等
  • ai_rd_permission：管控各角色操作权限，实现细粒度权限控制
  • crayfish_exception：存储小龙虾工具抓取的异常信息，便于追溯

6.2 核心自动化逻辑（后端Node.js）

  • PRD生成逻辑：封装GPT API，调用产品特定Prompt，返回结构化PRD
  • GitHub联动逻辑：基于Octokit SDK，实现分支创建、代码提交、PR合并自动化
  • Jira联动逻辑：封装Jira REST API，实现状态更新、Bug创建、信息同步
  • 小龙虾联动逻辑：封装小龙虾工具API，接收异常信息，触发Jira Bug自动提交

6.3 前端实现（Vue3+NativeUI）

前端核心实现可视化流程管控，支持：

  • 流程步骤条实时展示，状态清晰可见
  • 代码在线编辑、Review结果展示
  • 异常信息提示、流程重试操作
  • 角色权限控制，不同角色显示对应操作按钮

七、交付说明与使用要求

7.1 交付物清单

  • AI研发平台（前端+后端）部署包
  • 小龙虾自动化回测工具部署包
  • 数据库脚本（含表结构、初始化数据）
  • API联动配置文档（Jira、GitHub、Cursor密钥配置）
  • 本说明文档

7.2 使用要求

  • 所有角色必须使用公司统一账号登录平台、Jira、GitHub，禁止使用私人账号
  • 严格遵循研发主流程，禁止跳过关键节点、越权操作
  • 研发人员修复Bug时，需参考小龙虾自动上报的文件路径、代码行号，提高修复效率
  • 测试人员需配合小龙虾工具，完成人工复测，确保Bug彻底修复
  • 管理员定期检查平台及小龙虾工具运行状态，及时处理异常

八、总结

本AI驱动研发全流程平台，实现了从产品需求到代码合并提测的全链路自动化、标准化管控，搭配小龙虾自动化回测工具，形成“研发+质量校验”的完整闭环。平台不偏重于任何单一角色或环节，确保产品、研发、测试全流程协同高效，同时通过自动化工具降低重复工作，提升研发质量与效率，可直接落地执行，为团队研发提效提供有力支撑。