试听课转化助手（Trial Class Conversion Copilot）

功能概述

面向国内中小教培机构（5–30 人团队）的对话式试听课转化助手：
把「线索登记 → 邀约排期 → 到场/爽约 → 黄金窗口回访 → 报名/流失/培育」全流程漏斗、
跟进 SOP 和合规话术生成装进 WorkBuddy，机构零部署、说一句话就能用。

解决什么问题：试听→报名转化率行业平均 20–35%（小机构常停 13–18%）；48h 内首轮回访转化概率高 1.7 倍；
自动化 SOP 跟进执行率 25%→96%。本 Skill 把这些方法论直接变成待办和话术，同时内置广告法/预收费/微信规范三重合规拦截，让顾问敢开口、机构不踩线。

与 edu-sales-crm 的分工：edu-sales-crm 管全线索生命周期（通用 CRM）；本 Skill 只管进入试听场景后的垂直深挖（试听专场、试听前中后 SOP、黄金窗口、转化归因）。用户要"通用线索管理"走 edu-sales-crm，要"试听转化一条龙"走本 Skill。

使用前提

快速开始

1. 初始化机构（首次必做，1 条命令完成）：
   bash python scripts/funnel_cli.py --data-dir "<数据目录>" init --name "XX教育" --consultant "李顾问,王顾问" --campus "番禺校区,天河校区"
2. 配置课程：
   bash python scripts/funnel_cli.py --data-dir "<数据目录>" course add --name "数学思维" --subject 数学 --price 4800 --lessons 20 --months 3
3. 登记一个线索，然后直接对话推进（详见「使用手册」）：
   > 用户：登记个线索：小明 7岁 想试数学思维，王女士 13812345678，美团来的
4. 想快速体验全流程？运行 demo 子命令一键生成演示数据（5 线索 + 4 试听），再演示登记/待办/看板。

使用手册

核心功能与操作示例

功能1：机构初始化与课程配置

• 触发方式：用户输入"配置机构 / 初始化 / 加个课程 / 配置课程"或类似表达
• 操作示例：
  > 用户：配置机构：XX教育，顾问李老师、王老师，校区番禺和天河
  > 技能：执行机构初始化，返回机构 ID、校区与顾问清单；提示"已配置 2 位顾问、2 个校区，下一步建议配置课程"
  >
  > 用户：加个课程：数学思维，4800 元 20 课时，3 个月
  > 技能：写入课程配置，返回课程名/科目/价格/课时/月数确认
• 注意事项：课程价格应 ≤5000 元（超过将无法通过后续报名校验）；--consultant/--campus 支持逗号分隔多个值

功能2：线索一句话登记（电话自动去重）

• 触发方式：用户输入"登记个线索 / 来了个家长 / 记一下"等
• 操作示例：
  > 用户：登记个线索：小明 7岁 想试数学思维，王女士 13812345678，美团来的
  > 技能：写入线索并返回线索 ID；若该电话已存在，提示"该电话已登记（线索 LD-xxx），已合并不重复创建"，并显示原有记录供确认
• 注意事项：建议同时补充来源（美团/地推/转介绍/公众号等）与痛点（如"计算弱"），痛点会在话术中自动复用

功能3：试听排期、改期与日程查询

• 触发方式：用户输入"约试听 / 约周六上午10点 / 改期到周日 / 今天有什么试听"
• 操作示例：
  > 用户：约周六上午10点试听数学思维
  > 技能：执行排期，返回试听 ID、时间、课程、校区；并提示课前 24h/2h 会自动生成提醒待办
  >
  > 用户：今天有什么试听
  > 技能：列出今日/近 7 天试听日程（时间、学员、课程、状态）
• 注意事项：改期会保留原排期记录（可追溯）；爽约后可二次改期重新邀约

功能4：到场/爽约登记（自动生成黄金窗口 SOP）

• 触发方式：用户输入"小明到场了吗 / 登记到场 / 小华没来"
• 操作示例：
  > 用户：小明到场了
  > 技能：登记到场，并自动生成黄金窗口跟进时间轴：T+2h 课后感谢、T+24h 资料触达、T+72h 进步对比、T+120h 促单窗口、T+168h 转培育池建议
  >
  > 用户：小华没来
  > 技能：登记爽约，记录原因；生成 T+24h 二次邀约待办
• 注意事项：未到场不可直接报名（状态机守卫会拦截并引导先登记到场）

功能5：报名 / 流失 / 转培育登记（合规拦截）

• 触发方式：用户输入"报名了 / 4800 20课时 / 不报了因为价格 / 转到培育池"
• 操作示例：
  > 用户：小明报名了，4800，数学思维20课时
  > 技能：校验金额 ≤5000 元 / 课时 ≤60 / 期限 ≤3 个月后登记报名；提示可衔接 edu-sales-crm 学员库 / order-recon 对账
  >
  > 用户：小明不报了，因为价格
  > 技能：登记流失（原因必填）；如缺原因会拦截并列出可选原因（价格/时间/距离/效果/竞品/其他）
• 注意事项：单笔收费 >¥5000 或 >60 课时或 >3 个月会被直接拒绝并说明政策依据（预收费监管红线）

功能6：话术生成（7 大场景 + 强制合规检查）

• 触发方式：用户输入"给王女士写条课后回访 / 写个邀约话术 / 促单话术 / 这个话术合规吗"
• 操作示例：
  > 用户：给王女士写条课后回访话术
  > 技能：按课后感谢模板代入孩子名/课程生成草稿，自动执行合规检查后输出（标注场景名，如 话术：post_trial_thanks），并提示"请由您人工发送"
  >
  > 用户：帮我写个"保证孩子一个月提分20分，不达标退款"的招生话术
  > 技能：合规检查拦截该话术（广告法禁止保证性承诺），给出改写建议后输出合规版本
• 注意事项：话术合规检查不可关闭；违规内容必须改写而非绕过；涉裂变/转发有奖/拼团类内容会提示微信外链规范，改为一对一私聊触达

功能7：跟进待办（SOP 督导）

• 触发方式：用户输入"生成今天/本周的跟进待办 / 我今天该干嘛"
• 操作示例：
  > 用户：生成今天的跟进待办
  > 技能：列出今日待办清单：🔴 逾期 / ✅ 今日 / 🕐 即将，每条注明学员、动作（如"T+2h 课后感谢"）、对应话术场景名
• 注意事项：待办由引擎按到场时刻/试听时间自动计算，无需手动维护；逾期项标红提醒

功能8：漏斗看板与流失归因（校长复盘）

• 触发方式：用户输入"本月试听转化怎么样 / 看漏斗 / 哪个环节漏最多"
• 操作示例：
  > 用户：本月试听转化怎么样
  > 技能：输出近 30 天试听转化漏斗（线索→排期→到场→回访→报名 各环节数量与转化率、环比），并给出环节损耗诊断（如"确认→到场 损耗 30%，爽约偏高，建议加强课前 24h/2h 提醒"）
• 注意事项：流失/爽约记录按"曾到达环节"计入漏斗，口径与行业基准一致，不会虚高

功能9：数据导出

• 触发方式：用户输入"导出数据 / 把线索导出来"
• 操作示例：
  > 用户：导出试听数据成 Excel 能用的格式
  > 技能：导出 CSV（线索/试听/流失明细），并生成 Markdown 汇总
• 注意事项：CSV 用 UTF-8 编码，Excel 打开若乱码请用"数据→从文本/CSV"导入

数据说明

数据以纯 JSON 文件存储于数据目录（默认 {工作区}/.workbuddy/trial-class-converter/）：

隐私：只收集家长姓名/电话/孩子信息/意向/来源/痛点，不采集证件号、住址等敏感信息；用户要求删除某家长数据时立即删除关联记录并留痕告知。

常见问题

Q：安装后无法使用 / 命令报错？
A：确认运行环境有 Python 3.8+；首次使用必须先执行 init 初始化。命令报"找不到数据目录"说明未初始化或 --data-dir 指向错误，按提示初始化即可。

Q：需要配置微信/短信等连接器吗？
A：不需要。本技能不自动外发任何消息，所有话术生成草稿由人工发送，这是设计边界（合规红线），不会改变。

Q：数据存在哪里？会不会丢？
A：数据存本地 JSON 文件（非云端），随工作区保留；引擎原子写入保证单文件不损坏。跨设备使用需拷贝数据目录。

Q：看板没有数据 / 数量不对？
A：看板统计近 N 天创建线索（默认 30 天）；确认登记线索时的时间在统计窗口内。数量口径与行业基准一致（流失/爽约计入曾到达环节），不会虚高。

Q：误操作了能撤销吗？
A：终态记录（报名/流失）24h 内支持 rollback（需二次确认）；其余状态可自由流转。数据文件损坏时查 audit.log 定位最后成功操作。

Q：报名金额超过 5000 元被拦截了？
A：这是预收费监管红线（单笔 ≤5000 元 / 60 课时 / 3 个月），不可绕过。如需收更高金额应拆分为多期合同，建议衔接 ar-collector 走"先学后付"模式。

技能指令（开发者参考）

意图路由表（自然语言 → 命令）

登记线索前必做：先用 lead find --phone <电话> 查重（引擎在 add 时也会幂等拦截，返回合并提示）。

话术生成工作流（M2 核心，每次必走完）

1. 选模板：按场景读取 references/scripts-library.md（邀约/课前提醒/到场引导/课后感谢/资料触达/促单/培育唤醒 + 爽约二次邀约等附加场景）。
2. 个性化：代入真实变量（孩子名/课程/时间/地点）；若记录里有痛点标签（pain_points），
   用痛点驱动生成（"您提到孩子计算容易粗心，这场体验课正好围绕这个设计……"）。
3. 合规检查（强制，不可跳过）：
   bash python scripts/funnel_cli.py --data-dir "$DATA_DIR" compliance check --text "<完整话术>"
   - ✅ 通过 → 输出草稿（标注场景名，如 话术：post_trial_thanks）。
   - ⚠️ 拦截 → 按 references/compliance-rules.md 的改写指引修正 → 重跑直到通过。
   - 涉及金额的报名登记 → trial sign 引擎自动校验预收费红线（≤5000 元/60课时/3个月）。
4. 输出要求：话术以代码块/引用块给出，方便复制；由用户人工发送，绝不自动外发。
5. 若用户提到裂变/转发有奖/拼团 → 按微信规范提示，改为一对一私聊触达。

SOP 督导（黄金窗口时间轴）

引擎在 trial checkin（到场）后自动按到场时刻生成时间轴（F-301）：

T+2h   课后感谢 + 课堂照片（48h 首轮回访，转化概率 +1.7 倍）
T+24h  课程资料触达
T+72h  学员进步对比
T+120h 促单窗口（合规版）
T+168h 未转化 → 转培育池建议

• 课前提醒：CONFIRMED 状态自动在试听前 24h / 2h 出现在待办。
• 待办生成：todo --days 3 → 逾期项标红（🔴 逾期 / ✅ 今日 / 🕐 即将），每条含话术场景名。
• 爽约后 T+24h 自动出现二次邀约任务。

边界红线（硬约束，不可关闭）

1. 不自动外发消息：微信/短信触达一律生成草稿由人发送；不接微信 API、不做自动外呼。
2. 合规检查不可关闭：所有话术（含用户自制）生成后强制过词库检查；拦截必须改写而非绕过。
3. 预收费拦截不可绕过：一次性收费 >¥5000 或 >60 课时或 >3 个月 → trial sign 直接拒绝并说明政策依据。
4. 流失原因必填：trial lose 不带原因 → 拦截并列出可选原因。
5. 状态机守卫：未到场不可报名、终态不可乱改（24h 内可 rollback，需二次确认）。
6. 隐私最小化：只收集家长姓名/电话/孩子信息/意向/来源/痛点；不采集证件号、住址等敏感信息；
   用户要求删除某家长数据时立即删除关联记录并留痕告知。

角色视图

• 校长：dashboard 看漏斗与损耗诊断、流失归因；问"本月转化怎么样/哪个环节漏最多"。
• 课程顾问：lead add / trial schedule / 话术生成 / todo 待办；登记后引导补痛点，生成邀约话术。
• 教务/班主任：trial list 看日程、trial checkin / noshow 登记到场、课后衔接提醒。
• 同一会话中用户说"我是校长/顾问/教务"即切换侧重，数据不隔离（小机构共享工作区）。

与已有 Skill 的衔接

资源索引