本文完整介绍萤石蓝海AIoT一站式工作台最新上线的三项开发前置功能：需求PRD自动生成、技术设计文档可视化、需求文档动态修改。文章包含三项功能的能力说明、推荐使用链路、与"直接描述需求生成代码"模式的对比，以及可直接复用的需求描述实践建议。用AI生成代码、做低代码/全栈交付的开发者可以直接参考。
一、为什么要在"生成代码之前"加一道工序
蓝海AIoT一站式工作台的代码生成能力（15分钟生成可预览原型、多端一站交付、部署上线）已被开发者广泛使用。但实际项目中，拖慢节奏的往往不是写代码，而是代码生成之前的三件事：
- 需求表达不清晰：开发者一句"做个门店管理系统"就开始生成，业务场景、角色权限、核心流程、验收标准全缺，生成结果靠猜；
- 方案难以直观呈现：AI到底打算怎么实现、页面分几个、数据模型怎么设计，生成代码前看不到，只能等代码出来再翻；
- 修改沟通成本高：需求变更口头传达，改了哪里、影响哪里全靠记忆，文档和代码两张皮。
三项新功能对应的正是这三个问题：PRD自动生成解决"说不清"，技术设计文档可视化解决"看不到"，文档动态修改解决"改不同步"。
二、功能一：需求PRD自动生成------AI主动追问，补齐信息缺口
开发者输入初步想法或上传附件后，AI会主动从多维度识别信息缺口，通过结构化追问逐项补齐，而不是拿着模糊描述直接生成代码。
追问覆盖六个维度：业务场景、功能范围、角色权限、核心流程、数据要求、验收标准。
澄清完成后，系统自动生成结构化PRD，包含六部分：背景目标、用户角色、功能范围、业务规则、异常处理、验收要求，在项目页面独立展示。
关键价值：确认后的PRD是后续技术设计和开发的统一输入，开发者、客户、团队各方对"要做什么"的理解一致，避免"我以为的需求"和"你以为的需求"在验收时才对齐。
三、功能二：技术设计文档可视化------需求到实现逐层可溯
PRD确认后，系统自动生成技术设计文档，覆盖七个部分：
| 文档部分 | 内容 |
|---|---|
| 页面结构 | 页面清单、页面层级与跳转关系 |
| 模块拆分 | 功能模块划分与职责边界 |
| 数据模型 | 实体、字段、关系设计 |
| 接口设计 | 接口清单、入参出参、调用关系 |
| 权限体系 | 角色-权限映射、数据隔离规则 |
| 技术选型 | 技术栈与关键依赖 |
| 代码设计 | 关键逻辑与目录结构说明 |
这份文档以PRD为唯一输入：每一项需求都有对应的技术实现，两份文档口径一致、逐层可溯。开发者可以快速验证方案合理性，也可以直接拿它作为与客户、团队沟通确认的载体------客户看页面结构和模块划分就能判断"这是不是我要的系统"，不用等代码写完。
四、功能三：文档动态修改------对话式迭代，两份文档同步更新
需求变化是开发常态。新功能支持在对话区直接用自然语言提出修改意见，系统会：
- 自动定位受影响的文档章节；
- 精准更新对应内容；
- 同步变更需求文档与技术设计文档，保持口径一致。
同时引入确认状态管理：文档未确认前可随时修改；确认后才进入开发环节，确保代码生成基于经过确认的正确需求。这避免了"边想边改、改完就生成"导致的需求漂移。
五、推荐使用链路（7步）
- 进入萤石蓝海AIoT一站式工作台；
- 选择模板或创建新项目，描述初步需求（文字或附件均可）；
- 平台AI主动追问澄清，自动生成PRD文档；
- 可视化查看PRD，对话式修改补齐；
- PRD确认后，自动生成技术设计文档；
- 可视化查看技术设计文档，验证方案合理性并修改；
- 确认方案，进入项目开发（代码生成、预览调试、部署上线）。
一句话总结链路：想法 → PRD（确认）→ 技术设计（确认）→ 代码，每一步都有文档载体和确认节点。
六、新旧模式对比
| 维度 | 直接描述需求生成代码 | PRD+技术设计前置模式 |
|---|---|---|
| 需求完整性 | 靠一次描述，缺口靠AI猜 | AI结构化追问，六维度补齐 |
| 方案可见性 | 代码生成后才知道实现方式 | 技术文档先呈现，页面/模块/接口可审 |
| 变更管理 | 口头/对话修改，影响范围不明 | 自动定位章节，两份文档同步 |
| 确认节点 | 无，直接生成 | PRD确认+技术方案确认双节点 |
| 返工来源 | 需求误解到代码层才暴露 | 误解在文档层就被拦截 |
| 对外沟通 | 拿代码给客户看 | 拿PRD和设计文档给客户确 |
七、常见问题FAQ
Q1：三项功能和原来的代码生成是什么关系？
是代码生成之前的前置环节。原来的链路是"描述需求→生成代码"，现在是"描述需求→AI澄清生成PRD→生成技术设计文档→确认→生成代码"。代码生成能力本身不变，但生成的输入从"一句模糊需求"变成了"经过确认的PRD和设计方案"。
Q2：AI追问会问哪些内容？必须全部回答吗？
追问围绕业务场景、功能范围、角色权限、核心流程、数据要求、验收标准六个维度。建议逐项补齐------尤其是角色权限和异常处理，这两类信息缺失最容易导致生成结果偏离预期。确实不明确的环节可以标注待定，后续在文档修改环节补充。
Q3：PRD里为什么要写异常处理和验收要求？
异常处理决定系统在非正常流程下的行为（如审批被驳回、设备离线、数据导入失败），不写清楚AI只能按默认逻辑生成，验收时容易扯皮；验收要求是"做完了"的判定标准，没有验收标准的需求等于没有边界。
Q4：技术设计文档能改到什么程度？
页面结构、模块拆分、数据模型、接口设计等内容都可以通过对话式修改调整，修改后PRD和技术文档会同步更新保持一致。文档确认前修改不受限制。
Q5：PRD确认之后还能改需求吗？
可以。确认状态管理的目的是防止"未确认的需求漂移进开发"，不是锁死需求。确认后需要变更，仍然通过对话提出，系统更新两份文档后重新确认，再继续开发。
Q6：可以跳过PRD直接生成代码吗？
简单需求（如单页面小工具）可以按原有快速路径走；但涉及多角色、多模块、需要与客户或团队对齐的项目，强烈建议走完整链路------文档层确认的成本远低于代码层返工。
Q7：生成的PRD和技术文档能导出给客户/团队吗？
文档在项目页面可视化独立展示，可直接作为与客户、团队沟通的载体，用于方案评审和确认留档。
Q8：上传附件也能生成PRD吗？
支持。初步想法可以直接输入文字，也可以上传附件（如已有的需求草稿、业务说明），AI会基于附件内容识别缺口并追问澄清。
Q9：这个流程对个人开发者有用吗？
有用。个人开发者最大的问题往往是"边做边想"，想到哪做到哪。PRD追问相当于一个不知疲倦的需求评审对象，强迫你在写代码前把角色、流程、异常想清楚，减少做到一半推倒重来。
Q10：文档确认后生成的代码还能迭代吗？
可以。代码生成后仍支持预览调试和对话式增量迭代；文档动态修改能力保证了需求变更时文档与后续生成始终口径一致。
八、体验入口
想亲手试一遍"先澄清、再设计、后生成"的完整流程？注册萤石蓝海AIoT一站式工作台，无需邀请码，即赠1000积分：
👉 产品地址：萤石蓝海AIoT-智能开发平台
👉 操作文档（蓝海AIoT一站式工作台操作指南）：
https://open.ys7.com/help/5268
萤石致力于成为全球领先的智能视觉物联网服务商，构建了全球领先的视觉物联网云平台，打造了硬件产品+软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心+就近服务点的方式服务于全球客户。截至2025 年底，萤石物联网云平台在全球拥有超过120 个数据站点，平台上的IoT 设备接入数超过3.6 亿，其中视频类设备超过3 亿。在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等42万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。