乐于分享
好东西不私藏

用AI写代码越写越乱?我靠这套「文档锁死法」3天撸出上线项目

用AI写代码越写越乱?我靠这套「文档锁死法」3天撸出上线项目

上周帮学生拯救他用AI写的电商毕设,打开代码我直接原地石化😱:导航栏点了没反应、产品 页在手机上直接崩成马赛克,AI生成的组件东拼西凑,改一行崩三行,活脱脱一座能跑的屎 山。他委屈巴巴:「我每次都跟AI说清楚要做什么了啊!」

我翻了翻他和AI的对话记录,果不其然:第一句就是「帮我写一个电商APP」,没有任何细 节,没有任何约束。这不叫Vibe Coding,这叫「裸奔式编码」——你让AI在没有护栏的高速 路上开车,不翻车才怪!

据Stack Overflow 2024年AI开发者报告显示:78%的AI编码新手因为缺乏前置文档,项目 在启动后2周内陷入瘫痪,其中62%最终直接放弃。你以为是AI不行?错!是你没给AI装 「导航系统」和「护栏」。

屎山的本质:AI是翻译器,不是预言家

很多人对AI编码的误解是:我甩个需求,AI就能给我一个完美的项目。但真相是:AI是 「需求翻译器」,你的输入是模糊的屎,输出必然是臭的屎山

AI的逻辑是:如果你不说清楚,它就会猜。第一次猜导航栏的样式,第二次猜产品页的布 局,猜来猜去,逻辑就乱了,组件就散了,最后整个项目变成一团浆糊。

修复方法根本不是什么「高级提示词」,而是先搞清楚自己要什么,再给AI明确的约 束。当你知道自己要构建什么,提示词根本就是小菜一碟——因为你终于知道该问什么了。

我靠这套「文档锁死系统」,把AI变成精准助手

我现在做任何AI编码项目,第一步绝对不是打开编辑器,而是写文档。这套「6+2文档系 统」,就是我防止AI瞎写的核心武器:

6份核心文档:给AI签「铁合同」

1.PRD.md:产品需求合同这不是给老板看的PPT,是给AI看的「军令状」。要写清楚:你做的是什么?给谁用?核 心功能有啥?明确说清楚什么在范围内,什么绝对不能碰。比如我写电商项目的PRD,会 加一句「禁止添加直播功能,只做基础的商品展示、下单、支付」,这样AI绝对不 会瞎加功能。2.APP_FLOW.md:用户导航剧本把用户从打开APP到下单的每一步都写死:点哪个按钮跳转到哪?登录失败了显示什么? 支付成功了有什么提示?比如「用户点击商品卡片→进入商品详情页→点击加入购物车→弹 框提示「加入成功」→右上角购物车图标数字+1」,这样AI就不会乱做跳转逻辑。3.TECH_STACK.md:技术食材清单把用到的技术栈锁死到具体版本:比如「Next.js 14.1.0,React 18.2.0,TypeScript 5.3.3」,别只说「用React」,不然AI可能给你搞个React 16的 老版本,到时候哭都来不及。4.FRONTEND_GUIDELINES.md:UI设计手册把颜色、字体、间距、响应式规则写死:比如「主色#3B82F6,字体用Inter,手机端 导航栏用汉堡菜单,平板以上用水平导航」,再附一张你喜欢的UI截图,AI就能1:1还 原,再也不会搞出五颜六色的按钮。5.BACKEND_STRUCTURE.md:数据结构蓝图把数据库表结构写清楚:比如「users表:id、email、password;products 表:id、title、price、user_id」,这样AI生成的后端代码完全匹配你的数据需求, 不会出现「存不下用户信息」的尴尬。6.IMPLEMENTATION_PLAN.md:执行步骤表把项目拆成N个小步骤:「步骤1:初始化项目,安装依赖;步骤2:写导航栏组件;步骤 3:写商品列表组件」,每次只让AI做一步,这样不会贪多嚼不烂。

2份会话文档:给AI装「记忆大脑」

AI的致命缺点是「会话间没记忆」,关了聊天窗口就从零开始。这两份文档就是AI的「外部 记忆」:

CLAUDE.md:AI操作手册把所有规则写在这里:比如「所有组件放src/components/,只用Tailwind CSS,禁止内联样式」,AI每次会话自动读这份文档,再也不会犯同样的错。progress.txt:进度跟踪表每次完成一个功能就更新:比如「已完成:用户登录功能;进行中:商品列表组件;待 做:支付功能」,下次打开会话,AI直接读这个,从你上次停的地方继续,不用再重复 解释项目。

让AI帮你写文档的「审问式技巧」

别自己瞎写文档!先让AI把你的想法往死里问:给AI发:「在写任何代码之前,把我这个 电商项目的想法往死里审问,问到没有任何假设为止

AI会问你:这是给谁用的?用户的核心动作是什么?登录需要吗?支付用什么?这些问题就 是文档的核心素材。等你答完所有问题,再发:「根据我们的对话,生成那6份核心文档,要具体到不能再具体」,AI会直接给你写好初稿,你再改改细节就行,省了80%的时 间!

工具用对,效率翻3倍

别瞎用一个AI到底!不同阶段用不同工具:

Claude:帮你想清楚写文档:适合做深度思考、写需求、生成文档。Cursor Agent:帮你写代码:端到端实现功能,遵循你的文档规则。Kimi K2.5:帮你还原UI:把截图喂给它,直接生成匹配的前端代码,比用文字描述 靠谱100倍。Codex:帮你debug:遇到顽固bug,让它读整个项目代码,找根本原因,比你瞎试快多了。

高级技巧:并行工作树,让AI同时干3份活

当你熟练之后,用git工作树同时开3个分支,一个做登录,一个做商品页,一个做支付,每 个分支给一个AI会话,让它们同时干活。原本要一周的项目,3天就能搞定,这才是AI编码的正确打开方式!

最后说一句:AI编码不是「甩手掌柜」,而是「用AI当助手,你当指挥官」。你负责想清 楚、定规则,AI负责写代码,这样才能高效撸项目,再也不搞出屎山。

👉 评论区告诉我你用AI写代码遇到过最离谱的屎山是什么?

👉 点赞+收藏这篇,下次用AI 写代码直接照着套,保证再也不踩坑!

👉 关注我,带你用AI高效撸项目不加班~😎

本站文章均为手工撰写未经允许谢绝转载:夜雨聆风 » 用AI写代码越写越乱?我靠这套「文档锁死法」3天撸出上线项目

评论 抢沙发

9 + 5 =
  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
×
订阅图标按钮