读代码库之前，先画出它的形状

作者用 Python 标准库编写了 shape.py，可在一屏内输出任意目录的结构概览：文件数、总大小、源码大小、非源码占比、顶层布局及最大的源码文件。以 OpenAI swarm 为例，仓库共 288 个文件，其中 examples/ 有 236 个，而框架本体 swarm/ 仅 6 个文件。作者认为这种结构比例会显著影响阅读代码库的方式。

AI推荐理由 作者用纯 Python 标准库写了一个 shape.py 工具，输出仓库的文件数、总大小、源码大小、非源码占比、顶层布局和最大源码文件，并以 OpenAI swarm 为例展示：288 个文件中 swarm/ 框架本体仅 6 个文件，examples/ 占 236 个。这是可复现的具体观察，对快速理解陌生代码库有实用价值；但工具本身较简单，且对 swarm 的解读仅基于文件结构，未涉及代码质量或功能。