[理论]高效AI开发(1)文档生成

[理论]高效AI开发(1)文档生成

_

萌狼蓝天编写于2026年4月8日

在使用ClaudeCode生成文档的过程中,最开始我是这样的:

 根据项目实际情况,完善文档 "C:\Users\xrilang\Desktop\boya-erp-prompt\业务规则\预算.md"                 ( °    ° )
  主要介绍有预算页面的业务规则,权限控制。语言表达要让产品经理听得懂,快速了解这个模块的情况   

生成文档化效果不错,继续

 "C:\Users\xrilang\Desktop\boya-erp-prompt\业务规则\预算表单填写规则介绍.md"                             /\    /\
  继续完善此文件文档,重点在于详细的介绍规则和计算方式,让用户知道该怎么填写,需要详细介绍各个数据的小数     ( °    ° )
  点保留位数,计算方式等。产品经理能通过该文档快速了解到相关的计算方式和规则限制,以便对该功能的掌控   

继续分析合同模块业务规则介绍,"C:\Users\xrilang\Desktop\boya-erp-prompt\业务规则\合同模块业务规则      ( °    ° )
  介绍.md"   

继续完善 "C:\Users\xrilang\Desktop\boya-erp-prompt\业务规则\合同表单填写规则介绍.md"  

目前对两个模块的列表页、表单页业务规则都编写了对应的文档,然而系统不止这两个模块,还有很多模块。

我需要能高效的完成多个模块文档的编写,也需要保证后续生成的文档也能和我之前生成的文档表达风格一致,质量一致

所以当下要做的,就是根据已经生产的四个文档,提取出prompt

 C:\Users\xrilang\Desktop\boya-erp-prompt\业务规则                                                        [___]
  现在已经生成了很多文档了,为了以后也能规范的生成相同风格的文档,现在需要写提示词到                          /\    /\
  "C:\Users\xrilang\Desktop\boya-erp-prompt\业务规则\AI生成业务规则文档提示词.md"                        ( °    ° )
  以便后续把这个提示给AI就能自行分析代码和数据库生成相应文档,保证文档风格一致性        

有了prompt之后,就可以根据prompt,要求AI同时生成多个模块的文档。

交流

很多时候AI生成的文档都很详细很完善,但是人类看着很不爽,最关键的一个因素是缺少阅读人群的设定。

在vibe coding场景下,我不关心它的字段命名,不关心代码在哪个文件我只关心“实现了什么功能”,“有什么规则”,“术语含义”,“计算方式”等。

所以我给它的设定是“产品经理阅读”,“帮助产品经理快速了解功能模块”,这样AI能有一个方向去行动,效果会好很多。

软件工程的同学如果为项目生成文档以便在论文中使用,可以考虑下“产品经理”角度生成文档

再比如说我让AI完成了一个功能,提交PR,就可以写:

目的,方案,改动 是关注的三个点(干什么,打算怎么干,实际执行方案)

我已经推送了代码,提起了PR,现在需要你编写一份介绍,以便PR审查人员能够快速了解到该PR的目的、方案、实际改动,提高审查效率

备注

ClaudeCode+GLM5.0

欢迎关注公众号 萌狼蓝天

为你分享更多AI使用技巧

[prompt]页面在数据加载后调整窗口尺寸出现显示不全的通用排查与修复说明 2026-04-02
[手机]真我Realme相关问题 2026-04-08

评论区