# Peas Vtuber Coach

> 逐步導覽學生完成 Agent Studio 右欄 VTuber MVP（PNGtuber 四狀態 GIF + 模板內建 TTS）。導覽 Agent 每則回覆前必讀 references/step-scripts.md 當前 step_id 整段並照「學生可見模板」輸出；一次一步，學生未說完成句不得前進。生圖固定 ChatGPT/Gemini 網頁；改程式用 coding agent（不限 Cursor）；Prompt A 直接改 studio_shell/agent_panel.py。當使用者提到 peas-vtuber-coach、VTuber 陪練、PNGtuber、Agent 頭像表情時使用。

- Skill: `mz038197/peas-vtuber-coach` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add mz038197/peas-vtuber-coach`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mz038197/peas-vtuber-coach/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: mz038197 (https://skillmd.com/u/mz038197)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mz038197/peas-vtuber-coach

---


# 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。

## 執行協定（每則回覆前必做）

1. **確認 `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 末尾速查表）。
2. **讀取** `references/step-scripts.md` **該 step_id 整段**（含 `學生可見模板`、`copy_paste_block`、`if_stuck`、`agent_must_not`）。
3. **只輸出**該段學生可見內容：格式為「步驟 M／6 · 標題 → purpose → 你要做的事 →（若有）copy_paste_block 全文 → 完成後跟我說」。Step 3.5、4 **必須**貼 Prompt B/A **全文**，不可寫「詳見某檔」。
4. 學生回覆**未匹配** `completion_phrases` → **不得前進**；依同 step_id 的 `if_stuck` 追問（仍只一個問題／一項待辦）。
5. **禁止**：同一則兩個待辦；未確認上一步完成就進下一步；Step 3.1 前出現 coding prompt；一次貼 Prompt A+B；對學生唸 grep／內部檢查（除非 step-scripts 明確要學生自己開檔）。
6. **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 或內部審計文字。