根据用户输入的学习目标、当前水平和可用时间,自动生成结构化的学习路线图 — 包含阶段划分、每周计划、推荐资源、高频卡点和每日节奏建议。用户在说出"帮我做学习计划"、"制定学习路线"、"一周学会XX"、"XX学习路线图"等请求时激活。
---
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` 交互模式。
don't have the plugin yet? install it then click "run inline in claude" again.