**为 AI 代理设计文档：从人类中心转向机器可读**

_Designing Docs for AI Agents_

> 随着 AI 代理成为文档的主要读者，传统面向人类的文档设计原则已不再适用。文章指出，AI 代理以机器规模读取文档，需采用更显式、独立页面和 Markdown 格式，并强调错误信息应作为核心内容。推荐通过 llms.txt、独立 .md 端点和 MCP 服务器提升机器可读性，而非依赖渐进式披露或导航结构。

**来源信息**
- **来源**：Hacker News：AI 热帖
- **分类**：tip
- **发布时间**：2026-07-30 23:42（北京时间）
- **原文**：[打开原文](https://www.jamdesk.com/blog/designing-docs-for-ai-agents)