给编码 Agent 先喂 2000 Token 项目地图

2026-11-01 09:01，DEV Community 的 AI 专栏发表了一位作者的文章，题为《老仓库先给 Agent 一份 2000 Token 项目地图》。文章建议，在给编码 Agent 下达第一个任务前，先用几条命令生成一份约 2000 Token 的项目地图，把目录结构、测试目录位置等原本需要 Agent 自己摸索的信息直接交给它。

文章描述了一个场景：打开一个有十年历史的 PHP 应用，启动编码 Agent，输入「add a refund endpoint」，Agent 会列出根目录、读 composer.json、搜索 Controller，打开三个最终发现是死文件的文件，又找到第二个无人运行的 tests/ 文件夹，之后才能开始干活。作者认为，这样能避免 Agent 在每个新会话里重复遍历这个十年老仓库，把上下文窗口浪费在死文件和没人运行的测试上。

这篇文章的作者还写了《Decoupled PHP — Clean and Hexagonal Architecture for Applications That Outlive the Framework》《Thinking in Go》（2 册系列，含《Complete Guide to Go Programming》和《Hexagonal Architecture in Go》），维护着一个名为 Hermes IDE 的项目，定位是为使用 Claude Code 及其他 AI 编码工具的开发者服务的 IDE，站点是 xgabriel.com。