CodeStories：把代码库讲成故事，为 AI 时代重建代码理解

omojumiller · x · 2026-10-19

Omoju Miller 指出，今年有两家公司重造了 git，却没人重造「我们如何理解代码里发生了什么」。Anthropic 说工程师已无法逐行阅读代码，只能审查意图——用什么审？作者据此开发了 CodeStories：以一次真实 traced run 为线索，把代码库讲成分章的故事，每个论断都锚定到具体代码行，每章附带类似测试的证明，可像测试一样失败。以 Textualize/rich 库为例，故事配有控制流图，读者可点击图中节点跳转到对应代码位置，顺着「一次预期使用中数据的旅程」建立心智模型。作者受 Angus Fletcher《Primal Intelligence》「人类智能运行在叙事之上」的启发，以两周冲刺的方式探索「代码理解的新位置」——diff 读久了枯燥，巨型迁移 PR 更没人硬啃，需要一个新的理解载体。