让 Agent 先查本地文档,别一上来就联网
让编码 agent 联网搜文档,既慢又费 token,还会给出不稳定的答案。维护一份本地精选参考文档,同一个问题每次都能拿到同样的答案。
核心要点
- 幻觉税还有个更安静的表亲:agent 用了过时的 API 版本。大家谈 LLM 失败模式都只想到幻觉(自信地编造),但用错版本同样致命。
- 一份共享的 .agents/ 目录:Claude Code、Gemini CLI、GitHub Copilot 共用同一份本地参考。
- 确定性收益:同一个问题,每次运行拿到同样的答案——这对 CI 和团队协作至关重要。
- 顺带省 token:不用每次都把整个网页塞进上下文。
◇ 对你的项目意味着什么
团队内部建一个共享的 .agents/ 文档目录,把你常用的框架文档镜像到本地。这是投入最小、见效最快的一件事。