LazyBoy2/docs/scenarios/README.md

Scenario playbooks（情境劇本）— 可推廣的 GrokBoy 驗收模式

本目錄描述 可重複套用 的 acceptance playbook：把「研究來源 → 草稿 → 人工確認 → 發佈到目標頻道」做成固定兩階段流程。
蝦皮聯盟 → Threads 只是一個填好的範例，不是唯一路徑。

產品原語（讓所有情境可推廣）：

原語	用途
browser_handoff	僅用於登入／OTP／驗證碼牆
request_user_confirm	任何不可逆公開動作（發文、送出）前必須過關
Phase A / Phase B	研究+草稿 vs 確認後才發佈

相關：docs/SCENARIO-TEMPLATE.md、prompts/templates/、範例 examples/shopee-threads-affiliate.md。

---

目標與成功標準

過（Pass）

1. 端到端完成：從來源入口找到可用素材／連結，產出目標頻道草稿，經確認後成功發佈（或明確 blocked）。
2. 人工觸點最小化：理想上只有
   (1) 來源站登入 handoff
   (2) 目標頻道登入 handoff
   (3) 最終發佈 confirm
   — 其餘自動化。
3. 零靜默發佈：沒有「本輪明確核准的草稿」或 request_user_confirm → approved，就不得 publish／send。
4. Phase 分離：Phase A 禁止發佈；Phase B 只在核准後發佈。

不過（Fail）

• 未確認就發文／按送出
• 非 headed 導致 cookie 遺失、無限重登
• 列表／空結果空轉（loop guard 觸發仍算流程失敗若未 report_blocked 說明）
• 把登入以外的事丟給人（例如叫人手動複製貼上整篇文，而非 agent 貼上後只等 confirm）

---

Phase A — 研究 + 草稿（禁止發佈）

1. 若需登入來源：browser_handoff（僅 auth）。
2. 在 {{SOURCE_PORTAL}} 依 {{GOAL}} 找出約 2–5 個候選（高佣／相關／可分享）。
3. （可選）快速看 {{TARGET_CHANNEL}} 語氣／近期風格。
4. 用繁中（或指定語言）起草 1 則貼文，含連結；結構化輸出候選 + 草稿。
5. report_done — 禁止 click send／publish。

Phase B — 僅在確認後發佈

1. 僅在本 session 已有「明確核准的同一草稿」，或先呼叫 request_user_confirm（prompt = 全文草稿）。
2. 若需登入目標頻道：browser_handoff。
3. 貼上並發佈已核准草稿。
4. report_done（盡量附貼文 URL）；若未核准 → report_blocked，不得單方面發文。

---

環境與指令

export GROKBOY_API_KEY=你的金鑰
export GROKBOY_BROWSER_HEADED=1   # 強烈建議；否則 cookie／session 易丟
cd ~/GrokBoy
cargo run -p grokboy -- agent

測試用：GROKBOY_CONFIRM_AUTO=1（核准）／abort（拒絕）；亦可沿用 GROKBOY_HANDOFF_AUTO。

如何貼 prompts

1. 複製 prompts/templates/phase-a.txt，替換 {{SOURCE_PORTAL}}、{{TARGET_CHANNEL}}、{{GOAL}}、{{CONSTRAINTS}}。
2. 貼進 grokboy agent 當本輪 user 訊息。
3. 審草稿後，再貼 Phase B（或直接在聊天寫「核准，請發佈以下草稿：…」）。

填好的範例見 prompts/examples/。

---

如何實例化新情境

填寫模板欄位即可，例如：

欄位	意義	範例
SOURCE_PORTAL	研究／取連結的站	affiliate.shopee.tw、某官網活動頁
TARGET_CHANNEL	發佈目標	Threads、FB、IG、X
GOAL	成功長相	高佣商品約 3 個、季節主題
CONSTRAINTS	額外限制	語氣、禁用詞、長度、必須含 #tag
LANGUAGE	草稿語言	繁體中文

步驟：複製 template → 填 placeholder → 存成 docs/scenarios/examples/<name>.md + prompts/examples/<name>-phase-{a,b}.txt → 用 agent 跑驗收。

---

失敗模式速查

現象	處置
Headless cookie 遺失	GROKBOY_BROWSER_HEADED=1
列表空轉	report_blocked；換篩選／關鍵字；勿重複同工具 ×3
未確認就發	產品失敗；AGENT_SYSTEM + request_user_confirm 擋
登入牆	只 handoff auth，完成後 Enter

---

範例索引

• 蝦皮聯盟 → Threads（範例）