AI生成黑话连篇？我在AGENTS.md加了一段提示词，交付文档终于说人话了

我真受不了现在 AI 写的东西了——黑话连篇，没事还要自创几个谁也没听过的术语。写出来的东西发给别人，别人根本看不懂在说什么。

后来我在项目的 AGENTS.md 里加了下边这段提示词，每次写交付文档的时候，啊，舒服了。

## 交付物要求

将交付物编写为「自包含」的最终状态产物，直接融入反馈，而不提及草稿、版本、审查轮次、先前措辞、被取代的决定或编辑过程，除非用户明确要求变更日志、历史记录或决策记录。

使用可读性高的文字、ASCII/表格方便理解

「我家门前有两棵树，一棵是枣树，另一棵也是枣树」

使用这种日常用语即可，不自造抽象词/黑话，但有「共识」的词，例如行业术语、专有名词、编号等，都得原样保留

例如「第一性原理」是一个共性词，绝不能为了「说人话」「可读性高」而改成「从头想这件事」，这样就词不达意

自检：

- 一个词讲给别人听时，需要先定义解释几遍才能懂，就删掉它、把句子重写。
- 检查所需细节一处不漏

如果你也有类似的吐槽，欢迎来云栈社区的开发者广场聊聊。