教程 01：我为什么没有一上来就让 AI 写功能，而是先把项目入口补齐

我一开始也走过弯路。

最早把 AI 引进项目的时候，我的思路很直接：
既然它能写代码，那我就让它直接写功能、改页面、补文档。

短时间看效果很明显，速度也确实快。
但做了几轮之后，问题很快就出来了：

• 这次改的目录结构和上次不一样
• 这次返回的字段和上次又不一样
• 前台能跑，后台的写法却开始发散
• 过几天再接着做，AI 又像重新进场一样

我后来才意识到，问题不在 AI 会不会写，而在项目本身根本没有一个稳定入口。

所以我整理 Sourcelin Blog（圆圈博客） 时，第一件事不是让 AI 写功能，而是先把项目入口补齐。

• 在线演示：http://sourcelin.cn
• Gitee：https://gitee.com/my_lyq/sourcelin-cloud-blog
• GitHub：https://github.com/SourceLin/sourcelin-cloud-blog

我后来怎么理解“项目入口”这件事

说白了，就是让 AI 一进仓库就知道三件事：

1. 这个项目是什么结构
2. 哪些约束不能碰
3. 这次任务应该按什么流程做

在 Sourcelin Blog 里，我最后把它拆成了三层：

• AGENTS.md
• rules/
• skills/

以前我会觉得这些东西像“附属文档”，后来我才发现，它们才是 AI 能不能长期稳定协作的前提。

为什么我先补的是 AGENTS.md

因为它最像“总入口”。

一个多模块项目，如果没有这一层，AI 很容易犯一种特别典型的错误：
它不是不会做，而是会把不该混在一起的东西混在一起。

比如前台、后台、后端边界不清楚，或者开发分支和公开分支边界不清楚。
这种问题人工改的时候还能靠经验兜住，AI 连做几轮之后就会放大得很快。

所以我后来在 AGENTS.md 里重点写清楚的是：

• 仓库有哪些模块
• 前台、后台、后端分别在哪
• 哪些目录能改，哪些目录不能碰
• 日常开发分支和公开分支怎么走
• 做任务前默认该读哪些规则

这一步做完之后，我明显感觉 AI 的输出开始稳定了。

rules/ 这层，解决的是“别再猜了”

项目里最容易积累历史包袱的地方，通常不是代码量，而是“默认约定全靠猜”。

例如：

• 接口成功码到底是多少
• 分页到底读 items 还是 rows
• 前台页面应该怎么拆
• 后台表格和分页到底按哪一套来

这些事情以前我会在聊天里临时说，或者靠自己记。
后来发现这样完全不行，因为 AI 每一轮都可能从不同的局部上下文里做判断。

所以我把它们收口进了 rules/。
一旦这些规则写清楚，AI 就不需要继续“猜哪种写法可能是对的”。

skills/ 这层，是我后来才意识到最有价值的部分

只有规则还不够。
因为很多工具就算读了规则，也不等于知道该怎么一步步做任务。

这就是为什么我后来补了 skills/。

它本质上是在回答：

• 前台任务怎么做
• 后台任务怎么做
• 后端任务怎么做
• 架构整理怎么做

以前我总觉得“规则有了，AI 自己会懂”。
后来实践下来发现，不会。
规则告诉它边界，工作流告诉它顺序，这两层缺一层都容易跑偏。

这件事对我最大的改变是什么

不是“AI 更聪明了”，而是我终于不再每一轮都重新解释项目。

以前一开新任务，我就要重新说一遍：

• 这个目录别动
• 这个协议别改
• 这个页面别直接写请求
• 这个后台别碰权限逻辑

现在这些东西都写在仓库里了。
工具换成 Codex、Cursor、OpenCode、Claude Code、Qoder、Trae，本质上都还能接住。

如果你也想把 AI 引进自己的项目

我现在的建议很明确：

别一上来就让它改业务。

更稳的顺序是：

1. 先写 AGENTS.md
2. 再补 rules/
3. 再补 skills/
4. 最后再让 AI 去碰 README、文档和业务代码

这个顺序看起来慢一点，但后面省下来的返工时间非常多。

我现在怎么看这件事

我越来越觉得，AI Coding 这件事真正难的不是提示词怎么写，而是项目有没有秩序。

一个没有入口、没有规则、没有工作流的项目，换再强的工具也只是在更快地产生混乱。
而一个入口清楚、规则明确、边界稳定的项目，AI 才有可能真的变成协作工具，而不是不定时惊喜制造机。

Sourcelin Blog 这个项目，我就是从这里开始一点点收回来的。

下一篇我想继续写更实际一点的内容：
怎么在 AI 协助下，把一个微服务博客项目从零跑到本地最小启动。

项目地址

• 在线演示：http://sourcelin.cn
• Gitee：https://gitee.com/my_lyq/sourcelin-cloud-blog
• GitHub：https://github.com/SourceLin/sourcelin-cloud-blog

如果你刚好在找一个：

• 微服务博客系统
• Spring Cloud Alibaba 实战项目
• Vue 3 + Java 全栈项目
• 毕设 / 课程设计参考项目
• 支持 AI 协作开发的开源仓库

可以看一下这个项目。欢迎试用、提 Issue，也欢迎点个 Star 支持一下。