4.5 常见误区、维护边界与过渡
面向经管学生、研究者与从业者的 AI 智能体设计教材
这一章最常见的四个问题如下。
第一，目录分区太粗。所有东西都堆在根目录，看似省事，实际是在给后面制造噪音。智能体每次都要重新猜哪些文件有用，哪些只是历史遗留。
第二，规则文件过长。很多人一开始就想把所有经验都写进去，结果 CLAUDE.md 越写越像百科，真正高频、关键的规则反而被淹没。规则文件重在稳定，不在堆积。
第三，职责混写。把当前会话里的临时要求长期固化，或者把阶段性安排写成永久规则，都会让后续维护变得困难。
第四，写完就不维护。规则文件不是启动仪式，项目结构变了、输出路径变了、验证方式变了，都应该同步更新。否则它很快就会变成误导性的旧说明。
这一章最后最该留下的，不是一个固定模板，而是一套维护边界。
- 规则文件只保留长期有效的信息。
- 当前会话只处理这一轮任务。
- 项目变化后，优先更新规则，不要只靠临时补充。
规则文件不是启动仪式
写完 CLAUDE.md 不代表项目启动结束。项目结构变了、输出路径变了、验证方式变了，都应该同步更新规则文件。不维护的规则文件比没有更糟——它会误导后续每一轮执行。