thread-master/docs/product/growth-loop/requirements.md

173 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Requirements: 成長迴路(從「好用」到「非用不可」)
> Status: `draft`(待使用者批准)
> Slug: `growth-loop`
> Last updated: `2026-07-20`
> 輸入真相2026-07-20 PM 體檢結論;`apps/web` 現況 UI`docs/product/haixun-backend/`已交付能力git `main` 分支舊願景文件(`ai_threads_auto_account_ops.md`
## 1. 一句話
把巡樓從「AI 內容+外展工具組合包」升級成「**能證明 ROI、越用越準的 Threads 成長系統**」:先補 **成果歸因****學習閉環最小版** 兩塊護城河,再擴 **代操模式****帳號健康分**,最後以 **Playbook 市集+邀請獎勵** 啟動自增長。
## 2. 誰用、在什麼情境
| 角色 | 目標 |
|------|------|
| 品牌/小電商島民(靠 Threads 獲客) | 明確看到海巡與發文帶來多少成果(觸達→對話→追蹤→成交),據此決定續費 |
| 創作者島民 | 每週拿到「下週該做什麼」的具體建議,帳號穩定成長 |
| 代操Agency | 一套工具服務多個客戶:各自的品牌、人設、帳號、審核與月報 |
| 營運/管理員 | 用數據證明產品價值、量化平台政策風險、讓邀請網絡真正帶來增長 |
## 3. 背景與動機As-is → 為什麼改)
**2026-07-20 體檢結論(本 run 的存在理由):**
- **現況是「很用心的組合包」:** 產文有 ChatGPT 替代、排程 Buffer 已支援 Threads、單點皆有替代品組合方便≠必要。「非用不可」程度評估 **2.5 / 5**
- **儀表板只有成本視角:** 用量頁呈現「你花了多少點」,沒有任何地方告訴用戶「你賺回了多少」。無法證明 ROI 的工具,在續費時永遠是第一個被砍的。
- **真正的護城河沒做:** 舊願景的核心是「成效回收 → 分析原因 → 策略自我更新 → 可解釋」的**學習閉環**(舊文件 MVP4目前落在 P2 未實作。人設/品牌資產理論上「越用越準」,但**沒有可見的複利證據** → 轉換成本低。
- **邀請網絡是裝飾:** 關係樹已建,但「日後活動再說」=無獎勵機制=無網路效應。
- **灰帽功能無護欄:** ThreadPlay 多帳互回、養帳號短回屬平台政策敏感操作目前無健康度量化、無降速機制Meta 政策收緊是**存亡級風險**。
- **不改的後果:** 用戶燒完免費點數即流失;無溢價能力;政策風險歸零核心功能;增長全靠人工推銷。
**已握有的三張王牌(本 run 要放大,不重造):**
1. **海巡外展迴路**——最接近 painkiller「每天 15 分鐘,找到正在講你產品痛點的真人,用像人的口吻回覆帶單」=業務開發,市面 social listening 工具不碰這段。
2. **TC台灣 Threads 垂直深度**——語感、場景全 TC 原生,國際工具對 Threads 皆敷衍。
3. **8D 人設語紋+品牌知識資產**——具複利潛力,需要被「看見」。
**參考(非需求本體):**
- 舊願景閉環與 MVP14 驗收git `main` 分支 `ai_threads_auto_account_ops.md`
- 已交付能力真相:`docs/product/haixun-backend/spec.md`Insights 真管線維持 P2 的決策不變)
- UI 真相:`apps/web`今日海巡用量Insights 頁)
## 4. 目標To-be
### 4.1 必須達成P0— 價值可見 學習閉環最小版
1. **成果歸因(海巡 ROI 優先)**
- 外展回覆送出後,追蹤可合理取得的訊號:對方回應、帳號追蹤數變化、貼文互動、自帶 UTM 連結點擊;成交先走**手動回報**。
- 每筆成果可回溯到具體回覆/具體貼文(歸因鏈)。
- **今日頁與用量頁改為「成本+成果」並列**:本週/本月觸達、對話、追蹤、成交摘要卡。
2. **每週帳號健檢+下週行動建議(學習閉環 MVP**
- 基於**既有已同步貼文成效**(不重做 Insights 真管線),每會員每週自動產出一份 AI 報告哪類題材開頭CTA 有效(**必須引用證據、可解釋**)+下週 **3 個具體行動**,且每個行動可一鍵跳到對應功能(找話題/海巡/寫一則)。
- 這是舊願景 MVP4 的最小版,**不是**完整 Insights 管線。
3. **資產複利可見**
- 呈現「系統從你的 N 篇貼文M 次回饋學到什麼」:人設/品牌知識的學習摘要與版本,讓「越用越準」被感知,構成轉換成本。
### 4.2 應該有P1— 客群擴張 風險護欄
1. **代操Agency 模式**
- 多客戶工作區:每客戶獨立品牌+人設+帳號+方案視圖,工作區可切換、資料隔離。
- 草稿審核流:草稿 → 待審 → 已准/退回,已准才進 Outbox。
- 白牌月報 PDF 匯出(不含白牌域名)。
2. **帳號健康分(灰帽護欄)**
- 依操作密度/間隔/失敗率/平台訊號,給每個已連帳號 0100 健康分與降速建議。
- ThreadPlay海巡送出**前**自動檢查;過載時降速並向用戶說明原因;今日頁可見警示。
- **只做護欄,不新增更激進的多帳玩法。**
3. **邀請獎勵落地(單層紅線)**
- 直邀成員訂閱付費 → 邀請人得**產品點數**回饋(**單層、點數、非現金**,避免 MLM 觀感;文案維持「邀請人/直邀/延伸」)。
- 邀請頁可見累計回饋。
### 4.3 以後再說P2
1. **利基 Playbook 市集**:分享/引用海巡 brief、人設風格、互回劇本模板保養母嬰3C…需可匿名化。
2. **免費破冰工具**:公開免登入「風格指紋測驗」「痛點關鍵字產生器」,結果頁導註冊(用產品自己在 Threads 擴散)。
3. **跨帳號基準benchmark**:匿名聚合「同利基帳號中位數」比較。
4. 既有 P2 維持不變Insights 真數據管線完整版、真實金流/發票。
## 5. 範圍
### In scope
- 上述 P0P1 功能的**產品行為定義**;前端 `apps/web` 與後端 `apps/backend` 皆會異動(經 spec → plan → tasks 才動碼)。
- 歸因以「**可合理取得的訊號**」為限Threads API 可讀的公開計數、自帶 UTM 連結、手動回報。
- 每週健檢**重用既有同步貼文成效資料**,不新建 Insights 管線。
### Out of scope明確不做
- **不做多層獎金、不做現金回饋**MLM 紅線)。
- **不為歸因繞過平台限制**爬取私人數據;不做侵入式追蹤。
- 不串自動成交真金流P2 外)。
- 不重做既有發文/海巡主流程——本 run 是**加值層**,不是重構。
- 不新增灰帽玩法;多帳互回只加護欄。
- 代操模式 P1 不做白牌域名、不做多租戶帳單。
## 6. 使用者故事(可驗收)
### P0
| ID | 作為… | 我想要… | 以便… | 驗收要點 |
|----|--------|---------|--------|----------|
| US-01 | 品牌島民 | 看到本週海巡帶來的觸達/對話/追蹤/成交 | 判斷值不值得續費 | 今日頁+用量頁可見成果卡;每筆成果可回溯到具體回覆 |
| US-02 | 創作者 | 每週收到健檢報告3 個下週行動 | 知道該做什麼 | 報告含證據引用;行動可一鍵跳到對應功能 |
| US-03 | 島民 | 看到系統從我的貼文/回饋學到的東西 | 感到越用越準 | 資產頁可見學習摘要與版本號 |
### P1
| ID | 作為… | 我想要… | 以便… | 驗收要點 |
|----|--------|---------|--------|----------|
| US-10 | 代操 | 切換客戶工作區,各管各的品牌/人設/帳號 | 一套工具服務多客戶 | 工作區資料隔離;月報可匯出白牌 PDF |
| US-11 | 代操 | 客戶審核草稿後才進 Outbox | 交稿流程可控 | 草稿有 待審/已准/退回 狀態;未准不可送出 |
| US-12 | 島民 | 看到每個帳號的健康分與降速建議 | 不怕被平台懲罰 | 送出前自動檢查;過載自動降速並說明原因 |
| US-13 | 島民 | 直邀付費後我得到點數回饋 | 願意主動推廣 | 單層回饋端到端成立;邀請頁可見累計 |
### P2
| ID | 作為… | 我想要… | 以便… | 驗收要點 |
|----|--------|---------|--------|----------|
| US-20 | 島民 | 引用別人的利基 playbook 模板 | 快速上手新利基 | 市集可瀏覽/引用;作者可匿名 |
| US-21 | 訪客 | 免登入玩風格指紋測驗 | 認識產品 | 結果頁導註冊;可在 Threads 分享 |
| US-22 | 島民 | 看我跟同利基帳號中位數的比較 | 知道自己程度 | 匿名聚合;樣本不足時不顯示 |
## 7. 成功標準
- [ ] **P0** 至少一條「海巡外展 → 送出 → 成果(對方回應或追蹤變化)」完整歸因鏈可展示。
- [ ] **P0** 每週健檢報告自動產出,含 ≥3 條**帶證據**的行動建議,且可一鍵跳功能。
- [ ] **P0** 用量頁從純成本視角改為成本+成果並列。
- [ ] **P1** 代操可在 2 個工作區間切換,各自產出月報 PDF草稿未經審核不可進 Outbox。
- [ ] **P1** 健康分對每個已連帳號可見;高密度操作被自動降速並有說明。
- [ ] **P1** 單層邀請點數回饋端到端成立(訂閱 → 點數入邀請人帳)。
- [ ] **定性:** 用戶訪談能說出「這工具幫我賺/省了多少」的**價值句**,而非只描述功能。
## 8. 約束與假設
- **約束:**
- `AGENTS.md` 全部契約精神UTC nano、envelope、分頁、guarded job、go-zero、etc 單份、數字 uid、權限中介層
- 前端 `apps/web`:不引入新 UI 框架mocklive 同一 repository 介面TC 台灣語感。
- **平台政策紅線:** 所有自動化必須保留人工路徑(延伸現有「複製 → 開 Threads 留言 → 標記完成」模式);灰帽功能只加護欄不擴大。
-`haixun-backend` 的關係:本 run 是**加值層**,其 spec 已交付能力為底座「Insights 真管線維持 P2」決策不變。
- **假設spec 階段須驗證):**
- Threads API 可取得追蹤數/回覆計數等歸因訊號(權限項待查);拿不到時降級為互動歸因+手動回報。
- 既有同步貼文成效資料足以支撐每週健檢最小版。
- 成交回報 P0 先手動,用戶願意填。
## 9. 風險
| 風險 | 影響 | 緩解(需求層) |
|------|------|----------------|
| 歸因訊號拿不到API 權限限制) | P0 價值證明變弱 | spec 先驗證權限;降級為對話/互動歸因+手動成交回報,仍優於現況 |
| Meta 平台政策收緊 | 存亡級 | 健康分+人工路徑+功能開關;不新增灰帽玩法;健康分本身即緩解 |
| 學習閉環品質不穩、報告不可信 | 核心賣點崩壞 | 強制證據引用;先小範圍給既有用戶試用再全面推 |
| 邀請獎勵被觀感為 MLM | 品牌風險 | 單層、點數非現金、既有「邀請人/直邀/延伸」用語不變 |
| 代操模式範圍爆炸 | 工期失控 | P1 只做工作區隔離審核流PDF白牌域名多租戶帳單明確排除 |
| P0 被 P1/P2 稀釋 | 本 run 失去存在理由 | 交付順序硬性:歸因+健檢先行,其餘往後排 |
## 10. 開放問題
1. 歸因訊號清單與 Threads API 權限驗證 → **spec 階段列出並定案**
2. 每週健檢計費:建議**方案內含**(它是留存工具,不是變現點)→ 待批准。
3. 代操工作區與現有單租戶/島民模型的關係(是否走向多 workspace**spec 決策**
4. 邀請點數回饋的比例與每月上限 → plan 前定。
5. 健康分的訊號來源、計算頻率與降速門檻 → spec 定。
6. 成果卡的「成交」是否未來接 UTM 落地頁P2→ 現在先手動。
## 11. 批准
- [ ] 需求已批准(日期/誰):
---
**給批准者:** 若整體方向 OK 請回「**需求 OK**」→ 下一回合寫 `spec.md`歸因狀態機、健檢報告契約、健康分行為、工作區模型、Retain-Replace-Remove
若只想先做 P0 兩項(強烈建議),也請指明,其餘維持文件紀錄即可。