| name | study-roadmap-generator |
| description | 根据用户输入的学习目标、当前水平和可用时间，自动生成结构化的学习路线图 — 包含阶段划分、每周计划、推荐资源、高频卡点和每日节奏建议。用户在说出"帮我做学习计划"、"制定学习路线"、"一周学会XX"、"XX学习路线图"等请求时激活。 |
Study Roadmap Generator
将模糊的"我想学 X"转化为可执行的学习路线图（Learning Roadmap）。六段式布局：学习者画像 → 成功标准 → 阶段计划 → 推荐学习栈 → 常见卡点 → 动态调整说明。
工作流程
1. 收集输入
从用户对话中提取三个必要参数和一个可选参数：
| 参数 | 说明 | 获取方式 |
|---|
| 学习目标 | 想学什么 + 学到什么程度 | "两周学会 SQL 找暑期实习" |
| 当前水平 | 零基础 / 有基础 / 考试冲刺 | 直接询问或根据关键词推断 |
| 时间约束 | 总时长 + 每天可用时间 | "三周，每天两小时" |
| 目标方向（可选） | 后端开发 / 数据分析 / 通用 | 影响阶段侧重和资源选择 |
2. 水平判断
| 输入信号 | 推断结果 |
|---|
| "完全不会"、"零基础"、"没接触过" | 零基础 |
| "会一点"、"用过"、"有XX基础" | 有基础 |
| "考试"、"考前"、"冲刺"、"考研" | 考试冲刺 |
3. 路线生成逻辑
阶段划分（以总天数 T 为基准）
| 阶段 | 占比 | 说明 |
|---|
| 基础 | 15% | 环境搭建、核心概念、首次可验证输出 |
| 核心 | 35% | 核心语法、数据结构、基本操作 |
| 进阶 | 35% | 目标领域的关键能力 |
| 综合 | 15% | 项目整合、查漏补缺 |
每个阶段后插入一个缓冲日（最后阶段除外）。
路线风格
| 风格 | 适用场景 | 侧重 |
|---|
| 实战 | 求职 / 项目 / 实用技能 | 动手驱动、最小可用、技能输出 |
| 学术 | 系统学习 / 考试 / 理论 | 概念理解、教材导向、渐进练习 |
| 考试 | 考前冲刺 / 认证 | 真题驱动、高频考点、题海战术 |
4. 输出结构
学习路线图 — {目标}
学习者画像
属性 值
─── ────
当前水平 {level}
学习目标 {goal}
目标技能 {subject}
时间周期 {total_days} 天
每日投入 {daily_hours} 小时
推荐节奏 {moderate / intensive / relaxed}
成功标准
- {可验证的能力 1}
- {可验证的能力 2}
- {可验证的能力 3}
- {可验证的能力 4}
阶段计划
阶段 时间 主题 里程碑
─── ────── ──── ────
1 Day {x}-{y} {主题} {可验证产出物}
缓冲 复习 / 整理
2 Day {x}-{y} ...
每周计划（总天数 > 7 天时输出）
周次 主题 时长 风险
─── ──── ──── ────
1 {Topic 1} / {Topic 2} / {Topic 3} {h} {风险预警}
推荐学习栈
用途 资源
──── ────
交互式入门 {Resource 1}
查询练习 {Resource 2}
面试准备 {Resource 3}
文档参考 {Resource 4}
常见卡点
- {具体卡点} → {解决方案}
动态调整说明
- 若目标方向为 {方向 A} → {调整建议}
- 若每日学习时间不足 {阈值} → {调整建议}
- 若 {其他场景} → {调整建议}
5. 输出格式规则
| 维度 | 规则 |
|---|
| 段落顺序 | 画像 → 成功标准 → 阶段计划 → 每周计划 → 学习栈 → 卡点 → 动态调整 |
| 学习者画像 | 必须位于最上方，含 5 个属性行 |
| 成功标准 | 4 条，以"完成本路线图后，应能"开头 |
| 阶段计划 | 每个阶段包含里程碑（可验证产出物），非模糊描述 |
| 推荐学习栈 | 表格格式：用途 / 资源，每行对应一个学习阶段 |
| 常见卡点 | 每行包含具体问题 + 解决方法，用"→"连接 |
| 动态调整 | ≥ 3 条，覆盖不同的目标方向和时间变化场景 |
| 语言 | 全中文。无英文段落标题。无 emoji。无语气词。 |
| 语气 | 客观、指令式、系统感。无"记住"、"建议你"、"会比较"等口语。 |
参考文档
学科模板库、典型场景的路线示例见 references/patterns.md。
脚本工具
scripts/generate_roadmap.py 生成结构化路线，支持 --json 输出和 --interactive 交互模式。
