study-roadmap-generator

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 交互模式。