DC娱乐网

写文档?程序员最痛恨的事情没有之一。代码改一行,注释翻三页?别装了,你的READ

写文档?程序员最痛恨的事情没有之一。代码改一行,注释翻三页?别装了,你的README可能比你的代码还老。开源项目openwiki想终结这种折磨。它是个TypeScript写的CLI工具,核心功能就一句话:自动扫描你的代码库,生成并维护agent文档。你不需要手动排版,不需要在每次PR后半夜补文档。跑一下命令,AI根据代码变化自动更新文档,文档里的“agent”指的就是你的整个代码逻辑的智能代理——说白了,它能理解你写的每一段功能,然后给你写清楚:这段是干什么的、入口在哪、和谁有依赖。代码每次变动,openwiki自动检测差异,只更新受影响的部分,不胡写、不覆盖你的人工批注。GitHub 3164颗星不是白给的,这帮人受够了“文档已过时”的锅。观点?钝刀子割肉的时代该结束了。如果你的团队还在为文档质量撕逼,要么上openwiki,要么承认你们就是懒。结尾来真格的:你会彻底弃用Sphinx、JSDoc这些传统工具,改让AI自动维护文档吗?评论区说出你的狠话。