番外篇|用AI写文档:PRD·技术方案·测试报告·BP
番外篇:用AI写PRD、技术方案、测试报告、BP——我把AI当「文档合伙人」的6个月经验
做「颐和顺安」小程序的20天里,我产出了17份文档:PRD、技术方案、接口文档、测试报告、用户手册、BP……
如果按传统方式,这些文档至少要花2周。实际上,我用了不到3天。
这篇文章,把我在「用AI写文档」这件事上的完整方法论,毫无保留分享给你。
一、用AI写文档的「黄金Prompt公式」
不管写什么文档,我的Prompt都遵循同一个结构。这个结构,我管它叫「黄金Prompt公式」:
【任务】请帮我撰写一份【文档名称】,用于【使用场景,如:给开发团队看的技术方案/给投资人看的BP】。
【背景】项目简介:【用3-5句话描述项目】
【要求】
1. 结构完整,包含:【列出你希望包含的章节,如:项目背景、技术方案、风险评估】
2. 深度适中,面向【读者身份,如:技术人员/非技术投资人】
3. 使用清晰的小标题,便于阅读
4. 长度控制在【X】字左右
【输出格式】Markdown格式,使用二级标题(##)和三级标题(###)组织结构。
请先列出大纲,确认后再展开撰写。
为什么这个公式有效?
因为它强迫你在写Prompt之前,先想清楚:谁读这个文档?用来做什么?希望达到什么效果?——这三点想清楚了,文档就成功了一半。
二、四种文档的AI辅助实战(含Prompt模板)
【任务】为「陪诊服务微信小程序」撰写一份完整的PRD(产品需求文档)。
【项目背景】
– 产品名称:颐和顺安
– 核心价值:为老年人提供专业陪诊服务,解决看病无人陪的问题
– 目标用户:65岁以上老年人及其子女
– 核心功能:预约下单、陪诊师匹配、订单管理、支付、评价
【要求】
1. 包含:产品概述、用户角色、功能清单(按优先级排序)、核心流程描述、异常场景处理、非功能需求
2. 功能描述使用「用户故事」格式:作为【角色】,我希望【操作】,以便【价值】
3. 面向开发团队,深度适中,便于直接用于开发排期
4. 总长度控制在3000字左右
请先输出PRD大纲,我确认后再逐节展开。
【任务】为「陪诊服务小程序」设计后端技术方案。
【约束条件】
– 前端:微信小程序原生框架
– 后端语言:Node.js(Express框架)
– 数据库:MySQL
– 部署:腾讯云服务器
– 必须支持:微信支付、短信验证码登录、微信登录
【输出要求】
1. 系统架构图(用文字描述各层职责)
2. 技术选型理由(为什么选Express而不是Koa?为什么选MySQL而不是MongoDB?)
3. 核心数据表设计(用户表、订单表、陪诊师表)
4. 关键接口设计(RESTful风格,含请求/响应示例)
5. 安全风险及应对措施
输出格式:Markdown,使用代码块展示SQL和接口示例。
【任务】为「陪诊小程序」的「预约下单」功能,设计完整的测试用例。
【功能描述】
用户选择服务类型(半天/全天)→ 选择日期和时间 → 填写患者信息 → 选择陪诊师(可选)→ 确认订单 → 微信支付 → 订单创建成功
【要求】
1. 覆盖:正常流程、异常流程、边界条件
2. 每个用例包含:用例编号、测试目的、前置条件、操作步骤、预期结果
3. 按优先级排序(P0=必须过,P1=重要,P2=一般)
4. 输出格式:Markdown表格
另外,请根据以下Bug列表,帮我写一段「测试总结」:
[粘贴Bug列表]
【任务】请帮我撰写「颐和顺安」陪诊服务平台的BP大纲,并展开撰写「市场分析」和「商业模式」两节。
【项目简介】
[粘贴项目简介,3-5句话]
【要求】
1. BP大纲包含:执行摘要、市场分析、产品服务、商业模式、竞争分析、团队、财务预测、融资计划
2. 「市场分析」一节要有数据支撑(老年人口、陪诊市场规模、增长率)
3. 「商业模式」要清晰描述收入来源、成本结构、单位经济模型
4. 面向天使轮投资人,语言专业但不堆砌术语
5. 总长度:大纲+两节展开,共约2500字
请先输出BP大纲,我确认方向后再展开。
三、用AI写文档的5个「坑」(一定要注意)
四、读者问答(Q&A)
用AI写文档,还需要学文档写作规范吗(比如PRD怎么写)?
需要,但不需要「精通」。你至少要懂:PRD里为什么要写「异常流程」?技术方案里为什么要画架构图?知道这些「为什么」,你才能判断AI写得好不好、缺不缺东西。我的建议:花半天看一篇优秀的PRD范本,知道每部分的作用,就够了。
AI写的BP能直接拿去见投资人吗?
大纲和结构可以,具体内容必须人工填充和核实。投资人最在意的是:你对市场的真实理解、你的数据是否真实、你的商业模式是否经过验证。这些,AI帮不了你。AI能帮你的是:把你的真实思考,整理成逻辑清晰、表达专业的文档。
你用的哪个AI工具?需要付费吗?
我主要用WorkBuddy(AI助手)。写文档用文字对话就行,不需要特定工具。关键是Prompt的质量,不是用哪个AI。如果你用的是免费版AI,有个技巧:把大文档拆成几段,分段让AI处理,可以绕过字数限制。
我们团队有专职的技术文档工程师,AI会取代他们吗?
不会,但会用AI的文档工程师会取代不会用的。AI擅长整理、格式化、生成模板化内容;人擅长判断优先级、理解读者需求、把握文档策略。最好的状态是:AI处理80%的体力活,人专注于20%的判断和决策。
五、小结:AI写文档的「能力边界」在哪里?
最后,我想帮你画一条清晰的线:哪些事AI能帮你做,哪些事必须你自己做。
· 整理零散想法成结构化文档
· 补充你没想到的场景/问题
· 优化表达,让文档更专业
· 生成模板化内容(接口文档、测试用例)
· 润色和校对
· 提供真实的项目背景和数据
· 判断AI写的内容对不对、全不全
· 核实AI生成的数据(尤其是市场数据)
· 注入你的思考和判断
· 最终的质量把关
AI让「写文档」从负担变成了杠杆。
希望你读完这篇文章后,也能用AI,把自己的文档效率提升3倍。
如果有具体问题,欢迎在公众号后台留言,我会挑典型问题回复。
回到开头:【1/11】开篇 →
夜雨聆风