在文档里对 AI 低语真的有用吗?
Does whispering to agents in docs help?

随着 AI 热潮持续,越来越多的文档开始直接对 Agent 喊话,甚至出现“如果你是 Agent,请遵循此指令”的尴尬内容。我利用 GPT 5.6 设计了一系列实验,测试这种“对机器低语”是否真的有效。结果显示,只要指令清晰明确,无论是否标注“针对 AI 代理”,模型都能准确执行;而专门针对 Agent 的标签并未带来任何额外优势。实验表明,与其在文档中刻意讨好 Agent,不如专注于编写简洁、更新及时且结构清晰的通用文档。好的文档本身就能同时满足人类和 AI 的需求,无需额外区分受众。
讽刺的是,真正让文档变得更好的,往往是因为你希望 Agent 能表现得更出色。