用 AI 写代码写到崩溃？我整理了一套rules规范，免费开源！
用 AI 写代码写到崩溃？我整理了一套 rules 规范，免费开源！
😭 说说你有没有遇到过这种情况
用 AI 写代码，第一天——爽！
说一句话，刷刷刷，几十行代码出来，能跑，完美！
第一个月——还行，勉强掌控。
第三个月——改一个地方，另外三个地方炸了。
你看着那堆代码，完全不知道当初 AI 为什么这么写。想问它，它说”这是合理的设计”。你想重构，它顺手又给你”优化”了一堆你没让它动的地方。
这就是 Vibe Coding 的真相——爽在当下，坑在以后。
有没有人跟我一样，被这个折磨过？！
🤔 Spec Coding 也没完全救我
后来有人说，你得先写规格再让 AI 实现，也就是 Spec Coding。
好，我试了。
确实好一些，但还是有问题：
- 需求文档写完，代码改了，文档没更新，两边对不上
- 让 AI 改登录逻辑，它顺手把工具函数也重构了，还觉得自己做了好事 😡
- 没有分层约束，它在 Controller 里塞业务逻辑，在循环里查数据库……
说白了，Spec Coding 解决了”写什么”，没解决”怎么写”和”写完咋管”。
【梗图：以为找到了解法，结果发现只是换了个坑跳进去】
💡 所以我自己整了一套规范——血和泪换来的！
花了一年多时间踩坑，我把经验整理成了一套 AI 编程规范，完全开源，免费抄作业！
谁不用谁亏了！
下面是核心内容，一共三层，跟我来～
✅ 第一层：管住 AI 的手
“它不是不懂，它就是不守规矩。”
通用规范，适用所有项目，专门约束 AI 的行为边界：
- 🚫 不许编造不存在的 API 和库
- 🚫 不许擅自重构没让它动的代码
- 🚫 不许删代码（除非你明确说要删）
- ⚠️ 改超过 3 个文件或 50 行，必须先给你看方案，确认了再动
这些听起来是废话？不写进规范，它真的会干这些事。（血的教训！）
【截图：general.md 规范内容展示，高亮 AI 行为约束部分】
✅ 第二层：技术栈专属规范，代码风格终于统一了
目前覆盖四个主流技术栈：
| 技术栈 | 覆盖内容 |
|---|---|
| ☕ Java / Spring Boot | 三层分离、统一响应、异常处理 |
| 🐍 Python / FastAPI | 强制类型注解、分层约束、异步规范 |
| 💚 Vue 3 | Composition API、Pinia、HTTP 统一封装 |
| ⚡ Next.js | Server Component 优先、Server Actions、环境变量规范 |
规范里写清楚了：目录结构长啥样、哪层能干啥事、命名怎么来、数据库怎么操作……
效果就是：不同时期、不同功能的代码，读起来像同一个人写的。 而不是每次 AI 上来都给你整一种新风格。
【截图：project-vue3.md 目录结构约束部分】
✅ 第三层：需求追踪规范——这个是真正的杀手锏
叠个甲：这个部分适合复杂项目，快速 MVP 可以跳过。
但如果你的项目要持续迭代超过一个月，这一层能救你命。
整个流程分三个阶段：
📋 阶段一：需求收集
不是让你直接写需求文档，而是 AI 跟你多轮对话，把需求问清楚，再生成文档。
用户意图模糊的？继续追问。有遗漏的常见功能？AI 主动提示。
生成的文档长这样，每条需求有唯一 ID：
1 | |
🔧 阶段二：任务拆解
需求确认后，拆成一个个可执行的 Task，每个 Task 标注来源（对应哪条需求）、类型、不做什么。
🚀 阶段三：实现追踪
每个 Task 实现前必须细化——流程图、线框图、子任务、验收标准全部到位。
完成一条，立刻勾选一条。 不许攒到最后一起勾。
完成后更新状态，补全涉及文件。
【动图：演示 Task 从”待开始”到”进行中”到”已完成”的状态流转过程】
整个流程跑下来，有三个明显收益：
- 🧠 三个月后回来，还知道当初为什么这么写
- 🔍 任何一段代码，都能追溯到对应需求
- 👥 新人接手（或者你自己休假回来），不用猜，文档全有
📉 说说缺点，我是认真的
这套规范也不是完美的，我必须说清楚：
⚠️ 前期成本高。 需求要多轮对话，Task 要细化填字段，不适合”两小时验证想法”的场景。那种场景，Vibe Coding 反而更合适。
⚠️ 执行要靠自觉。 规范是写下来了，AI 能不能遵守，还是得你盯着。它偶尔还是会越界，你得及时纠正。
⚠️ 有一定门槛。 分层架构、数据库迁移这些概念，完全没有工程背景的同学可能需要先补课。
除了这些，其他方面我觉得还挺好用的～
【梗图：优点一大堆，缺点也要说清楚，这才是真朋友】
🎯 现在怎么用？
三步走：
- 把规范文件放进你的项目，让你用的 AI 工具能读到它（支持 rules 功能的编辑器都行，比如 Cursor、Windsurf）
- 跟 AI 说”我有个新项目”，它会引导你走需求收集流程
- 按流程推进，需求 → 任务 → 实现，一步一步来
项目已经开源在 GitHub，免费，直接抄作业。
【截图：GitHub 仓库主页，展示 README 和规范文件列表】
省流版
【信息图：汇总全文核心要点——Vibe Coding 的三大问题 / 规范三层结构 / 适用场景 / 获取方式】
- Vibe Coding 适合快速验证，不适合长期维护
- Spec Coding 好但还不够，缺约束、缺追踪
- 这套规范三层结构：AI 行为约束 + 技术栈规范 + 需求追踪
- 复杂项目用，MVP 验证可以先 Vibe
- 完全开源，GitHub 搜就有
这套规范是我自己踩坑总结出来的，肯定有不足的地方。如果你有更好的方法，或者你在用 Go、移动端开发，有适合自己技术栈的经验，欢迎来讨论，欢迎一起共建！
大家觉得这种方式怎么样？有没有被 AI 写代码坑过的铁铁，评论区说说你的经历～
如果觉得有用，点个赞再走！转发给也在用 AI 写代码的朋友，让大家都能抄到这份作业！ 🙏
【引导图：点赞 / 收藏 / 关注 引导，附 GitHub 链接跳转】