# V1 功能设计流程 v0.1 日期:2026-10-01 目标:**在写正式代码之前,先让孩子用上可操作的原型**,避免实现完成后才发现不好用、大量返工。 原则:先验证「孩子用不用得来、愿不愿意用」,再做课程解析和正式开发。课程解析(原 V0-6)推迟到孩子试用通过之后。 --- ## 1. 流程总览(5 步,4 个家长参与点) ``` S1 流程与页面草图 ──► 【G1 家长确认】约 30 分钟 │ S2 可操作体验原型(2 天真实内容)──► 【G2 家长先走一遍】约 20 分钟 │ S3 孩子试用 2 天(家长按观察表记录)──► 【G3 试用复盘】约 30 分钟 │ 不通过 → 回到 S1/S2 修改,再试 1 天 ▼ S4 正式功能规格 + openspec change 草案 ──► 【G4 家长确认范围】约 20 分钟 │ S5 交给其他 agent 实现 → V1 试用 2 周(同一份观察表做验收) ``` | 步骤 | 谁做 | 产出 | 预计 | |---|---|---|---| | S1 | Claude | `tasks/pipeline/v1-two-cards/20-product.md`:用户流程、页面清单、每页草图(文字线框)、关键文案、要验证的假设 | 1 次对话 | | **G1** | **家长** | 在文档里勾选或批注:步骤顺序、每步说什么话、哪里太多或太少 | 约 30 分钟 | | S2 | Claude | `tasks/pipeline/v1-two-cards/prototype/`:iPad 上能真实操作的网页原型。内容是**手工准备的 2 天**(不做课程解析),用真实视频、动画、绘本图片和音频 | 1—2 次对话 | | **G2** | **家长** | 自己在 iPad 上完整走一遍孩子端和家长端,记下要改的地方 → Claude 改一轮 | 约 20 分钟 | | **S3** | **家长 + 孩子** | 孩子连续用 2 天;家长按观察表(第 3 节)记录;原型自动记录每一步用时、点击和录音 | 每天约 5 分钟记录 | | **G3** | **家长 + Claude** | 对照第 2 节的假设逐条判断:成立 / 不成立 / 需要调整 → 修改设计。不通过的部分改完再试 1 天 | 约 30 分钟 | | S4 | Claude | 正式功能规格:页面规格、状态、数据、接口、对现有代码的复用和修改清单、验收用例;openspec change 草案(供其他 agent 实现) | 1—2 次对话 | | **G4** | **家长** | 确认 V1 范围;之后新想法一律进 ROADMAP 停车场 | 约 20 分钟 | ## 2. 原型试用要验证的假设 这些是设计中「拍脑袋」的部分,试用后才能确定。每一条都写明看什么、怎样算通过: | # | 假设 | 观察什么 | 通过标准 | 不通过时怎么改 | |---|---|---|---|---| | H1 | 孩子能**自己开始**,看懂今天要做什么 | 打开后多久点进第一张卡;是否需要大人解释 | 2 天中至少 1 天完全自己开始 | 加强语音说明、减少首页元素 | | H2 | 卡内**步骤数和时长**合适(每张卡约 15—20 分钟) | 每步用时、在哪一步离开 | 2 天都能完成两张卡 | 拆短步骤、合并步骤 | | H3 | 「先看目标 → 看视频 → 找回来」能让她**记住重点** | 找回来的正确率;家长晚上问时能否说出 | 当晚能说出 3 个重点里至少 2 个 | 换预告形式、视频中途插入暂停提问 | | H4 | 孩子**愿意录音**(读、答、复述) | 录了几次、有没有拒绝或敷衍 | 每张卡至少录 1 次 | 改为「读给奶奶听」等线下方式;或做成游戏 | | H5 | 精读的「读前 / 读后两次录音」**有可见差别**,能给她成就感 | 家长对比两次录音;孩子听回放的反应 | 家长能听出区别,孩子愿意听回放 | 改为只录读后一次,或改成跟读打分 | | H6 | 纸质步骤(练习册、抄写 4 遍)能在 App 引导下**自己完成** | 是否需要提醒才去拿本子;写完是否回到 App | 能自己完成并点「写好了」 | 把纸面任务拆到亲子时间 | | H7 | 20 分钟休息页**不打断兴致**,休息后能回来 | 休息后是否自己回来继续 | 能回来 | 调整为步骤之间才提示,或延长到 25 分钟 | | H8 | **单词卡奖励**有吸引力 | 是否主动看收集的卡、是否期待周日手工 | 主动提起或去看 | 换成其他激励 | | H9 | **家长端 + 亲子卡**能在 15 分钟内完成检查,并且有用 | 家长计时;亲子卡问题是否合适 | ≤ 15 分钟,且至少 1 个问题发现了真实问题 | 精简报告、改问题 | ## 3. 家长观察表(S3 每天填一次,约 5 分钟) | 项目 | 第 1 天 | 第 2 天 | |---|---|---| | 是否自己开始(是 / 提醒后 / 需要大人帮) | | | | 卡在哪一步、怎么卡的 | | | | 有没有拒绝或敷衍的步骤 | | | | 录音情况(愿意 / 害羞 / 拒绝) | | | | 纸面任务(自己完成 / 提醒后 / 没做) | | | | 休息后是否回来 | | | | 情绪:开心的地方 | | | | 情绪:烦躁的地方 | | | | 晚上问 3 个重点,能说出几个 | | | | 你看报告 + 做亲子卡用了几分钟 | | | | 你最想改的一处 | | | 原型会自动记录每步用时、点击、录音和找回来的答案。家长端有一页「试用记录」,可以直接导出给 Claude 做复盘。 ## 4. 原型的范围和做法 - **是什么**:独立的静态网页(HTML + JS),不接后端,部署在 nginx 的 `/estudy-proto/`,在 iPad Safari 上运行。代码不进入正式实现,**只用来验证体验**。 - **内容(手工准备,不做课程解析)**: - Power Up:孩子下一课 **Day 9(课本 / 练习册 p20—21)**,拆成新课日和练习日两天。用 AJ 讲解视频(nginx 上已有)+ 对应动画 + 规划表里的重点词句。 - 绘本:Stage 3 两本书(家长指定),做精读巩固;文字、图片、音频都已经有。 - **数据**:试用记录和录音存在 iPad 本地(IndexedDB),家长端可以回放、导出。 - **录音的前提**:iPad Safari 只有在 HTTPS 下才允许录音。建议在 S2 之前先完成 V0-4(局域网 HTTPS,约 1 个晚上);否则原型里的录音步骤只能改为「大声读给奶奶听」,H4、H5 就验证不了。 - **不做**:后端、计划生成、课程解析、Agent 建议、复习算法。这些不影响孩子的体验判断。 ## 5. 对路线图的调整 - V0-6(规划表提取)推迟到 G3 之后,在 S4 中按试用结论再做。 - 新增「设计验证」阶段 D1—D5(对应 S1—S4 和 G1—G4),排在 V1 开发之前。 - 已有的 V0-1~V0-3(归档和冻结 change)可以交给其他 agent 同时进行,不影响设计。