本文探讨了AI编码Agent如何通过字符串搜索(如grep/ripgrep)来导航代码库,并提出了让代码对代理更“可发现”的实践建议:使用描述性命名、精准类型、注释放在定义处、统一拼写、标记遗留代码等。作者通过两个实验验证了这些方法的效果:在生成的TypeScript库中,遵循建议后代理读取代码的token消耗平均降低6%~66%,错误答案减少;在真实Python项目Odysseus中,重构使代理查找效率提升,bug检测率从23/32提高到32/32。文章强调,代理没有人类的理解背景,代码中的文本就是它们唯一的线索,因此为代理编写的代码本质上也会让人类受益。