你的 CLAUDE.md 写错了：为什么指令越多，AI 越笨？
原文中文，约3500字，阅读约需9分钟。
📝
内容提要
本文探讨了如何优化 CLAUDE.md 文件，以提升 AI 编程工具的效率。研究表明，过多无关信息会导致 AI 忽视重要指令。建议控制文件长度，采用渐进式文档结构，并避免将 AI 用作代码格式化工具。
🔎
延伸解读
优化 CLAUDE.md 的重要性
CLAUDE.md 文件是 AI 编程工具的核心入职手册，包含了项目的基本信息和指令。过多的无关信息会导致 AI 忽视重要指令，从而影响工作效率。因此，优化文件内容，确保信息简洁明了，是提升 AI 效率的关键。
渐进式文档结构的优势
采用渐进式文档结构可以有效避免信息过载。将详细的规范分散到不同的文档中，并在 CLAUDE.md 中提供指向这些文档的链接，可以帮助 AI 更好地聚焦于当前任务，提升其处理能力。
避免将 AI 用作格式化工具
将 AI 用作代码格式化工具不仅浪费资源，还可能导致生成错误。使用专门的格式化工具如 Prettier 或 ESLint，可以确保代码风格一致，同时让 AI 专注于更复杂的任务，提高整体工作效率。
❓
Q&A
如何优化 CLAUDE.md 文件以提升 AI 效率？
优化 CLAUDE.md 文件的方法包括控制文件长度在 300 行以内，采用渐进式文档结构，并避免将 AI 用作代码格式化工具。
为什么过多的指令会导致 AI 忽视重要信息？
过多无关信息会被系统判定为“噪音”，从而导致 AI 忽视重要指令，降低其执行效率。
CLAUDE.md 中应包含哪些核心信息？
CLAUDE.md 应包含项目的技术栈、核心价值和构建工具等核心信息，避免冗余内容。
如何构建渐进式文档体系以提升 AI 效率？
可以在项目中创建文档库，存放特定领域的指南，并在主 CLAUDE.md 中保留触发器，以便 AI 访问相关信息。
为什么不应该将 AI 用作代码格式化工具？
因为 AI 是昂贵的推理引擎，不适合处理格式化任务，应该使用专门的工具来完成这类工作。
如何维护 CLAUDE.md 文件以避免错误？
应定期检查和精心维护 CLAUDE.md，确保其简洁明了，避免信息冗余，以减少错误的发生。
🏷️
