工程团队上周提交312次代码,涉及47个合并请求、18个服务。CEO说不清这些代码在做什么,销售还在演示上季度的功能,产品站会三周没提过实际工作项。

问题不是工程师不写文档。他们写了312份。

打开网易新闻 查看精彩图片

问题是公司里没人能读懂。

老梗翻篇:从"不写"到"读不懂"

"工程师不写文档"曾是软件行业最重复的迷思。AI把这个等式彻底颠倒。

工程师每天都在交付最精确的文档:代码本身。代码差异(diff)是变更的无歧义记录,说明功能如何实现、哪些边界情况被处理。提交信息和合并请求描述是摘要。代码即真相来源。十人工程团队每周产出数千行这样的内容,带作者署名、时间戳、链接和评审记录。

文档从未缺失。只是非程序员无法阅读。变化在于AI终于能读懂代码,并用 plain English 解释。读者出现了。

原材料已经写好了

你团队本周提交的代码差异,无需询问任何人,已经告诉你:

• 哪些bug被修复(支持团队需要)
• 哪些功能在推进中(销售团队需要)
• 哪些基础设施在加固(CEO需要)
• 哪些实验在进行(产品团队需要)
• 谁被什么卡住(管理者需要)

每个信号都藏在已提交的代码里。工程师无需多写一句话。文档工作在代码提交那一刻已经完成。

同一个仓库,五种问法

销售问:"这个月我能演示什么上个月还不能的?"

支持问:"本周哪些提交可能解释我看到的工单激增?"

市场问:"这些里面哪个值得在上线时写发布文章?"

CEO问:"本周工作真的对齐季度目标,还是我们在漂移?"

产品问:"哪些提交动了我负责的结账流程?"

同一个git历史,五种视角。没人有时间把提交日志读五遍、用五种不同过滤器筛选。结果就是没人读,各团队等到客户投诉才发现问题。

提交级别,而非发布级别

发布说明是给客户的,写的时候已经晚了。

GitDigest往前推一层,在提交级别运作:团队在构建什么,而非刚发布了什么。提交发生在工作完成时,比上线早几天或几周。这段提前量就是全部意义。

等东西上线时:
• 销售需要已经知道它要来
• 支持需要已经被简报
• CEO需要已经决定是否发布

提交级可见性给你提前量。发布级可见性给你意外。

GitDigest如何替你阅读

GitDigest每周一上午9点运行。它读取实际代码差异,用大型语言模型(LLM)生成摘要,按团队定制:销售看到可演示功能,支持看到可能解释工单的模式,CEO看到与季度目标的对比。

每个摘要链接回原始提交。想深挖的人可以验证。不想深挖的人终于能跟上进度。

这不是替代工程师写文档。这是把已经写好的代码变成全公司能用的情报。

为什么是现在

三个条件刚刚同时成熟:

代码量爆炸。现代团队每周提交数百次,人工阅读已不可能。

LLM能力跨越门槛。2023年前的模型读不懂代码结构。现在的模型可以。

远程协作常态化。团队分散在不同时区,异步信息流动成为瓶颈。

GitDigest的赌注是:文档问题从来不是写作问题,是翻译问题。工程师用代码写作,其他部门需要 plain English。AI成了中间的同声传译。

谁在买单

早期用户画像清晰:200-500人规模的B2B SaaS公司,工程团队占30-40人。典型场景是销售demo前夜,客户经理不知道这周新上了什么功能,Slack轰炸工程师求解释。

GitDigest的定价按仓库数量,而非用户数。这个设计暗示目标买家是工程负责人,他们想解决的是"其他部门总来打扰"的问题,而非"我们文档太少"的问题。

产品目前集成GitHub,GitLab和Bitbucket在路线图。摘要输出支持Slack、邮件和Notion。

边界与诚实

GitDigest的创始人承认局限:AI摘要会漏掉上下文。一次提交可能修复bug,但原因藏在三个月前的架构决策里。代码差异不解释"为什么",只解释"做了什么"。

他们的回应是双向链接。每个摘要指向原始提交,每个提交指向相关工单。读者可以沿链条深挖,也可以选择停在摘要层。

另一个诚实:代码差异不包含有意隐瞒。如果工程师用模糊提交信息掩盖重构,GitDigest只能如实转述模糊。工具不创造透明度,只放大已有的透明度。

竞争格局

这个赛道正在拥挤。Linear的Cycle AI尝试类似方向,从工单系统生成更新。Jira的Atlassian Intelligence做智能摘要。GitHub Copilot for Docs瞄准同一痛点。

GitDigest的差异化是专注:只做git历史,只做内部同步,不做客户-facing的发布说明。这个窄切口让它在提交级别做深,而非在发布级别与Notion、Coda竞争。

风险也来自这个专注。如果GitHub或GitLab原生推出类似功能,独立工具的生存空间会被压缩。创始人的赌注是:大平台动作慢,且倾向于通用方案,垂直深度足够形成护城河。

一个测试

判断这类工具有没有价值,可以问三个问题:

你的非技术同事上次主动查看代码仓库是什么时候?

你的周会有多少时间花在"这周到底做了什么"的同步上?

你的发布说明从代码提交到客户可见,平均延迟多少天?

如果三个答案都是"很少/很多/很久",代码翻译层就有存在的空间。

GitDigest不是让工程师写得更多。它是让写得好的东西被更多人看见。这个视角转换,可能是AI对组织沟通最根本的改造之一。