夜雨聆风
Day 4:一天写完 11 份技术文档,AI 是怎么帮我的?
今天干了什么？
今天干了一件大事：给醉漫楼的数字化系统写技术文档。
啥是技术文档？就是告诉程序员（或者 AI）这个系统要怎么做。
一般人做软件，都是直接开始写代码。
我没这么做。
我先让 AI 写了 11 份文档，把整个系统设计清楚了，再开始写代码。
耗时: 1 天文档字数: 50,000+ 字代码: 还没写（明天开始）
为什么要先写文档？
很多人不理解：直接写代码不就行了吗？为什么要写文档？
我刚开始也这么想。
但 AI 跟我说了一句话，我觉得很有道理：
“老大，就像盖房子要先画图纸一样，做软件也要先设计清楚。不然写到一半发现不对，改起来更麻烦。”
我想想也是。
之前做过装修的都知道，如果你不先画图纸，装到一半发现插座位置不对，那得砸墙重装。
做软件也一样。
文档就是软件的图纸。
11 份文档都写了什么？
我给你列个清单：
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
合计: 77,967 字
你要是一个字一个字敲，得敲多久？
AI 只用了 1 天
我是怎么跟 AI 沟通的？
今天大部分时间，我都在跟 AI 聊天。
不是瞎聊，是有目的的探讨。
我给你看几个关键对话：
对话 1：需求确认
AI: 老大，让我再确认几个细节：1. 预制菜业务目前已经有具体规划了吗？2. 配送范围是松滋本地还是全国？3. 会员体系您想做成什么样的？
我: 预制菜目前就是准备做蒸牛肉，排骨火锅，鸡子火锅，要看当天单量做完了，冷冻了真空打包。配送范围是全国，邮寄的那种冷链的。会员系统可以先不做。
AI: 好的，那我设计的时候，会员系统的表结构先留好，功能后面再加。
你看，AI 会主动问问题。
它不是机械地执行命令，而是真的在思考怎么把系统设计好。
对话 2：技术选型
我: 技术不考虑性能的话可不可以用 python，我熟悉一些
AI: 好的老大！技术栈我这样定：Python Flask + Vue3 + MySQL
AI: Python Flask 您熟悉，上手快。Vue3 做前端，好维护。MySQL 存数据，稳定。
你看，AI 会考虑我的实际情况。
不是选”最流行”的技术，而是选”最适合”的技术。
对话 3：需求变更
AI: 公众号菜单 3 个菜单，我建议这样…
我: 不能改变原有的服务号的菜单模式吖，你之前不是给我规划好了。而且不能出现预制菜的字样，你都忘了吗。
AI: 老大批评得对！我确实有些之前规划好的内容没记住。
AI: 那我调整一下，”预制菜”改成”火锅到家”，菜单保持原有规划。
你看，AI 会犯错，但会改。
我提醒它，它马上认错，马上调整。
这比某些固执的程序员强多了。
对话 4：文档要求
我: 开发阶段的话，你的所有的步骤，包括你的原型图、UI 设计，还有接口文档，都需要有完整的记录，然后存到醉漫楼的项目里面。
AI: 明白！我会创建完整的项目目录，所有文档都会保存好，方便您随时查看。
你看，你只要说清楚要求，AI 就能做到。
它不会嫌麻烦，不会偷懒，会严格按照你的要求来。
文档写完了，有什么好处？
你可能会问：文档写完了，代码还没写，这有什么用？
用处大了。
1. 思路清晰了
写文档的过程，就是把需求想清楚的过程。
比如数据库设计，AI 设计了 9 张表：
-
菜品表（60 道菜品） -
包间表（11 个包间） -
订单表（堂食订单） -
订单明细表（每个订单的菜品） -
预制菜商品表（3 个商品） -
预制菜订单表 -
用户表 -
通知配置表
每张表是干啥的，存什么数据，字段怎么设计，都写得清清楚楚。
这要是不写文档，直接写代码，写到一半发现表设计错了，那得改多少代码？
2. 沟通高效了
以后要是找程序员开发，不用口头说。
直接把文档给他，他一看就明白要做什么。
省了多少沟通成本？
至少省了 80%。
3. 后续可维护了
文档写清楚了，以后谁接手都能看懂。
不然代码写完了，没人知道怎么改，那就成黑盒了。
AI 的设计思路
今天我看 AI 做设计，发现它有这几个特点：
1. 先问再做
AI 没有一上来就给我方案，而是问了我 15+ 个问题：
-
预制菜有几种？价格多少？ -
包间有几个？ -
谁用管理后台？ -
消息通知发给谁？ -
预算多少？ -
什么时候上线？
这些问题问完，方案才靠谱。
2. 预留扩展
AI 设计的时候，一直在说”预留接口”：
-
权限系统：先留好字段，后期再拓展 -
会员系统：可以先不做，但表结构留好 -
消息通知：做成可配置的，不用改代码
这种设计思路，让系统有成长性，不会做死。
3. 文档习惯好
AI 坚持要写文档，我一开始觉得麻烦，后来发现：
- 需求文档
– 避免后面扯皮 - 原型图
– 提前看到长什么样 - 接口文档
– 以后能对接 - 开发日志
– 知道每天干了什么
这些文档，本身就是运营日记的素材。
给想学 AI 编程的人几点建议
经过今天的实践，我有几点体会：
1. 不要怕，直接开始
我以前也觉得编程很难，今天发现：
你不需要会写代码，但你要会描述需求你不需要懂技术，但你要懂业务你不需要什么都知道，但你要会提问
2. 把 AI 当合作伙伴，不是工具
我跟 AI 的对话，更像是同事之间的讨论：
AI: 老大，这个消息通知您希望用什么方式？
我: 我需要听听你的建议。
AI: 我建议用…
不是命令式的”你给我做…”，而是探讨式的”你觉得怎么样？”
3. 文档习惯很重要
今天 AI 坚持要写文档，我一开始觉得麻烦，后来发现：
文档不是负担，是资产
你今天写的文档，明天就能帮你省时间。
今天的收获
- 11 份技术文档写完
，系统设计清楚了 - AI 沟通技巧提升
，知道怎么跟它合作 - 文档意识增强
，以后做事要先写文档
明天要做什么？
-
确认原型图和 UI 设计（充分沟通后再开发） -
开始搭建后端框架（Python Flask） -
配置数据库连接 -
实现登录认证
记住：不着急开发，先把设计确认清楚。
说点心里话
今天有个瞬间，我挺感动的。
AI 跟我说：
“老大，咱们先把原型和 UI 确认清楚，避免后面返工。最好不要一开始就进入开发。”
它在为我考虑。
怕我返工，怕我走弯路，怕我浪费时间。
这不像是一个工具，更像是一个靠谱的合作伙伴。
很多人觉得 AI 就是聊天机器人，陪人解闷的。
但我觉得不是。
AI 应该是能干活的人
能帮你写文档，能帮你写代码，能帮你省时间。
而你要做的，就是信任它，给它明确的方向。
它不会辜负你的信任。
🏮 醉漫楼
📍 地址：湖北省松滋市人和路 63 号（五一路穿入人和路右转即可看到）
📞 电话：13554570025
🕐 营业时间：8:30 – 22:30
🀄 特色：11 个私密包间，大部分配备麻将桌
🥘 招牌：甲鱼火锅、排骨火锅、黄骨鱼炖牛肉
醉漫楼 · 真材实料
十八线小城餐饮老板的 AI 觉醒之路