技术写作老炮:agent 直接读文档不搜索,你的 docs 得改造了
rseroter · x · 2026-10-28
Tom Johnson 发文讨论如何让文档页面对 AI agent 友好。核心观点:AI agent（尤其是 coding harness）会优先直接抓取文档而非通用网络搜索结果，所以站点文档的形态决定了 agent 能否正确使用你的产品。
他给出了具体可操作的做法：
- 提供 llms.txt 文档索引（如 idratherbewriting.com/llms.txt），让 agent 一跳就能拿到全站目录；
- 每个页面 URL 加 .md 后缀即返回 Markdown 版本，方便 agent 直接消费；
- 基于 chat logs 分析用户实际问什么，反推 docs 应该改造成什么样。
rseroter 转发推荐，强调「harness 直接奔文档去，确保你的 docs 形状正确」——这对开源项目作者和 API 文档团队都是当下刚需。
「编程与Agent」频道最新
- AI 设计技能库 ai-design-skills 走红,单日涨 1395 星破 9k — elayadesign · 2026-10-28
- EmbeddingGemma2变身20ms实时学习端点，CPU上跑多模态 — michellechen · 2026-10-28
- Anthropic 招聘负责人取消编程面试：AI 时代已无信号价值 — felixrieseberg · 2026-10-28
- Nous 研究助手 memelord 支持 MCP 接入，还能讲段子 — alexcovo_eth · 2026-10-28
- Comfy Cloud 新增自定义节点包，一键生成无缝循环 H3 视频 — PurzBeats · 2026-10-28
- 开源工具 Chaosfolk 放 AI 用户攻击你的 Web 应用，专抓可复现 bug — Vjeux · 2026-10-28