实证研究：编码智能体主要阅读指令规范而非 API 文档

一则 X 帖子转述了一项针对 557 次真实编码会话和 33,097 个智能体 PR 的研究，称编码智能体阅读内容主要集中在指令文件与计划笔记，而非 API 文档，关注价值在于它把“如何给智能体提供上下文”从经验判断推进到可观测行为分析。

• 帖子给出的比例是：指令文件约占 35.4%，智能体计划笔记约占 25.1%，API 参考约占 1.3%。这些数字描述的是阅读行为，不等于不同文档对代码正确率的因果贡献。
• 帖子还称，1,328 次文档阅读中只有 3 次直接触发代码编辑，且没有观察到智能体完成工作后回看文档进行核对的案例。
• GitHub 官方 Codex 仓库的 AGENTS.md 显示，指令文件确实可承载代码规范、测试要求、平台约束和工作流程，因此它们更容易成为智能体执行时的直接上下文。
• 研究样本来自特定编码会话与 PR 数据，可能受到工具、项目类型、指令文件可见性及记录方式影响；不能据此推断所有智能体或所有 API 文档场景。
• 影响/看点：如果该研究方法和样本具有代表性，开发者可能需要优先维护可执行、可定位的项目指令；但是否能改善结果，仍取决于指令质量、任务类型和智能体是否被设计为验证文档。
• 资料依据:
• X：Rohan Paul（2026-08-30）：https://x.com/rohanpaul_ai/status/2094079949002985751
• OpenAI Codex 官方仓库《AGENTS.md》（2026-08-30）：https://github.com/openai/codex/blob/main/AGENTS.md

本内容由 AI 生成，仅供参考，请注意甄别