Codepilot 这种大型代码库 Vibe Coding 非常依赖于文档体系去控制 AI。

自从 Claude Code 的 Plan 模式废掉以后,我连计划写的都是计划文档,整个文档体系的复杂度和占代码的比例都在快速大幅上升。

这里的 Plan 模式废掉,是因为在大型代码库下,它的 Plan 模式会产生非常多的幻觉。一旦任务变大,这种幻觉是非常致命的:

没有办法审查,因为计划内容不在项目里,是临时的;其他 AI 也无法进行审查,因为它是直接吐出来的。所以它不如文档直观,也不如文档可协作。

所以,文档体系的管理,以及 AI 和人协作下的文档梳理,在整个大型代码库中其实是非常重要的。

我让 Codex 分析了一下 CodePilot 目前的文档体系,以及它跟代码之间的关系。

目前 CodePilot 里面有 26 万行代码和 5.6 万行文档,文档占代码的比例大约是 21%。

说一个事实:

从 CodePilot 的第一个版本到现在,我没有动过一行代码,因为现在确实看不懂了。

但目前基本上所有已知的 bug 我都能修复,所有想要实现的能力也都能实现。

这是当前 Vibe Coding 我自己的一个实践,也是我自己的一个上限。整个重构本来预期是两周,但实际持续了超过一个月零三周。

顺便通知一下,昨天藏师傅吭哧瘪肚重构了一个多月的版本 0.55 已经上线,可以去体验了。


Codepilot 这种大型代码库 Vibe Coding 非常依赖于文档体系去控制 AI。

自从 Claude Code 的 Plan 模式废掉以后,我连计划写的都是计划文档,整个文档体系的复杂度和占代码的比例都在快速大幅上升。

这里的 Plan 模式废掉,是因为在大型代码库下,它的 Plan 模式会产生非常多的幻觉。一旦任务变大,这种幻觉是非常致命的:

没有办法审查,因为计划内容不在项目里,是临时的;其他 AI 也无法进行审查,因为它是直接吐出来的。所以它不如文档直观,也不如文档可协作。

所以,文档体系的管理,以及 AI 和人协作下的文档梳理,在整个大型代码库中其实是非常重要的。

我让 Codex 分析了一下 CodePilot 目前的文档体系,以及它跟代码之间的关系。

目前 CodePilot 里面有 26 万行代码和 5.6 万行文档,文档占代码的比例大约是 21%。

说一个事实:

从 CodePilot 的第一个版本到现在,我没有动过一行代码,因为现在确实看不懂了。

但目前基本上所有已知的 bug 我都能修复,所有想要实现的能力也都能实现。

这是当前 Vibe Coding 我自己的一个实践,也是我自己的一个上限。整个重构本来预期是两周,但实际持续了超过一个月零三周。

顺便通知一下,昨天藏师傅吭哧瘪肚重构了一个多月的版本 0.55 已经上线,可以去体验了。

     关闭

     更多

       名称已清空

       微信扫一扫赞赏作者

       喜欢作者

      [其它金额](javascript:;)

        赞赏后展示我的头像

      作品

      暂无作品

       喜欢作者

           其它金额

            ¥

          最低赞赏 ¥0

           确定

     返回

     其它金额

     更多

      赞赏金额

       ¥

      最低赞赏 ¥0

       1

       2

       3

       4

       5

       6

       7

       8

       9

       0

       .

,

2026年6月5日 11:28