// LATEST

如何长期维护一个 vibe 项目 #2

在上期,我们说到了如何开始 vibe,今天我们来讲讲如何对 vibe 项目进行长期维护。

vibe 项目在推进的时候,随着项目变大,会出现很多问题。

初始上下文问题

当你在和 ai 进行新对话来更新这个项目的时候,有一个非常严重的问题:

ai 会先读你整个项目,完整理解后才会开始开发。

这导致开始就会耗很多时间,并且吃掉很多的上下文。甚至项目大了以后,ai 读完项目就直接把上下文打满了(说的就是你,该死的 gpt6 雷霆思考+防御编程)。

如何避免这个问题呢,最简单的就是/init

当你在项目架构做的差不多了以后,就可以考虑/init 了,这个命令的作用就是让ai 理解一遍项目,并简洁制作一份说明这个项目的结构和是什么的 agentmd,有了它,后面开展工作的时候,ai 会使用读 agentmd 来代替读整个项目,这样就不用每次都读了,非常的省 token 并提高效率。

如何防止项目失控

ai 有一个很大的问题就是喜欢到处拉屎,尤其是在使用非旗舰 ai 或者是较低思考模式的时候。

比如说做个网页,可能命名之前已经设计过一个按钮了,每次遇到新按钮 ai 还是会再设计一个控件,而不是复用。

而且这些控件散落的到处都是,有的控件放在这个文件夹,有的在那个文件夹。

这样的屎山不断的堆下去,就导致了项目的失控。

虽然说上面的 init 可以一定程度上解决这个问题,但当我们在实际做的时候,还是要有意识的注意这个问题,让 ai 尽量去复用、规范写法,结构等(这些可以在 agentmd 里规范)

文档与架构

vibe 对人来来说,不在需要管具体代码,而是管文档。

文档是什么,就是给 ai 的规范,告诉 ai 怎么做。我这里推荐一个写法:

agentmd(硬约束)->readme(项目介绍和大致架构)->从 readme 指向各个部分的专门文档

这样,ai读取顺序是 agentmd->readme,然后根据任务要求和 readme 里面的规范,按需读取各个部分的文档。

按需装载是个很重要的内容,这可以在给 ai 规范约束的同时,有效防止 ai 读太多导致注意力涣散。

举个例子,可以把项目怎么自测写成单独文档,然后从 readme 指向,项目在做的时候并不会完整读,而当项目需要自测的时候,ai 才会去完整读这个文档,这样就做到了按需装载。

当然,这种架构都是仁者见仁智者见智的,但严格规范和按需装载的思路是不变的。

还没有评论

欢迎留下你的观点,保持交流的清晰和友好。