gu-log SP-251 繁體中文翻譯版。原作:Thariq (@trq212)Know your unknownsEnglish
← 所有範例
認識你的未知 · 實作前

腦力激盪介入點

在決定要修什麼之前,先讓 Claude 根據程式碼裡實際存在的東西,列出整個選項空間——這樣你的選擇才是建立在你原本不知道自己有的替代方案上。

Prompt
「這是我大概的問題:Acme 的使用者在完成新手引導後就流失。搜尋整個 codebase,腦力激盪 10 個我們可以介入的地方,從最省力到最有野心排列。我會告訴你哪些讓我有感。」
Claude 產出的內容
Acme · 新手引導後流失

10 個介入點,從最省力到最有野心

我搜尋了 apps/webservices/packages/ 裡的新手引導、邀請和首次工作階段的程式碼路徑。發現一個模式:很多留存機制其實已經存在,只是沒有連起來——下面最省力的選項大多是接線,不是從頭建造。勾選讓你有感的,然後複製底部的回覆。

今天下午就能上線 季度級別的賭注
接線新 UI新生命週期新功能面
#1

修復死路空白狀態

S
apps/web/src/onboarding/EmptyState.tsx

在程式碼中找到 —— 零專案的儀表板只渲染插圖和文字「還沒有專案」——沒有別的了。NewProjectButton 就在兩個目錄外但沒人 import 進來;唯一的出路是頂端導覽列上那個小小的「+」。每個流失使用者的最後一個畫面大概都是這個。

影響100% 的新使用者都會看到這個畫面;放一個真正的 CTA 加上「把影片拖到任何地方」的提示,就能移除產品裡最字面意義的死路。
#2

打開已經存在的範例專案

S
apps/web/src/projects/sampleProject.ts

在程式碼中找到 —— 有人做了一個完整的預載示範專案——「產品預告 v3」,有 45 秒片段、四則帶時間戳的留言、一個已解決的討論串——藏在 sample_project_v1 這個 flag 後面。這個 flag 對所有人仍然是 false,檔案已經 8 個月沒動過了。功能做完了,只是從來沒上線。

影響新使用者在上傳任何東西之前就能看到一個活的審核長什麼樣子。最省力的「啊哈」時刻——翻個 flag,驗證一下 seed 腳本就好。
#3

在 app 內顯示待處理邀請

S
services/mailer/templates/invite.mjml · apps/web/src/team/TeamPanel.tsx

在程式碼中找到 —— 邀請只用 email 送出。TeamPanel 查詢 team_members 但完全忽略 invites 表——邀請者看不到他的隊友沒接受,也沒有重寄功能。對於一個協作審核工具來說,單人使用者就是等著流失。

影響顯示「2 封邀請待處理 · 重寄」把看不見的邀請腐爛變成可見、可修復的狀態。
#4

把里程碑表接到儀表板清單

M
services/api/src/models/userMilestones.ts · apps/web/src/dashboard/Dashboard.tsx

在程式碼中找到 —— 後端已經在 user_milestones 記錄 first_uploadfirst_commentfirst_invite_acceptedfirst_approval——但沒有前端程式碼讀這張表。它純粹是為了分析儀表板存在的。「4 步完成 3 步」清單的所有材料都已經在那了。

影響清單可靠地提升啟動率;這個只需要一個 endpoint 和一個 component,因為追蹤已經在運作了。
#5

設計首則留言的時刻

M
apps/web/src/review/CommentComposer.tsx · apps/web/src/review/Timeline.tsx

在程式碼中找到 —— 帶時間戳的留言是 Acme 的核心循環,但引導很隱晦:點擊時間軸會把時間戳填進撰寫器,但沒有任何東西教這個。Timeline.tsx 有一個來自原作者的 TODO: first-run hint?。在首次播放時加一個幽靈標記——「點擊任何地方在這個時刻留言」。

影響如果首次工作階段留言率是啟動指標(應該是),這就是對它最直接的槓桿。
#6

救援靜默失敗的首次上傳

M
services/ingest/src/transcode/queue.ts

在程式碼中找到 —— 當轉碼失敗(不支援的編碼、太大的 ProRes、損壞的 moov atom),任務會移到 failed、記到 Sentry,但什麼都不告訴使用者——專案卡片就只是永遠轉圈圈。有一個用備用預設重試的程式碼路徑,只能從內部管理腳本存取。

影響首次上傳永遠卡住的使用者不會開票——他們直接走人。自動重試加上誠實的錯誤 email,把一條靜默流失的路徑轉成支援路徑。
#7

團隊的「一起看」首次工作階段

L
apps/web/src/review/PresenceProvider.tsx · services/realtime/

在程式碼中找到 —— 即時在場功能已經完全做好——共享播放頭、即時游標、「Maya 正在看」徽章——但只有在兩個人剛好同時打開同一個審核時才會亮起來。沒有任何東西安排這個巧合。當隊友接受邀請時加一個「一起審核」排程提示,把兩人深連結到同一個工作階段。

影響體驗過一次即時工作階段的團隊留存率可能跟單人使用者不同;這讓多人時刻變成刻意的而不是運氣好。
#8

上線五個審核流程範本

L
packages/workflows/src/definitions/

在程式碼中找到 —— 審核流程(初剪 → 客戶審核 → 最終簽核)完全可配置——而且一開始完全是空白的。definitions 目錄只有測試用的 __fixtures__。根據 WorkflowEditor.tsx 裡的註解,高級使用者是複製一份共享的 Notion 文件來設定的。上線 5 個有觀點的範本:agency 交付、YouTube 管線、客戶簽核、內部 QA、在地化審核。

影響範本把「配置這個抽象概念」轉成「選擇你的工作」——工作流程工具空白畫布流失的經典解法。
#9

內建快速螢幕 & 攝影機錄製

XL
新功能面 · services/ingest 已經接受分塊 webm

在程式碼中找到 —— 今天 Acme 的新手引導有一個硬性外部依賴:你需要一支做好的影片,產品才有用。但 services/ingest 已經接受分塊 webm 上傳(為行動 app 做的),所以一個基於 MediaRecorder 的「錄製你的螢幕、取得回饋」流程不需要動 pipeline——「只」需要擷取 UI。移除試用期閒置的最大原因:還沒有東西可以審核。

影響改變誰能啟動——沒有剪輯軟體的設計師和 PM 可以自己創造第一個可審核的產物。大工程、大範圍。
#10

一級公民的客戶審核門戶

XL
services/auth/src/guestTokens.ts · apps/web/src/share/

在程式碼中找到 —— 訪客分享連結存在但被刻意閹割:token 24 小時後過期、訪客不能留言,還有一個兩年前留下的 // TODO(sasha): revisit guest perms after launch。流失的使用者往往是那些客戶不願意註冊的人。讓訪客變成一級公民——持久門戶、填名字就能留言、不需要帳號——每次外部審核都變成留存循環(順便也是獲客循環)。

影響攻擊結構性原因:Acme 的價值依賴於拒絕創建帳號的人。季度級別的賭注,牽涉身份驗證、計費和反濫用。
0 個有感 勾選讓你有感的介入點——你的回覆會在這裡生成。