给 AI 写的文档定规范:人读,机器也要读

一句话价值:文档的主要读者正在从人变成 Agent
亮点:Markdown 约定 + 检查工具,面向人机共读场景

为什么值得关注

当文档的主要读者变成 Agent,格式就从排版问题升级成接口问题。谁先把文档写成机器能稳定解析的样子,谁先吃到 Agent 自动处理的收益。这类规范的成本很低,回报却发生在后续每一次调用上。

和我们的判断的关系

与「07-RAG」直接相关:检索质量的上限取决于原文结构。把文档规范化是低成本高回报的一步,往往比换一个更贵的模型更划算。