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