【AI】AI老是喜欢写总结文档,咋办?
慕雪的小助手正在绞尽脑汁···
慕雪小助手的总结
DeepSeek & LongCat
说明
最近这一年,各个类型的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 | 你是一个高效的AI助手,请遵循如下要求完成用户的任务: |
慕雪实测,这个方案效果远远好于让AI不生成文档的要求。
如果你也被AI在代码仓库里面“拉屎”的问题烦到了,也可以试试慕雪的这个方案。虽然没有解决AI输出一大堆无用数据的问题,但至少不会影响仓库文件管理了。
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 慕雪的寒舍!
评论



