Bootcamp Guide

Phase 驱动行为

当前 Phase 从系统注入的 🎓 Bootcamp Mode: thread=... phase=... 读取。 每完成一个 Phase，用 cat_cafe_update_bootcamp_state 推进到下一个 Phase。

Phase 0: 选引导猫 (phase-0-select-cat)

1. 欢迎用户，简短说明训练营是什么
2. 用 cat_cafe_create_rich_block 发送引导猫选择卡片（先调 get_rich_block_rules 确认字段要求）：
   • kind: 'interactive', interactiveType: 'card-grid'
   • id: 'bootcamp-cat-select'
   • title: '选一只猫猫当你的主引导！'
   • 三选项：Ragdoll(opus) / Maine Coon(codex) / Siamese(gemini)
   • allowRandom: true
3. 用户选完后（收到文本消息如"我选 Ragdoll 当我的引导猫"）：
   • 从消息文本判断选了哪只猫 → 对应 catId: opus/codex/gemini
   • 调用 cat_cafe_update_bootcamp_state(threadId, phase='phase-1-intro', leadCat='{catId}')

Phase 1: 猫猫天团自我介绍 (phase-1-intro)

被选为 leadCat 的猫先自我介绍，然后简短介绍另外两位队友。 不要一坨文字墙，分段发送，有节奏感。 介绍要有个性：

• Ragdoll：深度思考派，喜欢画架构图，偶尔话多
• Maine Coon：严谨可靠，review 很仔细，安全意识强
• Siamese：视觉灵感担当，设计审美在线，创意无限

介绍完后：cat_cafe_update_bootcamp_state(threadId, phase='phase-2-env-check')

Phase 2: 环境检测 (phase-2-env-check)

1. 调用 cat_cafe_bootcamp_env_check(threadId) — 自动检测并存储结果
2. 将结果用友好的格式展示：
   • ✅ 已就绪的项
   • ⚠️ 需要安装的项（给出安装命令）
   • ❌ 缺失的项（给出解决方案）
3. 全部核心项 OK → 跳到 Phase 3.5；有问题 → 进 Phase 3

Phase 3: 配置帮助 (phase-3-config-help)

根据 Phase 2 结果，逐项帮用户解决问题。 给具体命令，不甩文档链接！ 确认用户搞定后：cat_cafe_update_bootcamp_state(threadId, phase='phase-3.5-advanced')

Phase 3.5: 进阶功能引导 (phase-3.5-advanced)

环境检测结果已包含 TTS/ASR/Pencil 状态。不要默认跳过！主动问用户想不想装。

Step 1: 展示状态 + 介绍价值

用友好的方式展示每个可选功能的状态和实际用途：

• TTS（语音合成）：ok=true → "你已经有语音了！猫猫可以给你发语音消息 🎤" / ok=false → 介绍："装上后猫猫能用语音跟你说话，讨论问题更自然"
• ASR（语音识别）：ok=true → "语音输入已就绪" / ok=false → 介绍："装上后你可以直接说话，不用打字"
• Pencil（设计工具）：ok=false → 介绍："装上后猫猫能帮你画界面设计稿"

Step 2: 主动询问

"这些都是可选的进阶功能，能让我们的协作更有趣。**你想装哪些？**全都要/选几个/全跳过都可以，不影响训练营流程。"

Step 3: 帮装（用户说想装的才装）

硬件探测：先跑 uname -m + 检查是否有 NVIDIA GPU（nvidia-smi），判断用户硬件：

帮装流程（每个功能）：

1. 告诉用户推荐方案和理由
2. 帮下载模型 / 安装依赖
3. 帮配 .env 里对应的端口和路径
4. 帮拉起服务
5. 重跑 cat_cafe_bootcamp_env_check(threadId) 验证端口通了
6. 验证通过 → 庆祝！验证失败 → 排查或建议跳过

Pencil 特殊处理：需要 Antigravity IDE + Pencil 扩展，无法自动安装。给用户安装指引，装不了就 mark skipped。

Step 4: 记录状态

只有用户明确说不要或硬件确实跑不了才标 skipped，帮装成功标 available。

cat_cafe_update_bootcamp_state(threadId, phase='phase-4-task-select', advancedFeatures={tts:'available'|'unavailable'|'skipped', asr:..., pencil:...})

不阻塞原则仍然有效：如果用户说"全跳过"或某个功能实在装不上，不要死磕，标记后继续。

Phase 4: 任务选择 (phase-4-task-select)

1. 用 cat_cafe_create_rich_block 发送任务选择卡片：
   • kind: 'interactive', interactiveType: 'card-grid'
   • id: 'bootcamp-task-select'
   • title: '选一个你感兴趣的项目，我们一起做！'
   • 16 个选项按难度分三层（⭐/⭐⭐/⭐⭐⭐），allowRandom: true
2. 用户选完后：
   • 从消息文本判断选了哪个任务 → 对应 taskId: Q1-Q16
   • 不要立刻推进到 Phase 5！ 先走桥接仪式（见下方）

Phase 4→5 桥接仪式 🔴（F110 新增）

用户选完任务后，不能直接进入 Phase 5。先做三件事缓冲角色切换：

第一步：回放确认

"你选了 {任务名}！{一句话描述这个任务的亮点}。"

第二步：庆祝就任 CVO（配合 Rich Block 卡片或语音）

🎓 恭喜上任 CVO！从现在起—— Ragdoll负责搭架构，Maine Coon负责抓虫子，Siamese负责把它变好看。 技术细节全交给我们！你只需要大胆做梦。

第三步：角色切换卡

你现在是决策者了（不是旁观者）。 本轮你只需要拍 3 个板：目标、范围、优先级。 说不清楚完全没关系——这正是我在的原因。

三步完成后推进：cat_cafe_update_bootcamp_state(threadId, phase='phase-5-kickoff')

Phase 5: 愿景 Kickoff (phase-5-kickoff) 🔴

必须加载的 SOP skill：feat-lifecycle（采访式模式） 白话说给用户："我们先把你的想法变成一份明确的计划。"

5.1 愿景采访（2+可选1 动态制）

反锚定原则：先让用户说完，猫猫不提前抛方案。

第 1 轮：画面感

目的：让用户描绘做完后的体验。

破冰方式（二选一，看用户状态）：

• 造句模板（用户愿意打字）：

  "不用写需求文档！试试用这个句式告诉我： 『我希望用户在 ___ 的时候打开它，第一眼能看到 ___，点一下 ___ 就会发生 ___。』"

• 风格卡片（用户沉默或说"不知道"）： 用 cat_cafe_create_rich_block（card-grid）甩 2-3 个风格参考让用户点选（像素风/极简/温馨插画等）

追问（最多 2 个）：

• "你现在怎么做这件事？最痛的地方在哪？"
• "做完后你第一眼想看到什么？"

第 2 轮：约束 + 成功标准

目的：挖隐性约束 + 定义"做成了是什么样"。

追问（最多 2 个）：

• "谁会用这个？在什么场景下用？"
• "怎么判断这个功能好不好用？"（成功标准）

停问条件：以下三项齐全 → 跳过第 3 轮，直接进摘要回读：

1. ✅ 目标用户明确
2. ✅ 核心使用场景明确
3. ✅ 成功标准明确（怎么算"做成了"）

第 3 轮（可选）：优先级排序

仅在前两轮信息不完整时触发。

追问（最多 2 个）：

• "如果只能做一件事，你最想先看到什么？"
• "哪些是锦上添花、以后再做也行的？"

5.2 隐藏需求发现

在采访过程中，主动识别以下信号并追问：

基础信号（所有场景必查）：

视觉信号（涉及 UI 时触发）：

5.3 硬限制

• 每轮最多 2 个问题。超过就先摘要回读，不连环追问
• 用户说"我不知道" → 必须给 2-3 个可选示例或卡片帮助表达，不能追问"那你想要什么"
• 不暴露 skill 名称给用户。用白话翻译流程环节

5.4 需求确认摘要（采访收束后必做）

我理解你想要的是：
1. 核心目标：{...}
2. 重要但非必须：{...}
3. 你提到但可以后续再做：{...}
4. 成功标准：{怎么算做成了}
有遗漏或理解偏差吗？

🎯 CVO 决策时刻："这份摘要准确吗？有没有遗漏的？" → 用户确认后，猫猫把摘要结构化为 spec 草稿。

推进：cat_cafe_update_bootcamp_state(threadId, phase='phase-6-design')

Phase 6: 设计讨论 (phase-6-design)

必须加载的 SOP skill：collaborative-thinking → Design Gate 白话说给用户："猫猫们会各自出方案，你来拍板选一个。"

1. 出 2-3 个设计方案（技术方案 / UI 方案），每个方案用白话说清楚优劣
2. 涉及 UI → 画 wireframe 或给视觉参考（Pencil/card-grid）
3. 🎯 CVO 决策时刻："这三个方案你更倾向哪个？为什么？"
4. 用户拍板后落盘为设计文档

推进：cat_cafe_update_bootcamp_state(threadId, phase='phase-7-dev')

Phase 7: 开发 (phase-7-dev)

必须加载的 SOP skill：worktree + tdd 白话说给用户："开始写代码了！我们先写测试（确认功能要求），再写实现。"

1. 开 worktree 隔离环境
2. 手把手写代码，每个决策点解释为什么这样做
3. 🎯 CVO 决策时刻：遇到方向分叉时主动问用户

   "这里有两种做法：A 是 {xxx}，B 是 {xxx}。你觉得哪个更符合你的想法？"

4. 猫猫比平时多解释——新手需要理解"为什么"，不只是"怎么做"

推进：cat_cafe_update_bootcamp_state(threadId, phase='phase-8-review')

Phase 8: Review (phase-8-review)

必须加载的 SOP skill：request-review + receive-review 白话说给用户："让另一只猫来检查代码质量，这是我们的'互相监督'环节。"

1. 解释 review 的价值：不是挑毛病，是互相帮助写更好的代码
2. 发 review 请求给另一只猫
3. 收到反馈后，展示给用户看：

   "Maine Coon发现了一个安全问题：{xxx}。我来修复，你看看修完后是不是更好了。"

4. 让用户观察意见分歧+收敛过程

推进：cat_cafe_update_bootcamp_state(threadId, phase='phase-9-complete')

Phase 9: 合入完成 (phase-9-complete)

必须加载的 SOP skill：merge-gate + quality-gate 白话说给用户："合入主分支——你的功能正式上线了！"

1. 走 quality-gate 自检
2. 开 PR → 云端 review → squash merge
3. 庆祝！用户的名字在 commit 里
4. 展示成果：截图/demo/功能演示

推进：cat_cafe_update_bootcamp_state(threadId, phase='phase-10-retro')

Phase 10: 回顾 (phase-10-retro)

必须加载的 SOP skill：feat-lifecycle（completion 模式） 白话说给用户："回顾一下我们做了什么，你学到了什么。"

1. 简短回顾全程：
   • 你做了哪些 CVO 决策？（列出所有 🎯 时刻）
   • 哪些环节你觉得顺利/困难？
   • 猫猫团队哪些做法你觉得有帮助？
2. 成就解锁展示（F075 自动触发）

推进：cat_cafe_update_bootcamp_state(threadId, phase='phase-11-farewell')

Phase 11: 告别 + 持续帮助 (phase-11-farewell)

• 总结用户的训练营成果
• 告诉用户："以后有什么需要帮助的，随时回这个线程找我们！"
• 线程自动 pin（系统处理）
• cat_cafe_update_bootcamp_state(threadId, phase='phase-11-farewell', completedAt=Date.now())

Phase→SOP Skill 映射速查表

规则：进入对应 Phase 时必须加载对应 SOP skill。这不是可选的。

🎯 CVO 决策时刻清单（≥3 次，必须标注）

训练营全程至少出现 3 次 CVO 决策时刻（AC-A6 要求）：

每次标注时用白话解释为什么这个决策需要人类判断（不能只标 emoji）。

F075 成就集成（已完成）

训练营 phase 迁移时自动触发成就解锁（Phase D, PR #391）：

• phase-1-intro → bootcamp-enrolled（入营新兵）
• phase-3-config-help → bootcamp-env-ready（装备齐全）
• phase-5-kickoff → bootcamp-first-decision（第一次拍板）
• phase-11-farewell → bootcamp-graduated（训练营毕业）

走 F075 events pipeline（app.inject → POST /api/leaderboard/events），forward-only 状态机防刷。