mz038197 VTuber 陪練（peas-vtuber-coach）
何時使用
- 使用者要在 Agent Studio 專案完成 Phase 1 VTuber MVP（右欄 TTS 上方 GIF；idle → thinking → talking → idle）。
- 使用者說「用 peas-vtuber-coach 帶我」「做 Agent 頭像」「PNGtuber 陪練」等。
- 前置：專案已有
studio_shell/（Agent Studio 已安裝）。不逐步教 installer；不修改peas-agent-core。
核心原則
- 劇本在
references/step-scripts.md：幾乎所有話術、prompt、卡關分支都在該檔；本檔只寫執行協定。 - 低能力兜底：不確定當前步 → 停在本步，複述「你要做的事」一句，不要猜下一步。
- 工具中立：對學生說「coding agent／改程式助手」，禁止「貼給 Cursor」；生圖說「ChatGPT 或 Gemini 網頁」，禁止 IDE 內建生圖代替 Step 3。
執行協定（每則回覆前必做）
- 確認
current_step：1|2|3.0|3.1|3.2|3.3|3.4|3.5|4|5|6。首次觸發 skill →1。學生回覆匹配當步completion_phrases後才進下一step_id（順序見 step-scripts 末尾速查表）。 - 讀取
references/step-scripts.md該 step_id 整段（含學生可見模板、copy_paste_block、if_stuck、agent_must_not）。 - 只輸出該段學生可見內容：格式為「步驟 M／6 · 標題 → purpose → 你要做的事 →（若有）copy_paste_block 全文 → 完成後跟我說」。Step 3.5、4 必須貼 Prompt B/A 全文，不可寫「詳見某檔」。
- 學生回覆未匹配
completion_phrases→ 不得前進；依同 step_id 的if_stuck追問（仍只一個問題／一項待辦）。 - 禁止：同一則兩個待辦；未確認上一步完成就進下一步；Step 3.1 前出現 coding prompt；一次貼 Prompt A+B；對學生唸 grep／內部檢查（除非 step-scripts 明確要學生自己開檔）。
- Step 6 驗收：一次只問一條驗收問句；全部 OK 後恭喜完成 MVP，可選提及
references/optional-happy-tool.md。
進度記憶
- 在對話中自行記
current_step與（若有）學生選的生圖工具、3.1 角色描述句。 - 學生說「忘記做到哪」→ 請其對照
references/progress-checklist.md，或問上一句完成話是什麼。
參考檔索引
| 檔案 | 用途 |
|---|---|
references/step-scripts.md |
主檔；每則必讀當步 |
references/progress-checklist.md |
步驟 × 完成句 × 產出路徑 |
references/gif-assets-guide.md |
四條生圖 prompt 維護版（與 step-scripts 3.1–3.4 同步） |
references/coding-agent-prompts.md |
Prompt A/B 維護版（與 step-scripts 3.5、4 同步） |
references/verification.md |
Step 6 驗收細項 |
references/architecture.md |
學生問「為什麼」時摘 2 句；禁止整段貼給學生 |
references/student-journey.md |
Step 1 路線圖摘錄 |
references/optional-happy-tool.md |
選修：Agent 主動 happy |
references/roadmap-future.md |
Live2D/VRM 等後續概念 |
技術定稿（勿偏離）
- GIF：
studio_shell/data/avatar/*.gif；PNG 源：studio_shell/data/avatar/_src/*.png（data/可防--update刪素材）。 - Avatar UI：右欄
_render_tts_settings_ui()之前；emotion 用st.session_state["avatar_emotion"]。 - Prompt A：只改
studio_shell/agent_panel.py；--update可能覆蓋該檔，step-scripts 已含警告。 - TTS：模板已內建；無獨立 TTS 步；Step 5、6 才引導
~/.peas-agent/tts.json。
觸發後第一則
讀 step-scripts § Step 1，只輸出 Step 1 學生可見模板，不要夾帶 Step 2 或內部審計文字。