2. Linux.do
  3. 公开我一个长期vibecoding 的工程复盘日志

公开我一个长期vibecoding 的工程复盘日志

温州程序员劝退师 2026-06-10 10:18 1

我有一个长期 vc 的项目,我在 AGENTS.md里定义了如果多次遇到相同问题要记录进复盘日志,并在开始任务时阅读进行规避.两个月过去了,我们一起看看AI都记录了什么.

建议大家也开一个类似的复盘日志,用来证据指导人类进行 Harness 迭代



复盘日志模版为了方便佬友复制就不当LLM产出截图了


工程复盘日志 (RETRO.md)



用途: 记录开发过程中反复出现的错误、vibe coding 中遇到的典型困难、以及解决方案。 当类似问题再次出现时，先来这里查询，避免重复踩坑。


维护规则:



  1. 每条记录必须包含：现象、根因、是否已解决、解决方案（或规避方式）。

  2. 未解决的问题必须标注 [未解决]，已解决的标注 [已解决]。

  3. 新条目追加在对应分类末尾，不要打乱已有顺序。

  4. 如果某条经验已经固化为 AGENTS.md 的硬约束或棘轮条目，在此标注"已升级为规则"并注明位置。


























新增条目请复制以下模板：



### RETRO-XXX: 简短标题 [已解决/未解决]



- **现象**: 具体的错误表现或困难描述。

- **根因**: 为什么会出现这个问题。

- **解决方案**: 怎么修复的，或者当前的规避方式。

- **后续防护**: 是否已升级为 AGENTS.md 规则，如果是注明具体条目。
最新回复 (7)
  • spx 06-10 10:26
    1楼

    ^-^受益匪浅，佬可以分享个git仓库链接吗？

  • 温州程序员劝退师 楼主 06-10 10:27
    3楼

    这个是个商业项目 没有公开的,佬友可以喂给AI 让AI自行构建,我刚刚放开权限了可以读到

  • myboydo 06-10 10:29
    4楼

    没看懂，要怎么使用啊，需要配置什么

  • seaflower 06-10 10:41
    5楼

    这个工程日志，感觉和 claude.md 的自动 memory 很像。


    这个工程日志不会变的非常的大吗？如果每次都读，这些踩过的坑都同步更新到 Agents.md 中吗？那 Agents.md 中不会变的非常大吗？


    这个工程日志是不是也应该参考你项目中定义的其他的文件。我看着你的截图，有很多其他的文件。比如 架构文件 等的内容。工程日志是不是也应该确认是不是在这些文件中已经定义了。

  • 温州程序员劝退师 楼主 06-10 11:07
    6楼

    都是好问题,值得一个个解答

    1.与memory 很像?是的,确实像,有什么区别?在准入时有限定要求是重复出现的问题或者人类直接提出的要求才会记录.memory对于harness 定义者来说信息略多,而且不一定必须.但能记录到 复盘日志的问题基本上是当前使用的LLM无法一次性写对的问题.而且对于多LLM使用者来说,复盘日志更能稳定被LLM读取

    2.为什么不参考其他文件?对于发起一次会议来说,有一份统一的文件比跳文件讲解能推进的更顺利,方便专注于特定议题.换句话说架构之类的文件对于产品和测试人员都是噪音,但复盘里的业务相关信息都是需要聚焦的点

    3.是否会增大调用?会,但不多,两个多月的高强度使用(每日1亿+token)也只记录了大约30条信息(业务相关的我都删掉了没放进来).对于每次调用来说顶多只是几k的增加.比起LLM跑歪或者重复出现bug 这是可接受的

    4.是否在其他文件定义?部分有,但对于工程来说,可溯源的线索价值高于冰冷的条例

    5.是否会同步更新到AGENTS.md中?少部分框架共性问题会,更多是特定需求开发时产生的问题,这类问题不会进入

  • 7 06-10 11:11
    7楼



    没想到跟我一样 我也有在做这个 ^-^

  • Oaki Doki 06-10 11:33
    8楼

    写过不太类似的log，但有个通用的问题。就是佬怎么维护这里的时效性，如果某一条不准确或者废弃了怎么处理呢？什么时候维护这个的时效性？或者是否标注过时/废弃/被取代？

* 帖子来源Linux.do
附近帖子
返回
飞读
随机推荐