edu-assess-funnel · AI 学情测评引流
> 本 Skill 由学页提供 —— 学页教培系统，打造属于您自己的在线教育平台 —— 私有化部署 · 100% 白标 · 一体化全链路 · 一次买断
把「扫码测评 → AI 答疑 → 留资 → 约试听」漏斗装进对话。基于 PRD v1.1（见 docs/PRD.md 摘要）实现。
0. 安装与初始化
- 本 Skill 安装到
~/.workbuddy/skills/edu-assess-funnel/（或项目.workbuddy/skills/）； - 机构首次使用时，为其创建机构工作区（默认
./<机构名>-workspace/），包含：
-data/kb.json（从templates/kb-template.json复制后对话引导填写）
-data/campaigns/（活动配置）
-out/（生成的测评页）
-downloads/（家长侧 submission 文件投放处）
-leads.xlsx（由 ingest 脚本自动创建） - 环境依赖：python3 + openpyxl（宿主默认环境已具备；缺失时提示
pip install openpyxl，装到宿主 venv，勿全局）。
1. 高频指令（5 个，覆盖 90% 日常）
| 用户说 | 动作 |
|---|---|
| 「建一个<学段><科目>测评活动」 | 走【流程 A】创建活动 |
| 「看漏斗 / 今天有哪些新线索」 | 运行 dashboard.py + 复述 S/A 级首触达清单 |
| 「给我 <级> 级线索的跟进话术」 | 走【流程 D】生成话术（必须过 §4 词检） |
| 「家长问的问题 AI 答不上来」 | 登记转人工待办（附上下文摘要） |
| 「家长要求删除信息」 | 走【流程 E】合规删除 |
长尾功能（导题目/复测/回收池/导出台账）不设记忆指令——在恰当时机主动提示（漏斗异常→建议补知识库；活动满 4 周→建议复测）。
2. 核心流程
流程 A：创建测评活动（PRD F-101）
- 问 3 个必填：科目、学段、渠道（引流位/活码给默认值可后改）；
- 从
assets/question-sets/匹配题组（内置：math-g6-entry / english-g5-entry / coding-intro-entry）；不匹配时提供最接近模板 + 引导自定义（流程 C）； - 生成活动配置
data/campaigns/camp-<date>-<n>.json（字段见data/campaign.example.json），机构信息从data/kb.json的org读取； - 运行：
bash python scripts/build_assessment.py --campaign <活动配置> --question-set assets/question-sets/<题组>.json --output <工作区>/out/assessment_<n>.html - 合规自检（发布前强制，F-606）：脚本内置生成期词检（命中即拒绝生成）；再人工确认 4 项：同意弹窗文案 / 留资字段=3 项 / 话术无违禁 / 活码为机构自有。任一不过 → 阻断并给整改指引；
- 把 HTML 放入机构「资料库」取得分享链接+二维码（资料库 Skill 上传即可），交付话术建议（朋友圈/地推各一版，同样过词检）。
流程 B：配置知识库（PRD F-201 分级启用）
- 从
templates/kb-template.json复制到<工作区>/data/kb.json； - 启用 AI 咨询官的最低门槛：courses / pricing / trial_rules 三类至少各 1 条真实非空记录；schedule / teachers / faq 可后补（未配置类目相关提问 → 一律转人工，不编造）；
- 校验方式：读 kb.json，三类为空模板（含"（"占位）即视为未填。
流程 C：自定义题目（PRD F-103）
- 引导粘贴或上传题目（格式：题干/选项/答案序号/维度/解析），落
assets/question-sets/custom-*.json（schema 参照内置题组）； - 逐题校验：答案序号 0-3、维度在 dimensions 内；非法行报行号不整批失败。
流程 D：跟进话术生成（PRD F-403）
- 读 leads.xlsx 定位线索（含 dim_scores 弱项）；
- 生成微信版+电话版各 1 条：先共情引用报告薄弱点 → 给建议 → 单 CTA（约试听）；
- 输出前必过 §4 词检；命中即改写再检，直至 0 命中；
- 附「首触达时效」提示：在线时段内 15 分钟跟进（成交概率 ×4 依据）。
流程 E：合规删除/更正（PRD F-605 人工流程）
- 家长请求（任意渠道到达）→ 在对话中定位线索（提供掩码手机号后 4 位+年级）；
- 执行：台账该行 parent_name/phone_masked/grade 置空、phone_hash 置
DELETED-<ts>、status 不变（保统计口径），changelog 追加gdpr_delete； - 回执：告知已删除+时间戳；若 15 个工作日时限紧张，提醒校长优先处理。
流程 F：线索落库与首触达（PRD F-301~304/401）
家长在测评页的操作会导出 submission_*.json（机构侧收进 <工作区>/downloads/）。用户说「收线索 / 落台账」或每日首次对话时：
python scripts/ingest_leads.py --workspace <工作区>
- 输出新进 S/A 级清单 → 立即提醒首触达（15 分钟）；
- 每日建议跑一次（可用 automations 定时）。
3. AI 咨询官行为规范（对话内承接，F-202~210）
当用户请 Skill 扮演/生成咨询回复时，必须遵守：
- 先答后引：完整回答问题后，仅附 1 个 CTA（留资/约试听/加企微）；连续 2 轮未响应 CTA → 转纯答疑；禁止开场即推企微；
- 知识库优先：仅基于
data/kb.json已填类目作答；未填类目（如师资未配置）→「这个问题我需要请老师回复您」+ 登记转人工待办； - 报告上下文：家长来自测评页时，先关联其维度得分再展开（如「运算 82 是相对强项，问题解决 58 偏弱」）；
- AI 身份明示：首条回复表明「我是<机构名>的 AI 助教，真话实说」；
- 游客承接：未留资家长问试听 → 给免电话预约（核销码）或活码出口，不催留资；
- 效果类问题用固定兜底：不承诺提分，讲「测评定位→试听诊断→阶段反馈」的可验证动作。
4. 违禁词检（广告法 24 条红线，所有对外输出强制）
对报告文案、话术、咨询回复、朋友圈物料执行正则词检（与 build_assessment.py BANNED_PATTERNS 一致）：
- 禁：保证/承诺/签约 + 提分|通过|考上|学会；保过|包过|包会
- 禁：命题|阅卷|考官 + 人员 + 授课|亲授|参与
- 禁：学霸|状元|成功学员 + 案例|证明|推荐
- 禁：最快提分、第一提分、顶级名师、最强师资
- 替代表达库：「保证提分」→「阶段复测看得见变化」；「包过」→「入学测评定位薄弱点+定期反馈」
5. 数据与合规约定
- 手机号仅存 SHA-256 哈希+掩码，明文不落任何文件；导出台账默认脱敏；
- 监护人同意是留资前置；游客事件不含个人信息；
- leads.xlsx 表头与 edu-sales-crm 兼容（lead_id/level/status/channel/owner…），可互导；
- 状态机：new→nurturing→trial_booked→attended→won | lost（必填原因）；对话中改状态时同步 changelog。
6. 快速演示（安装后自检）
# 1) 生成演示活动页
python scripts/build_assessment.py --campaign data/campaign.example.json \
--question-set assets/question-sets/math-g6-entry.json --output sample-workspace/out/assessment_math.html
# 2) 模拟家长留资（样例 submission 已备）
python scripts/ingest_leads.py --workspace sample-workspace --file sample-workspace/downloads/submission_demo_lead.json
# 3) 出看板
python scripts/dashboard.py --workspace sample-workspace
预期：浏览器打开测评页可完整走「同意→答题→报告→留资」；ingest 输出 S/A 级提醒；dashboard.html 出八级漏斗。
7. 边界（V1 不做）
在线支付、真人 IM、多校区权限、企微 API 集成、正式心理测评、与特定 SaaS 双向同步。
