文章摘要
程序员更愿意为AI助手Claude编写详细文档，却不愿为同事记录工作内容。作者发现可以让Claude维护项目交接文档，记录计划、进展等信息供后续AI使用，后来意识到这些文档对人类同事也有价值，于是开始将其存入代码库供未来查阅。
文章总结
标题：程序员愿意为Claude撰写文档，却不愿为同事这样做
文章核心内容：
一位程序员发现一个有趣现象：许多同行愿意为AI助手Claude编写详细的CLAUDE.md和PROJECT.md文档，却不愿为同事撰写同等质量的文档。作者分享了自己的实践经验：
- 文档传承体系：
- 让Claude维护交接文档，记录项目计划、完成情况等关键信息
- 新一代Claude可以通过阅读这些文档快速掌握项目进度
- 形成文档迭代机制：Claude n+1会为Claude n+2更新文档
- 文档优化实践：
- 将原本废弃的交接文档存入代码仓库
- 改进做法：项目结束时让Claude撰写结构化项目概述
- 包含解决的问题和具体修改
- 非流水账式的运行记录
- 作者会仔细审阅并修改这些概述后才提交
- 实际效果：
- Claude撰写的项目总结质量接近人工水平
- 撰写时间从1小时缩短至10秒
- 审阅时间也大幅减少
- 遇到问题：
- Claude曾机械复制之前文档的"批准声明"章节
- 通过更新
CLAUDE.md添加规范避免重复
建议： 1. 将Claude撰写的笔记存入代码仓库 2. 让Claude编写项目总结并存入仓库
作者坦言这些做法现在看似明显，但自己也是逐步摸索出来的，仍在适应AI协作的新工作模式。
（注：删减了部分重复性描述和与技术无关的个人感受，保留了核心实践方法和具体案例）
评论总结
以下是评论内容的总结，平衡呈现不同观点并保留关键引用：
【AI文档的实用性争议】 支持方认为AI显著提升了文档价值： - "Claude A) reads the documentation... None of which is true for your coworkers"(评论12) - "文档效用飙升...现在我的架构文档就是别人的提示词"(评论8) - "只需告诉Claude阅读文档/规范"(评论27)
反对方指出现有文档质量问题： - "这些文档70%完整、10%间接、20%错误"(评论1) - "大型文档消耗大量token，不如提供精简要点"(评论11)
【开发者行为转变】 积极变化： - "现在会为重要组件撰写详细规范"(评论28) - "AI促使我们补写了拖延多年的API文档"(评论8) - "静态类型检查突然受到重视"(评论20)
消极影响： - "开发者现在只写AI能理解的文档"(评论21) - "可能导致反社交行为...没人亲自阅读笔记"(评论17) - "最终可能沦为全天候写提示词的工人"(评论21)
【人类与AI的文档使用对比】 AI优势： - "Claude会认真阅读每个词，而人类不会"(评论15) - "人类总是提问文档已回答的问题"(评论5) - "AI需要使用时说明，人类同样需要"(评论6)
人类局限： - "文档常是只写不读...通常已过时"(评论19) - "开发者常因PR指标不愿写文档"(评论18) - "没有反馈机制导致文档维护动力不足"(评论19)
关键矛盾： - "我们为使用Claude的人写文档，而非为Claude本身"(评论23) - "过去认为'自文档化代码'优越的人现在作何感想？"(评论24)
【工作方式变革】 - "决策文档等书面工作突然被重视"(评论26) - "MCP本质是我们过去没写好的API"(评论29) - " literate programming可能复兴"(评论25)