菜单
技术学习路线图生成器。用户输入想学习的主题和目标后，结合用户基础和 YouTube 搜索结果， 生成一条可执行的视频学习路线图。触发词：「学习路线」「学习路线图」「帮我规划学习」 「学习路径」「技术学习」「roadmap」「学习计划」「给我一个学习方案」「我想学」「从零学」 「入门到」「学习规划」+ 任何技术主题。当用户想制定技术学习计划、需要视频资源推荐、 或需要分阶段学习方案时触发此 Skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | tech-learning-roadmap |
| description | 技术学习路线图生成器。用户输入想学习的主题和目标后，结合用户基础和 YouTube 搜索结果， 生成一条可执行的视频学习路线图。触发词：「学习路线」「学习路线图」「帮我规划学习」 「学习路径」「技术学习」「roadmap」「学习计划」「给我一个学习方案」「我想学」「从零学」 「入门到」「学习规划」+ 任何技术主题。当用户想制定技术学习计划、需要视频资源推荐、 或需要分阶段学习方案时触发此 Skill。 |
使用本 Skill 自带的轻量 CLI，不需要启动 FastAPI 服务。
脚本路径：scripts/youtube_cli.py（相对于本 SKILL.md）
执行下列命令时，将工作目录设置为本 Skill 目录。
默认配置文件：config.json（与本 SKILL.md 同目录）。
打开该文件，将获取到的 Key 填入 youtube_api_key：
{
"youtube_api_key": "AIzaSy...你的实际Key"
}
注意：
--config C:\path\to\config.json 指定其他配置文件。API Key 读取优先级：--api-key → YOUTUBE_API_KEY → GOOGLE_API_KEY → config.json。
如需使用环境变量：
$env:YOUTUBE_API_KEY = "你的 API Key"
config.json。本 CLI 只读取 YouTube 公开数据，不需要 OAuth 客户端 ID；普通 API Key 即可。API 请求会消耗项目的 YouTube Data API 配额。
可用命令：
python scripts/youtube_cli.py search --q "{关键词}" --max-results {数量} --order {排序} --video-duration {short|medium|long} — 关键词搜索视频python scripts/youtube_cli.py video {video_id} — 查询单个视频详情（含时长、播放量、标签等）python scripts/youtube_cli.py videos {id1} {id2} — 批量查询视频详情（最多 50 个）python scripts/youtube_cli.py channel-videos {channel_id} --max-results {数量} --days-back {天数} — 查询频道近期视频所有成功结果以 JSON 输出到 stdout；错误以 JSON 输出到 stderr 并返回非零退出码。
搜索参数说明：
order: relevance（默认）| date | viewCount | rating--video-duration: short（<4min）| medium（4-20min）| long（>20min）--published-after/--published-before: RFC 3339 时间过滤--region-code: 国家码，如 US、CN调用示例：
python scripts/youtube_cli.py search --q "react tutorial beginner" --max-results 20 --order viewCount --video-duration long --with-details
如果用户只给了学习主题，没有说明基础和目标，必须先反问以下问题（一次性问完）：
如果用户已经提供了足够信息（主题 + 基础 + 目标 + 时间），直接进入第二步。
搜索策略（必须执行多轮搜索，不能只搜一次）：
{主题} basics / {主题} fundamentals / {主题} 入门{主题} tutorial / {主题} course / {主题} explained{主题} advanced / {主题} deep dive / {主题} best practices{主题} project / {主题} build / {主题}实战 / {主题} hands on搜索时注意：
order=viewCount 获取高播放量优质视频video_duration=long 获取教程类长视频（通常质量更高）video_duration=medium 获取概念讲解类视频video {id} 或 videos {id1} {id2} 获取详情（时长、播放量、标签）；也可在搜索时加 --with-details视频筛选标准：
根据搜索结果和用户基础，规划 N 个阶段（通常 4-8 个阶段，取决于学习目标和时间）。
每个阶段必须包含：
### 阶段 X：{阶段名称}
- **学习目标**：本阶段要掌握的核心能力（1-3 句话）
- **预计时间**：X 周
- **推荐视频**：
1. 「视频标题」- 频道名 (时长) - https://youtube.com/watch?v=xxxxx
推荐理由：一句话说明为什么选这个视频
2. ...
- **知识作业**（不附答案）：
- 选择题 2-3 道
- 问答题 2-3 道
- **实战作业**：
1 个动手项目或练习，具体描述要做什么
阶段划分原则：
{workspace}/learning-roadmap-{主题}/
├── 路线图总览.md # 含 Mermaid 路线图
├── 阶段1_{名称}/
│ ├── 学习指南.md
│ ├── 知识作业.md
│ └── 实战作业.md
├── 阶段2_{名称}/
│ ├── 学习指南.md
│ ├── 知识作业.md
│ └── 实战作业.md
└── ...
文件内容规范：
使用以下格式生成路线图：
graph LR
A[阶段1: 基础] --> B[阶段2: 核心概念]
B --> C[阶段3: 进阶]
C --> D[阶段4: 实战项目]
D --> E[阶段5: 综合项目]
style A fill:#4CAF50,color:#fff
style B fill:#2196F3,color:#fff
style C fill:#FF9800,color:#fff
style D fill:#FF5722,color:#fff
style E fill:#9C27B0,color:#fff