Study Roadmap Generator#

将模糊的"我想学 X"转化为可执行的学习路线图（Learning Roadmap）。六段式布局：学习者画像 → 成功标准 → 阶段计划 → 推荐学习栈 → 常见卡点 → 动态调整说明。

工作流程#

1. 收集输入#

从用户对话中提取三个必要参数和一个可选参数：

参数说明获取方式学习目标想学什么 + 学到什么程度"两周学会 SQL 找暑期实习"当前水平零基础 / 有基础 / 考试冲刺直接询问或根据关键词推断时间约束总时长 + 每天可用时间"三周，每天两小时"**目标方向（可选）**后端开发 / 数据分析 / 通用影响阶段侧重和资源选择

2. 水平判断#

输入信号推断结果"完全不会"、"零基础"、"没接触过"零基础"会一点"、"用过"、"有XX基础"有基础"考试"、"考前"、"冲刺"、"考研"考试冲刺

3. 路线生成逻辑#

阶段划分（以总天数 T 为基准）

阶段占比说明基础15%环境搭建、核心概念、首次可验证输出核心35%核心语法、数据结构、基本操作进阶35%目标领域的关键能力综合15%项目整合、查漏补缺

每个阶段后插入一个缓冲日（最后阶段除外）。

路线风格

风格适用场景侧重实战求职 / 项目 / 实用技能动手驱动、最小可用、技能输出学术系统学习 / 考试 / 理论概念理解、教材导向、渐进练习考试考前冲刺 / 认证真题驱动、高频考点、题海战术

4. 输出结构#

text

学习路线图 — {目标}

学习者画像
属性            值
───             ────
当前水平        {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 交互模式。