打开一个 pull request,扫一眼改动,测试全绿,功能看着也对。手指悬在合并按钮上,脑子里突然冒出一个小声音:如果库存已经预留了,支付这时候失败会怎样?
于是你停下,把分支拉到本地,顺着行为穿过校验、库存、支付、持久化、错误处理好几个组件。一边追一边记,试图搞懂一段不是你写的代码——现在还有谁是自己写的呢。
这正是 READIT 想解决的问题:代码归你所有,和代码被你理解,中间隔着一道沟。
加入一个已有项目,往往意味着从零散的线索里重建心智模型:路由、服务、测试、数据库调用,再加上跟上一个碰过这个功能的人聊几句。而如今越来越多的代码由 AI 以极快的速度生成,我们对系统内部运作的理解,掉队的速度也一样快。
问题已经不是技术债了。作者给了一个新说法:认知债(Cognitive Debt)。
认知债的一个症状,是答不上来那些平时根本不会绊倒你的问题,比如“从最初的请求到最终的响应之间,到底发生了什么”。如果你没法有把握地回答这类问题,就已经是认知债的受害者了。
作者自己就是样本:一年多几乎没手写过代码,生产力高得像科幻小说,但他承认,认知债正在他身上收账。
他不想每次落到一个新项目、或者要评审一个新功能和新改动时,都靠手动给 agent 写提示词。他想要一种简单、快速、可交互的方式,去探索和理解一个代码库。这就是 READIT。
READIT 由三部分组成:一个 agent Skill、一个 Node.js CLI,以及一个交互式 UML 浏览器。它围绕两个相互连接的视图来组织一个仓库。
第一个视图回答:这个应用让人能做什么?一张 UML 用例图把参与者和他们的目标画出来——下单、邀请成员、发布报告。你可以选中一个目标,再展开它的各个场景。
第二个视图回答:代码是怎么让这件事发生的?一张 UML 时序图跟随实现某个场景的交互过程。你可以播放整个流程,逐条消息单步走,并查看每条消息关联的代码。
导航从用户的意图出发,一路带进实现细节。
想试的话,装好 Node.js 22+,在项目目录里执行:
- npx skills add MansourFall/readit --skill readit
然后在你的编码 agent 里调用它。作者特别提醒,调用时用的 composer 语法属于宿主工具,不属于 READIT CLI。
项目以 MIT 许可证开源。作者说,他很想听听那些在陌生仓库里工作、或者要评审 agent 生成改动的人的意见。
回到开头那个问题:测试通过不等于你懂了。AI 把写代码的成本压到接近零,理解代码的成本却原封不动地留在了原地。这笔账,迟早要还。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.