![]()
每個(gè)技術(shù)團(tuán)隊(duì)都有同一個(gè)儀式。Sprint結(jié)束,有人問:"能寫一下這次發(fā)了什么嗎?"房間突然安靜。
開發(fā)者不想寫,因?yàn)樗麄円呀?jīng)在PR描述里寫過了。產(chǎn)品經(jīng)理不想寫,因?yàn)橐话氲募夹g(shù)改動(dòng)他們看不懂。客戶呢?要么啥也收不到,要么收到一堵術(shù)語墻。
真正的痛點(diǎn)不是寫更新日志,是寫三份——同一批PR,三份完全不同的文檔。沒人有時(shí)間干這個(gè)。
市面上的工具,都在回避核心問題
作者調(diào)研了一圈現(xiàn)有方案:GitHub的自動(dòng)生成?只是把PR標(biāo)題拼起來。Release Drafter?靠標(biāo)簽分類,寫不出人話。AI工具比如WhatTheDiff?只給開發(fā)者看,不管其他兩撥人。
沒有一個(gè)能生成多受眾內(nèi)容。沒有一個(gè)能理解改動(dòng)背后的上下文,只會(huì)抓標(biāo)題和標(biāo)簽。
于是他做了ShipLogs——一個(gè)GitHub App,監(jiān)控合并的PR,自動(dòng)給開發(fā)者、產(chǎn)品團(tuán)隊(duì)、客戶分別生成更新日志。
技術(shù)鏈路很直接:GitHub(webhook)→ Next.js API → Claude AI → Supabase → 儀表板。
安裝ShipLogs GitHub App后,它會(huì)注冊(cè)PR事件的webhook。PR一合并,webhook觸發(fā),抓取:PR標(biāo)題和描述、改動(dòng)的文件、作者信息、標(biāo)簽、關(guān)聯(lián)的issue或ticket。數(shù)據(jù)進(jìn)Supabase。觸發(fā)生成時(shí)(自動(dòng)或手動(dòng)),批量發(fā)送給Claude。
同一批PR,怎么變出三份完全不同的東西
關(guān)鍵在于系統(tǒng)提示詞(system prompt)的設(shè)計(jì)。每個(gè)受眾模式給Claude的指令完全不同:
開發(fā)者模式:要技術(shù)細(xì)節(jié)、遷移步驟、破壞性變更警告。產(chǎn)品團(tuán)隊(duì)模式:要功能價(jià)值、業(yè)務(wù)影響、優(yōu)先級(jí)排序。客戶模式:要用戶收益、操作變化、零術(shù)語。
用Claude的結(jié)構(gòu)化輸出(Zod schemas),確保返回永遠(yuǎn)可解析——標(biāo)題、摘要、分類條目、元數(shù)據(jù),格式固定。
提示詞緩存(prompt caching)大幅壓低成本。系統(tǒng)提示用cache_control: { type: "ephemeral" }緩存,窗口期內(nèi)重復(fù)調(diào)用只付PR專屬輸入的錢。單份更新日志成本約0.06美元。
看同一批PR的三份輸出:
開發(fā)者版:"Breaking: AuthMiddleware現(xiàn)在需要顯式session配置。遷移:更新middleware.ts傳入sessionConfig選項(xiàng)。Added: /api/webhooks/*端點(diǎn)限流(100 req/min),用Redis后端滑動(dòng)窗口。"
產(chǎn)品團(tuán)隊(duì)版:"Infrastructure: API端點(diǎn)現(xiàn)已防護(hù)流量突增,高使用時(shí)段穩(wěn)定性提升。Improved: 登錄流程因session處理更新而更快更可靠。"
客戶版:"Faster login——我們改進(jìn)了登錄體驗(yàn),讓你更快進(jìn)入儀表板。Better reliability——幕后改進(jìn)確保ShipLogs在高峰時(shí)段也能流暢運(yùn)行。"
同一批改動(dòng),三個(gè)視角。這就是價(jià)值所在。
被忽視的免費(fèi)層陷阱
Team版用戶每天早上能在Slack收到昨日合并PR的摘要。團(tuán)隊(duì)開工前就知道昨天發(fā)了什么——不用任何人寫總結(jié)。
一鍵導(dǎo)出Markdown或復(fù)制到剪貼板。也能直接從儀表板起草GitHub Release,自動(dòng)填對(duì)標(biāo)簽、標(biāo)題和正文。
但作者踩過一個(gè)坑:免費(fèi)層必須從第一天就設(shè)限。他限定免費(fèi)用戶1個(gè)倉庫、每月3份更新日志、每天1份。不設(shè)上限的話,1萬免費(fèi)用戶每月AI調(diào)用成本約6000美元。
這個(gè)細(xì)節(jié)很多獨(dú)立開發(fā)者會(huì)忽略。先做功能再補(bǔ)限制,賬單教你做人。
ShipLogs現(xiàn)在跑在Next.js + Supabase + Claude的組合上。作者沒透露用戶數(shù)量,但提到"正在處理一些大團(tuán)隊(duì)的早期反饋"。
工具本身是個(gè)縮影:AI時(shí)代的產(chǎn)品機(jī)會(huì),往往藏在"所有人都抱怨但沒人愿意修"的 workflow 里。更新日志寫了二十年,終于有人把它當(dāng)成正經(jīng)產(chǎn)品問題來解決。
你會(huì)為這種"省時(shí)間但不算核心功能"的工具付費(fèi)嗎,還是寧愿繼續(xù)讓實(shí)習(xí)生手動(dòng)整理?
特別聲明:以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布,本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
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.