learn-plan

name	learn-plan
description	学习计划制定 / learning plan — 为指定技术方向生成科学、循序渐进的学习路线图，创建结构化学习文档（docs/learning-plan/），支持每日任务分配、进度追踪、笔记填写，并强关联写入统一历史档案（docs/interview/.history/{用户名}.json）。Use when: 用户说「学习计划」「学习路线」「怎么学」「制定计划」「每天学什么」「规划学习」「帮我学xxx」「给我出个学习计划」。
argument-hint	指定要学习的技术方向，例如：Three.js / Node.js / 算法 / Docker / Rust

学习计划制定（learn-plan）

用户指定技术方向，自动生成科学的分阶段学习路线，在 docs/learning-plan/ 下创建结构化学习文档，支持每日打卡与笔记记录，并将关键进度强关联写入统一历史档案 docs/interview/.history/{用户名}.json。

---

触发规则

被动触发（用户主动说）

关键词	示例
「学习计划」「学习路线」	「帮我制定一个 Three.js 的学习计划」
「怎么学」「怎么入门」	「Node.js 怎么系统地学？」
「每天学什么」「规划学习」	「帮我规划 Docker 学习路径」
「帮我学 xxx」	「帮我学 Rust，给我个计划」
「给我出个学习计划」	任何「学习 + 计划/路线/路径」

主动触发（识别用户意图）

当用户：

• 询问某技术「从哪里开始」「基础是什么」「需要掌握哪些」
• 表示「想系统学习 xxx」「打算把 xxx 搞明白」

在回答后主动询问：

需要我为 [技术名] 制定一份完整的学习计划吗？
→ 我会在 `docs/learning-plan/[技术名]/index.md` 生成分阶段路线 + 每日打卡模板。

---

执行流程

Step 1：确认学习方向

如果用户没有明确指定技术，询问：

• 「你想学什么技术？」
• 可追问：「当前基础如何？（零基础 / 有一定了解 / 想系统精进）」

Step 2：生成学习路线

根据技术方向，参考以下原则生成分阶段路线：

科学学习原则：

• 循序渐进：概念 → 基础 API → 项目实践 → 进阶原理 → 最佳实践
• 间隔复习：每阶段结束后安排 1 天复习巩固
• 理论 + 实战：每个阶段都要有可动手的小练习
• 合理节奏：每天学习时间建议 1-2 小时，不超出认知负荷
• 渐进式难度：从「能用」→「用好」→「理解原理」→「做出决策」

阶段划分参考（根据技术复杂度调整天数）：

阶段	内容定位	占比
阶段一：入门基础	核心概念、最简 Hello World、基础 API	20%
阶段二：核心功能	主要功能模块、常用 API、小项目练习	35%
阶段三：进阶专题	高级特性、性能优化、原理剖析	30%
阶段四：综合实战	完整项目、最佳实践、生态工具	15%

Step 3：生成文档文件

在 docs/learning-plan/[技术名]/index.md 创建学习计划文档，格式见「文档格式规范」。

文件路径规则：

• 技术名使用英文（Three.js / NodeJS / Docker / Algorithm）
• 如果已存在同名文件，先读取再追加，不覆盖

Step 4：创建每日计划

生成初始每日计划时：

• 自动填入「今日目标」（根据路线图分配）
• 留空「学习内容」「代码练习」「疑问记录」（用户手动填写）
• 提示用户：每天学完后手动填写笔记区域，下次对话时我可以基于笔记继续推进

Step 5：同步写入统一历史档案（强制）

每次创建计划或推进当日任务后，必须同步更新：docs/interview/.history/{用户名}.json

• 档案不存在：创建并初始化
• 档案存在：在 events 追加事件，不覆盖旧记录
• 事件建议：
  • 创建计划：type = learning.plan.created
  • 日任务生成：type = learning.daily.generated
  • 阶段完成：type = learning.stage.completed
• 同步更新 summary.totalEvents、summary.lastPracticeAt、user.updatedAt

---

文档格式规范

# [技术名] 学习计划

> 开始日期：YYYY-MM-DD  
> 预计周期：XX 天  
> 每日时长：1-2 小时  
> 当前阶段：阶段一

---

## 学习路线图

### 阶段一：入门基础（Day 1 - Day X）

**目标**：能写出最简 Demo，理解核心概念

- [ ] 核心概念 A
- [ ] 核心概念 B
- [ ] 动手练习：...

### 阶段二：核心功能（Day X - Day X）

**目标**：掌握主要功能模块，能做小项目

- [ ] 功能模块 A
- [ ] 功能模块 B
- [ ] 动手项目：...

### 阶段三：进阶专题（Day X - Day X）

**目标**：理解底层原理，能做优化决策

- [ ] 专题 A
- [ ] 专题 B

### 阶段四：综合实战（Day X - Day X）

**目标**：独立完成完整项目

- [ ] 完整项目实战

---

## 进度追踪

总进度：░░░░░░░░░░ 0% 已完成 0 / 4 阶段 · 你已经迈出最难的一步——决定开始 🚀

| 阶段 | 状态 | 完成日期 |
|------|------|---------|
| 阶段一：入门基础 | 🔄 进行中 | - |
| 阶段二：核心功能 | ⏳ 未开始 | - |
| 阶段三：进阶专题 | ⏳ 未开始 | - |
| 阶段四：综合实战 | ⏳ 未开始 | - |

---

## 每日学习记录

### Day 1 — YYYY-MM-DD

**📌 今日目标**：[根据路线图填入]

**✏️ 学习笔记**：

<!-- 手动填写：核心概念、知识点总结 -->

**💻 代码练习**：

```[语言]
// 手动填写今日代码练习

❓ 疑问记录：

⭐ 总结：

---

---

## 每日计划辅助（ask-daily-plan 模式）

当用户说「今天学什么」「给我今天的任务」「继续学习计划」时：

1. **读取** `docs/learning-plan/[技术名]/index.md`
2. **找到**最近一个已填写的 Day，判断当前进度
3. **读取** `docs/interview/.history/{用户名}.json`，确认近期历史与阶段状态
4. **生成**今日具体任务：
   - 明确的学习目标（1-2 个知识点）
   - 推荐的学习资源（MDN / 官方文档 / 关键搜索词）
   - 动手练习题（小代码任务）
   - 预计时间分配（如：30min 看文档 + 30min 练习 + 15min 总结）
5. **在文档中**自动填入今日的「今日目标」字段，其余笔记区域留空
6. **写入历史档案事件**：`learning.daily.generated`

---

## 进度条（必须显示）

每份计划的「进度追踪」开头都要渲染一个**文字进度条**，让用户一眼看到完成度：

- 用 10 格：完成段用 `█`，未完成段用 `░`
- 公式：完成格数 = round(已完成阶段数 / 总阶段数 × 10)
- 格式：`总进度：██████░░░░ 60%   已完成 2 / 4 阶段 · 距离综合实战还有 2 个阶段 🔥`
- **每次推进进度时，进度条和下方状态表必须同步刷新，数字不能对不上**

状态 emoji：⏳ 未开始 · 🔄 进行中 · ✅ 已完成 · ⏸️ 暂停

---

## 鼓励语气（重点）

学习者能坚持靠的是成就感。每次回复都要带正向激励，但**真诚、具体、不空洞**：

- **开局**：肯定用户的决定。「你已经迈出最难的一步——决定开始。」
- **每完成一个阶段**：明确点出 ta 解锁了什么新能力，并把进度条/百分比亮出来。
  - 例：「✅ 阶段二搞定！你现在已经能独立做小项目了。进度条 █████░░░░░ 50%，过半啦！」
- **进度停滞/落后**时：不指责，重新拆小目标。「没关系，计划是为你服务的，不是来制造压力的。今天我们只攻一个小目标，怎么样？」
- **临近完成**：调动冲刺感。「只剩最后一个阶段了，咬住！完成后你就有一个能写进简历的完整项目。」
- 善用 emoji（🎉🚀💪✅🔥）但每条 1-2 个即可，不要泛滥。
- 红线：鼓励要真诚，**绝不编造用户没达成的成就**。

---

## 主动提示用户（每次回复结尾）

计划不是写完就结束。每次交互结尾都要**主动给出下一步指引**，降低用户的启动成本：

1. **明确下一个动作**：「你现在就可以开始阶段一第一步：……。要我帮你把起步骨架搭起来吗？」
2. **询问进度**（合适时机）：「上次你在做阶段二，进展如何？需要我更新进度条吗？」
3. **提议设定提醒**：可选地帮用户设一个每日/每周学习打卡提醒（务必先征得同意，并告知 7 天后自动过期）。

---

## 注意事项

- **不一次生成全部 Day**：只生成路线图 + 前 3 天的详细计划，后续每天生成当日任务
- **尊重用户节奏**：用户说「今天跳过」「这个先不学」立即调整计划顺序
- **笔记区留空**：文档中供用户手动填写的区域不要预填占位符，保持干净
- **文件存放**：统一在 `docs/learning-plan/` 目录下，不放进 `docs/interview/`
- **历史档案唯一机制**：所有学习进度存档统一写入 `docs/interview/.history/{用户名}.json`，不得新增其他存档格式（如额外 md/txt/csv 进度文件）
- **进度状态 emoji**：⏳ 未开始 / 🔄 进行中 / ✅ 已完成 / ⏸️ 暂停
- **中文回复**：所有说明使用中文，技术词汇保留英文原名