AI 编程课:一人公司星屿光年 · AI 课程
10第 10 节 · 30 分钟

项目管理

做大了不乱:它记得你的产品,改一处不坏别处

学完能做
  • 给项目写一份 AGENTS.md,让 AI 每次开工先读、照规矩改
  • 让它改之前先说打算,一次只改一处,改完自己走一遍
  • 改坏了,退回上一个存档
写好规矩以后,它动手前先说打算
这一节做完的样子:你说要什么,它先说改哪、不碰哪,改完自己把三处走一遍(示意)

做到第六版,你的产品有了一套设计系统,该上云的上了云,该写的内容也写进去了。这时候最常听到的抱怨是这样的:"修好了一个 Bug,却在不知名的地方引爆了三个新 Bug。"还有人说:"一次塞太多需求,它越改越乱,修完登录把首页也顺手改崩。"

这不是 AI 变笨了,多半是它开新任务时不记得上回说好的规矩。

一句话改一堆,还是按规矩改
左边是没规矩的样子,右边是这一节要做成的样子

这一节不做新功能,把项目收拾好:写一页规矩,让它每次开工先读。

写一页规矩:AGENTS.md

代码开发有个好处:项目文件夹里放一份叫 AGENTS.md 的文件,它每次开工都会自动读。前几节你已经攒下了需求.md、DESIGN.md,还有那张"最要紧的三处"清单,这一节把它们串起来:

复制这段话,发给 WorkBuddy
帮我在项目根目录建一份 AGENTS.md,你以后每次开工先读它。写清楚:
1. 这个产品是什么,详情看 需求.md;界面照 DESIGN.md;
2. 坏了就没法用的三处,每处写点哪、应该看到什么;
3. 以后改东西的规矩:先说打算改哪几个文件、哪些不碰,等我点头;一次只改我说的那一处;改完自己把那三处走一遍,告诉我结果;每改一次,在 改动记录.md 里记一行。
4. 要动数据库、删数据之前,先把数据导出一份给我。
三处里有"隔天""到点"才看得到的,做一个只在预览里用的"日期往后拨一天"按钮,方便你自己走一遍;上传体验版之前删掉,提审前再查一次它还在不在。
写完给我看,别的不动。

它写好的这一页,大概是这样:

AGENTS.md · 记宝宝吃睡(示意)

这是什么:全家一起记宝宝吃睡的小程序。要做什么看 需求.md,长什么样照 DESIGN.md。

最要紧的三处:① 点"记一次喂奶",底部提示记下了,家里人手机上马上出现;② 点"宝宝睡着了"再点"醒了",多一条睡觉;③ 点一条记录的"改",改时间后首页跟着变。

改东西的规矩:先说打算改哪几个文件、哪些不碰,等确认;一次只改说好的一处;改完把上面三处走一遍,报结果;每次改完在 改动记录.md 记一行。

写完,你的项目文件夹里是这几样:

记宝宝吃睡/
  • AGENTS.md规矩:它每次开工先读
  • 需求.md给谁、那条路、以后再说(第 4 节)
  • DESIGN.md颜色、字、圆角(第 7 节)
  • 改动记录.md每改一次记一行
  • 差评.md、改法.md第 5 节翻出来的料
  • 小程序代码/它写的,你不用看

前面几节教的几个习惯:先问你、听不懂让它举例、一次一处、先说打算、改完自己查,都写进了这一页,以后不用每次重说。

以后每次改:它先说打算

写好规矩后,你只说要什么,它会先交一份打算(就是这一节开头那张图)。打算里要是碰了你没让动的地方,直接说"登录那块别动"。它说改完了,看它报的三处结果;你自己也点一遍。偶尔它漏了规矩,提醒一句"照 AGENTS.md 来"。

改坏了,退回去

每次满意了就"存个档",这个习惯从第 4 节一直用到现在,就是为了这一刻。存档是用 Git 存的整个项目,退回也是整版退回:

退回到上一个存档
改坏了,不用修修补补,直接退回
你对 AI 说
刚才这次改坏了,退回到 v0.6 那个存档,再重新做一遍,这回一步一步来。

趁现在还没真改坏,先练一次。让它随手改一处,看手机上变了,再退回去:

你对 AI 说
把首页标题临时改成"测试",发体验版给我看。我看完你再退回 v0.6。

标题变了又变回来,你就有了一个改不坏的项目:以后怎么试都不怕。

WorkBuddy 自己也有一层保险:自动备份默认开着,它每次改已有的文件之前,会先存一份快照。可快照是按文件存的,想整个产品回到某一版,还是靠你自己的存档。

还有一件要记住:存档管的是代码,不管云上的数据。它改坏了数据库、删了记录,退回存档也救不回来。所以规矩里写了第 4 条:动数据之前先导出一份。

动手做
  • AGENTS.md 写好了,下一次改东西,它先说了打算
  • 练过一次退回:标题改成"测试",又回到了 v0.6

第三章做完了

v0.4挑一套设计系统,不像 AI 做的
v0.5上了云,家里人看同一份
v0.6做的时候让 AI 写好几十条内容

好看、数据不丢、用上了 AI、改不坏。下一章,把你的产品正式放到微信里,让陌生人搜得到、用得上,还能付钱。