Study Roadmap Generator 将模糊的"我想学 X"转化为可执行的学习路线图（Learning Roadmap）——包含分阶段目标、每周排期、资源推荐、卡点预警和节奏控制。输出风格与 Linear / Notion 看齐：克制、可扫读、信息密度均匀。
工作流程
从用户对话中提取三个必要参数：
参数 说明 获取方式
学习目标 想学什么 + 学到什么程度 "学 R 语言做数据分析" / "Python 入门"
当前水平 完全零基础 / 有基础 / 考前冲刺 直接询问或根据上下文推断
时间约束 总时长 + 每天可用时间 "两周" / "暑假 3 个月" / "每天 1 小时"
可选参数：
学习风格偏好：学术路线 / 实战路线 / 考试路线（默认根据目标自动选择）
压力系数：宽松（每周 4 天）/ 标准（5-6 天）/ 紧凑（7 天，默认）
输入信号 推断水平
"完全不会"、"零基础"、"0 基础"、"没接触过" 零基础
"会一点"、"用过"、"入门了"、"有 Python 基础" 有基础
"要考试"、"考前"、"冲刺"、"复习"、"考研" 考试冲刺
阶段划分（以总时长 T 天为基准）
阶段 比例 说明
基础（15%） T × 15% 环境搭建、核心概念、第一段运行代码
核心（35%） T × 35% 数据结构、控制流、核心 API
进阶（35%） T × 35% 目标领域的核心能力（数据处理 / 绘图 / 框架）
综合（15%） T × 15% 完整项目、查漏补缺、收尾
每个阶段结束后设半天空白缓冲（标记为 Buffer），防止计划过载。
路线风格切换
风格 适用场景 特征
学术路线 学习理论、备考、系统入门 侧重概念理解、教材导向、渐进练习
实战路线 做项目、求职准备、实用技能 侧重动手、项目驱动、最小可用
考试路线 考前冲刺、应试 侧重真题、高频考点、题海战术
Learning Roadmap {一句话概括目标：X 周从 Y 水平到 Z 目标}
Phases
Phase Duration Focus Milestone
─── ──────── ────── ─────────
1 Day 1-2 {阶段主题} {可验证产出}
2 Day 3-5 {阶段主题} {可验证产出}
3 ... ... ...
Buffer Day X 弹性缓冲日 复习 / 休息
Weekly Plan (if T > 7 days)
Week Topics Hours Risk
─── ────── ───── ────
1 {Topic 1}, {Topic 2} {h} {卡点预警}
2 ... ... ...
Resources by Phase
{Phase 1} - {类型}: {资源名} — {推荐理由}
{Phase 2} - ...
Common Pitfalls - {卡点 1} → {规避建议} - {卡点 2} → {规避建议}
Daily Rhythm - {建议每日节奏，如：练习 20min → 理论 15min → 项目 25min}
- 建议每周至少保留 1 个 Buffer 日
Pressure Check - 估算每周学习量：{Avg}h/wk（建议 ≤ {max}h/wk）
- 过载风险：{Low / Medium / High}（高于上限时提示裁剪）
参见 references/patterns.md 中的学科模板库，包括：
编程语言入门（Python / R / JavaScript / Go / Rust …）
数据分析 / 数据科学
前端 / 后端开发
机器学习 / 深度学习
考试备考（考研 / 认证 / 竞赛）
未覆盖的学科使用通用阶段划分逻辑 + LLM 推理生成。
维度 规则
段落顺序 目标 → 阶段 → 周计划（>7天时）→ 资源 → 卡点 → 每日节奏 → 压力检查
里程碑 每个阶段必须有可验证的产出物
资源推荐 每阶段 1-2 个，标注类型和理由
节奏建议 根据总时长和每天可用时间反推，不以周为单位（<7天）则按天排
压力控制 每周学习时间不超过 (每天可用 × 6)，留一天缓冲
语言 输入中文则输出全中文，段落标题保持英文
参考文档
学科模板库和卡点库见 references/patterns.md。
脚本工具 scripts/generate_roadmap.py 支持结构化路线生成。提供交互模式或参数模式。使用 --json 输出 JSON 供程序消费。
by