如何让 Coding Agent 高效读懂陌生项目

不要从逐文件总结开始

逐个文件解释通常会产生大量信息，却没有建立系统的运行模型。更有效的方式是先提出一个具体问题，例如“请求从页面进入后经过哪些模块”。

推荐阅读顺序

1. 阅读 README、依赖和启动脚本。
2. 找到应用入口和配置加载位置。
3. 沿一个真实请求追踪调用链。
4. 查看状态模型、数据表和外部服务边界。
5. 用测试或最小运行验证理解是否正确。

给出证据

要求 Coding Agent 在结论中指出对应文件和关键代码位置。架构判断必须能回到代码，而不是只根据目录名猜测。

最终产物

一份好的项目理解结果应包括运行方式、核心数据流、模块职责、持久化边界、已知风险和下一步可以验证的问题。