少儿英语学员成长档案
使用场景
当用户提出以下任务时使用本 Skill：
- 咨询学生建档
- 试听测评
- 在读课后记录
- 每周跟进
- 月度学情文字总结（写入 student-record.json 与 03）
- 家长诉求与反馈（对话优先；必要时落档到 02）
每个学生都必须在本地拥有独立文件夹，统一存放在 ~/StudentGrowthOps/ 下。
本 Skill 依赖的文件
以下路径均相对于仓库根目录（包含 student-growth-ops/ 的那一层），不要使用本机仓库的绝对路径去读取或打开文件。
执行前先读取这些项目内文件：
- student-growth-ops/question-bank.json
- student-growth-ops/student-file-schema.json
- student-growth-ops/web/student-form.html
- student-growth-ops/server/index.js
- student-growth-ops/scripts/open_student_form.js
如果需要初始化学生目录，在仓库根目录下执行（使用相对路径）：
python "student-growth-ops/scripts/scaffold_student.py" --student-name "学生名" --grade "G3" --status "leads" --start-date "2026-04-15"
若本机中学员服务所在目录与仓库布局不一致，可在启动服务前设置环境变量 STUDENT_GROWTH_OPS_ROOT 指向包含 web/student-form.html 的 student-growth-ops 目录根路径。
强制规则
- 第一问必须先确认学生名称。
- 在进入任何阶段前，必须先根据学生名称检查是否已有学生档案。
- 如果已有学生档案，优先进入“跟踪/更新”流程，而不是重复建档。
- 如果没有学生档案，再进入“新建档案”流程。
- 先从用户自然语言里提取已经明确的学生信息和家长诉求。
- 已经明确的信息不要重复问。
- 先问一次填写方式，不要一开始就连续提问。
- 如果走对话填写，每轮只能问
1-2个问题。 - 对话问题必须来自
student-growth-ops/question-bank.json。 - 提问时既要给选项，也允许用户自然语言回答。
- 每确认一轮信息后就立即写入对应文件，不要等到最后一次性写入。
- 对话建档和网页建档，最终写入的学生档案文件必须完全使用同一套文件结构和字段语义。
- 不要创建额外的 Markdown 总结文档。
- 业务记录：系统数据为单个文件
_data/student-record.json（结构见student-file-schema.json）；老师可读层为02-家长需求.txt、03-课后跟进记录.txt。 - 给家长的沟通话术：当用户要的是「发给家长的一段话 / 微信 / 短信 / 课堂后简短反馈」等，在对话里直接输出完整文本即可，语气礼貌、温柔、有共情；除非用户明确要求落档，否则不要为此覆盖
02等文件。 - 回复用户时的展示规则：
- 不要在对话里贴出
student-record.json全文；用一句「系统数据已同步更新」即可。 - 若更新了
02、03，在收尾用本机绝对路径（纯文本）标出即可，不要用 Markdown 超链接或file://。
项目集成约束
这是当前项目 abcclaw 的集成版本，所有路径都以项目根目录下的 student-growth-ops/ 为准。
- 网页实现必须放在
student-growth-ops/目录内 - 页面启动、表单提交、生成文本文件的逻辑，已经在项目内实现
- 实际运行时，只需要启动已有页面服务并打开页面，不要重新生成网页代码
学生目录规则
学生根目录：
- ~/StudentGrowthOps/Leads/
- ~/StudentGrowthOps/Active/
- ~/StudentGrowthOps/RenewalWatch/
- ~/StudentGrowthOps/Archived/
学生目录命名：
- {grade}-{studentName}-{startDate}
- 示例：G3-Luna-2026-04-15
正式档案：双层保存（老师可读层 + 系统数据层）
老师可读（学员文件夹根目录）：
- 02-家长需求.txt：家长诉求与跟进摘要（纯文本）；即时发家长的话术默认只在对话里输出。
- 03-课后跟进记录.txt：学习情况与课后跟进要点（纯文本，按日期追加）
系统数据（_data/student-record.json）：
- 唯一结构化存档，字段分区见 student-growth-ops/student-file-schema.json。课次在 lessonLog.rows 中追加对象。
网页中间采集：
- ~/.openclaw/Workspace/student-growth-ops/form-submissions/*.txt 为网页提交后的中间文件（逐行 字段名：内容），需再合并进学员目录中的 student-record.json / 02 / 03。
工作流
1. 识别当前阶段
把用户需求映射到以下阶段之一：
- intake：咨询、报名、家长需求、回访优先级
- assessment：试听、测评、首诊反馈
- lesson-log：单次课后记录
- weekly-followup：一周汇总、提醒、纠正
- monthly-report：月度学情文字总结
- renewal-watch：续费相关沟通（写入 student-record.json 内 parentNeeds、tags）
2. 先提取，再提问
在提问前，先从用户原话中提取已知信息，优先提取：
- studentName
- grade
- status
- currentLevel
- primaryGoals
- painPoints
- sourceChannel
- parentNeeds
不要对这些已知字段重复追问。
3. 先确认学生名称，再检查是否已有档案
不管用户要做建档、学情更新还是跟踪记录，第一步都先确认学生名称。
执行顺序：
1. 先从自然语言中提取学生名称。
2. 如果学生名称还不明确，先只问一个问题：
- 请先告诉我学生姓名。
3. 拿到学生姓名后，先去 ~/StudentGrowthOps/ 下查找是否已有对应学生目录。
4. 如果查到已有学生目录：
- 视为已有档案
- 后续默认进入跟踪/更新流程
- 不要重复新建同名档案
5. 如果没有查到学生目录：
- 视为新学生
- 后续进入建档流程
- 必要时先运行脚手架创建学生目录
判断原则：
- 已有目录 = 跟踪记录 / 更新资料 / 继续补充
- 没有目录 = 新建档案 / 首次采集
4. 再问填写方式
正式采集前，先只问这一个问题（问的时候要把两种方式各自的优势说清楚，方便用户选）：
- 你想通过网页填写信息，还是通过对话一步步填写？
选项说明（给用户看的优势）：
- 网页填写：更快、更精准（选项与阶段题目集中展示，一次填完、预览清晰，适合在电脑前集中录入）。
- 对话填写：更方便（不用开浏览器，按轮回答即可；在微信等聊天场景里也能完成，适合碎片化时间）。
建议使用 AskQuestion 提供两个选项，标签或说明里可带上上述优势，例如：
- web：网页填写（更快、更精准）
- chat：对话填写（方便，微信也可以完成）
5. 如果用户选择网页填写
网页已经写在项目里的 student-growth-ops/ 目录下。
运行时要求：
1. 只负责启动已有页面服务。
2. 优先使用一键启动脚本：
- node "student-growth-ops/scripts/open_student_form.js"
3. 如果需要带参数启动，可以使用：
- node "student-growth-ops/scripts/open_student_form.js" --studentName=张三 --grade=G3 --status=active --stage=monthly-report
4. 如需单独启动服务，也可使用：
- node "student-growth-ops/server/index.js"
5. 启动后页面地址：
- http://127.0.0.1:8766/student-form
6. 若启动失败或页面异常，先确认本机 8766 是否已被其他进程占用，在终端执行：
- lsof -nP -iTCP:8766 -sTCP:LISTEN
再根据结果结束旧进程或改用环境变量 STUDENT_GROWTH_PORT 指定其他端口。
7. 不要在此时重新生成网页代码。
网页必须满足这些要求：
0. 输入学生姓名后，页面应调用 GET /api/lookup-student?name=...（由 student-growth-ops/server/index.js 提供），在 ~/StudentGrowthOps/ 下扫描各状态子目录中的学生文件夹，仅识别存在 _data/student-record.json 且其中 studentProfile.studentName 与输入一致的目录，并在页面顶部明确提示当前是「新建档案」还是「已找到档案 · 跟踪更新」，与「先问姓名、先查档」的流程一致。
1. 页面字段覆盖当前阶段所需内容。
2. 页面支持下拉选项和自由输入。
3. 页面有明确的 完成填写 按钮。
4. 点击 完成填写 后立即进入 loading 状态：
- 按钮禁用
- 展示 提交中... 或 生成中...
- 防止重复点击
5. 页面应优先保证用户体验：
- 自动保存草稿
- 重新打开后恢复草稿
- 展示“将要生成的文本预览”
- 提交成功后展示完整输出路径
- 支持一键打开提交目录
6. 提交成功后，在 OpenClaw 工作空间生成一个文本文件：
- ~/.openclaw/Workspace/student-growth-ops/form-submissions/
7. 文件名格式：
- {studentName}-{timestamp}.txt
8. 文件内容必须是逐行文本，格式示例：
- 名字：小明
- 年级：G3
- 学校：育才小学
- 当前英语基础：能跟读
- 家长诉求：提分, 口语表达
9. 文件中不要输出 Markdown、JSON、额外解释或无关标题。
10. 每一行都使用 字段名：内容 格式，供后续 AI 直接读取并合并进正式学生档案；不要把该 txt 当作最终存档。
11. 网页填写最终落地到学生档案时，必须和对话填写使用完全相同的文件集合：
- 老师可读层：02-家长需求.txt、03-课后跟进记录.txt
- 系统数据层：_data/student-record.json
12. 不允许网页填写走一套文件结构、对话填写走另一套文件结构。
网页模式下的交互规则：
1. 启动页面并告知用户页面已打开。
2. 告知用户点击 完成填写 后会在 OpenClaw 工作空间生成文本文件。
3. 等用户回复 填写完成。
4. 用户回复后，明确告诉他去这个路径找：
- ~/.openclaw/Workspace/student-growth-ops/form-submissions/
5. 然后读取该文本文件，再回写到学生档案文件中。
6. 如果用户选择对话填写
以 student-growth-ops/question-bank.json 作为唯一题库来源。
对话规则：
1. 每轮只问 1-2 个未完成字段。
2. 优先问当前阶段最关键、最缺失的字段。
3. 有稳定选项的问题优先用 AskQuestion。
4. 如果用户直接自然语言回答，要自动解析并映射到最接近的字段值。
5. 只有选项无法覆盖时，才补一个简短自由输入问题。
6. 每轮结束后先写入，再继续下一轮。
7. 对话填写最终落地的学生档案文件，必须和网页填写保持完全一致。
好的方式：
- 先识别出“G3、口语弱、家长想提分”
- 再只问一次填写方式
- 进入对话后每轮只问 1-2 个题库问题
错误方式：
- 一上来连续问完整一套问卷
- 用户已经说过的信息又被重复问一遍
7. 确保学生文件夹存在
如果学生文件夹不存在：
1. 根据状态选择正确的根目录。
2. 运行 scaffold_student.py 初始化。
3. 确认路径后再写入内容。
如果学生文件夹已存在：
1. 直接复用现有目录。
2. 原地更新文件。
3. 除非用户明确要求，不要为同一个学生重复创建新目录。
8. 按阶段写入正确文件
文件映射规则（系统数据均写入 _data/student-record.json 内对应键；老师可读层为根目录 02、03）：
- intake -> 更新 studentProfile、parentNeeds、tags；需要维护建档摘要时再更新 02-家长需求.txt（不是「发给家长的即时话术」的默认落点）
- assessment -> 更新 learningBaseline、tags
- lesson-log -> 向 lessonLog.rows 追加一行（对象字段与 lessonLog.columns 一致），并在 03-课后跟进记录.txt 记一条可读摘要
- weekly-followup -> 更新 weeklyFollowup、tags，必要时更新 03-课后跟进记录.txt
- monthly-report -> 更新 weeklyFollowup、tags，并在 03-课后跟进记录.txt 记可读摘要
- renewal-watch -> 更新 parentNeeds、tags；必要时将目录转入 RenewalWatch
写入规则：
- 旧值只有在新信息明确覆盖时才替换
- 数组字段去重
- 标签字段保持简短、可搜索
- 日期统一用 YYYY-MM-DD
- 小步确认，小步写入
- 网页填写和对话填写最终都必须写入同一批文件，不允许产生分叉结构
- 如果是已有学生目录，则本次操作默认是更新已有文件，而不是重新初始化整套文件
对用户的反馈方式
结束时只需要简洁说明：
- 学生目录用一句话给出本机绝对路径即可。
- 结构化数据：不要贴出 student-record.json 全文；用「系统数据已更新」之类概括即可。
- 02、03：若本次有更新，直接写出本机绝对路径（纯文本），不要用 Markdown 超链接或 file://。
- 如果是网页填写，中间采集目录写出 ~/.openclaw/Workspace/student-growth-ops/form-submissions/ 展开后的本机绝对路径（纯文本）。
- 若本次交付主要是家长沟通话术，说明话术已在对话中给出即可，不必强调写入了某个 txt 文件。
