【AI】AI老是喜欢写总结文档，咋办？

距离上次更新本文已经过去了 200 天，文章部分内容可能已经过时，请注意甄别。

最近这一年，各个类型的AI编程工具那是层出不穷，想必大家都遇到过一个问题，那就是AI在完成你给定的任务的时候，会输出非常非常非常非常非常多的文档和其他附属产物：

特别是claude的模型，写文档那是太喜欢了。而国产的GLM-4.6和Qwen估计是蒸馏了太多claude模型的数据，导致这俩模型也爱上了写文档，那是卡卡给你写的层出不穷。

对于程序员来说，这些文档可烦死人了，每次完成这个任务之后，都得手动把AI写的那一大堆没用的文档给删掉。而在企业级项目里，这些文档更是不可能提交到git里面去的，绝对是污染源。这还只是给用户带来的使用体验上的困扰，更别提写这么多文档要多浪费多少输出Token的AI资费了。

这时候，绝大部分朋友应该都能想到一个办法，在工具的System Prompt设置里面，让AI不要写文档。

1	除非用户明确表明，否则不要生成任何文档或测试代码。

但实际场景下，这个Prompt效果并不好，会出现AI生成文档->发现用户要求不要生成文档->删除文档的操作。相比于不加上这个Prompt，反而更耗费Token了，因为多了一个“删除文档”的工具调用。只能说无语了……

既然Agent没办法遵循我们“不写文档”的要求，那还不如给个引导，让AI把测试代码和文档都放到一个指定的.ai-docs目录下，然后，再在.gitignore里面忽略掉这个项目。

1
2
3

你是一个高效的AI助手，请遵循如下要求完成用户的任务：
- 所有生成的说明文档和测试代码都需要放入.ai-docs目录下，除非用户明确指定输出路径。
- 除非用户明确指定输出语言，所有问题都需要用中文回答，代码注释需要使用中文。

慕雪实测，这个方案效果远远好于让AI不生成文档的要求。

根据你使用的不同的AI工具，把这段话加到System Prompt或者上下文的设置里就可以了。比如~/.claude/CLAUDE.md文件中。

The end

如果你也被AI在代码仓库里面“拉屎”的问题烦到了，也可以试试慕雪的这个方案。虽然没有解决AI输出一大堆无用数据的问题，但至少不会影响仓库文件管理了。