108 lines
4.2 KiB
Markdown
108 lines
4.2 KiB
Markdown
# Scenario playbooks（情境劇本）— 可推廣的 LazyBoy 驗收模式
|
||
|
||
本目錄描述 **可重複套用** 的 acceptance playbook：把「研究來源 → 草稿 → 人工確認 → 發佈到目標頻道」做成固定兩階段流程。
|
||
**蝦皮聯盟 → Threads** 只是一個填好的範例，不是唯一路徑。
|
||
|
||
產品原語（讓所有情境可推廣）：
|
||
|
||
| 原語 | 用途 |
|
||
|------|------|
|
||
| `browser_handoff` | 僅用於登入／OTP／驗證碼牆 |
|
||
| `request_user_confirm` | 任何不可逆公開動作（發文、送出）前必須過關 |
|
||
| Phase A / Phase B | 研究+草稿 vs 確認後才發佈 |
|
||
|
||
相關：[`docs/SCENARIO-TEMPLATE.md`](../SCENARIO-TEMPLATE.md)、[`prompts/templates/`](../../prompts/templates/)、範例 [`examples/shopee-threads-affiliate.md`](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`，**不得**單方面發文。
|
||
|
||
---
|
||
|
||
## 環境與指令
|
||
|
||
```bash
|
||
export LAZYBOY_API_KEY=你的金鑰
|
||
export LAZYBOY_BROWSER_HEADED=1 # 強烈建議；否則 cookie／session 易丟
|
||
cd ~/LazyBoy
|
||
cargo run -p lazyboy -- agent
|
||
```
|
||
|
||
測試用：`LAZYBOY_CONFIRM_AUTO=1`（核准）／`abort`（拒絕）；亦可沿用 `LAZYBOY_HANDOFF_AUTO`。
|
||
|
||
### 如何貼 prompts
|
||
|
||
1. 複製 `prompts/templates/phase-a.txt`，替換 `{{SOURCE_PORTAL}}`、`{{TARGET_CHANNEL}}`、`{{GOAL}}`、`{{CONSTRAINTS}}`。
|
||
2. 貼進 `lazyboy 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 遺失 | `LAZYBOY_BROWSER_HEADED=1` |
|
||
| 列表空轉 | `report_blocked`；換篩選／關鍵字；勿重複同工具 ×3 |
|
||
| 未確認就發 | **產品失敗**；AGENT_SYSTEM + `request_user_confirm` 擋 |
|
||
| 登入牆 | 只 handoff auth，完成後 Enter |
|
||
|
||
---
|
||
|
||
## 範例索引
|
||
|
||
- [蝦皮聯盟 → Threads（範例）](examples/shopee-threads-affiliate.md)
|