程序员为Claude写文档却不愿写给同事
值得看指数 36.0 NO. 018 · 2026.06.06
发布2026/06/05Score153Comments143
为什么值得看
开发者热衷为AI助手Claude编写详细的CLAUDE.md和PROJECT.md交接文档，却长期忽视给人类同事写同等质量的文档。这揭示了AI正在重塑开发者的工作习惯与协作优先级。
编辑判断
这个现象的本质是反馈闭环的差异：Claude会立刻用文档生成可用代码，人类同事却很少给出同等明确的正向反馈。开发者不是懒，是被激励结构驯化了。
更深层的问题是，当AI成为主要"读者"，文档的写法正在从"解释给人听"转向"指令给机器执行"——更结构化、更少上下文假设、更依赖显式约束。这种格式对人类反而更难读。
如果你在做AI编程工具或团队知识管理产品，这是一个被低估的设计空间：如何让同一份文档同时服务于人和AI，而不是让两者互相牺牲。
社区反馈
负面 140 条评论
核心争论：AI文档是否只是新型垃圾信息，开发者是在真正提效还是陷入AI工具调优的幻觉
sure, but those documents are generally just as useless because they're 70% complete, 10% indirect and 20% wrong. Unstrutuced slop is no better at best, and much worse at worst.
Slop in, slop out. The new GIGO?
Ahh yes, the documentation for claude. When someone created a CLAUDE.md, then changed some stuff around and when I later had to touch that repository my claude was hallucinating classes, functions and architecture that was already long gone! I just deleted the CLAUDE.md, since I had no mood to "fix"