一手资料
Primary source
以原始形式存在的事实来源——代码、对话记录、原始日志、实际的 API 响应。不是对事物的描述，而是事物本身。与二手来源相对。
如果想知道代码库实际做了什么，代码就是一手来源。文档、架构图和 README 都只是对它的描述——编写时可能准确，此后却各自按自己的节奏更新。当 Agent 自信地对你的项目作出错误断言时，应追问它依据的是哪种来源：阅读文档的 Agent 会继承文档的陈旧信息；阅读代码的 Agent 读取的则是当前事实。
成本是阻碍一手来源成为默认选择的原因。将一手来源载入上下文窗口成本高昂——完整文件、完整对话记录，每个 Token 都计入输入费用，并竞争注意力预算。付出这份成本所换来的是完整性：没有任何内容因他人对“什么重要”的判断而被预先过滤。上个月写的摘要不可能包含今天才发现至关重要的细节；一手来源中仍然保留着它。
需要精确性时，应使用一手来源——准确的签名、实际的错误、真正抛出异常的那一行。上下文管理很大一部分工作，就是决定何时值得为一手来源付出成本，何时二手来源已经足够。
用法：
“Agent 说重试逻辑采用指数退避，但我眼看着它在疯狂请求端点。”
“它是从设计文档里读到的。让它查看实际的重试模块——当行为很重要时，要以一手来源为准。”