论文页面 - Agent READMEs：面向智能体编码的上下文文件实证研究

来源：https://huggingface.co/papers/2511.12884 发表于 2025 年 11 月 17 日

·

提交者 https://huggingface.co/hao-li

Leo (https://huggingface.co/hao-li) 于 2025 年 11 月 19 日

摘要

智能体编码工具接收自然语言编写的目标作为输入，将其分解为具体任务，并在最少人工干预的情况下编写或执行实际代码。这一过程的核心是智能体上下文文件（“智能体专用的 README”），它们提供持久化、项目级的指令。在本文中，我们对来自 1,925 个仓库的 2,303 个智能体上下文文件进行了首次大规模实证研究，以刻画其结构、维护方式和内容。我们发现，这些文件并非静态文档，而是复杂且难以阅读的产物，它们像配置代码一样演进，通过频繁的小型添加进行维护。我们对 16 种指令类型的分析表明，开发者优先考虑功能性上下文，例如构建和运行命令（62.3%）、实现细节（69.9%）以及架构（67.7%）。我们还发现了一个显著的缺口：安全性（14.5%）和性能（14.5%）等非功能性需求极少被明确指定。这些发现表明，尽管开发者利用上下文文件使智能体具备功能，但他们很少提供保障机制来确保智能体编写的代码安全且高效，这凸显了对改进工具和实践的需求。

查看 arXiv 页面 (https://arxiv.org/abs/2511.12884) 查看 PDF (https://arxiv.org/pdf/2511.12884) 项目页面 (https://agents.md/) GitHub 21.1k stars (https://github.com/openai/agents.md) 添加到收藏集 (https://huggingface.co/login?next=%2Fpapers%2F2511.12884)

在您的智能体中获取此论文：

hf papers read 2511.12884

没有最新版的 CLI？curl -LsSf https://hf.co/cli/install.sh | bash

引用此论文的模型 0

暂无模型链接此论文

在模型的 README.md 中引用 arxiv.org/abs/2511.12884 即可从此页面建立链接。

引用此论文的数据集 4

hao-li/AIDev 查看 • 28 天前更新 • 2.46M • 7.68k • 30 (https://huggingface.co/datasets/hao-li/AIDev)

farida5gaber/AIDev 查看 • 3 月 27 日更新 • 2.46M • 288 (https://huggingface.co/datasets/farida5gaber/AIDev)

dysavepeople/AIDev 查看 • 4 月 3 日更新 • 2.46M • 152 (https://huggingface.co/datasets/dysavepeople/AIDev)

hao-li/AgentREADMEs 查看 • 3 月 29 日更新 • 2.3k • 19 (https://huggingface.co/datasets/hao-li/AgentREADMEs)

引用此论文的空间（Spaces） 0

暂无空间链接此论文

在空间的 README.md 中引用 arxiv.org/abs/2511.12884 即可从此页面建立链接。

包含此论文的收藏集 10

浏览包含此论文的 10 个收藏集 (https://huggingface.co/collections?paper=2511.12884)