learning-manager

分类: 数据与AI | 上传者: code-firefly | 下载: 0 | 版本: v1.0（最新）
AI 技术学习模块管理（按需加载）- 开始学习、完成学习、重置模块、整合缓存检查。当用户说"开始学习"、"我要学..."、"进入...模块"、"学完了"、"搞定"、"完成学习"、"重置模块"、"重新开始"时触发此技能。
更新日志: Source: GitHub https://github.com/code-firefly/claude-code-study-template
目录结构

当前层级: .claude/skills/learning-manager/
📄 SKILL.md 16.4 KB
SKILL.md

---
name: learning-manager
description: AI 技术学习模块管理（按需加载）- 开始学习、完成学习、重置模块、整合缓存检查。当用户说"开始学习"、"我要学..."、"进入...模块"、"学完了"、"搞定"、"完成学习"、"重置模块"、"重新开始"时触发此技能。
---

# Learning Manager Skill

> **本技能管理学习生命周期，整合缓存检查，引用 learning-status 共享机制**

## 功能范围
- 开始学习新模块（整合缓存检查、选择模式、初始化状态）
- 完成模块学习（验证完成度）
- 重置模块进度
- **引用共享机制**：模块路径映射、非阻塞更新检查

---

## 共享机制引用

> 以下机制引用自 learning-status 技能，避免代码重复

### 模块路径映射
直接使用 learning-status 提供的映射表，包括：
- 新名称（v2.0）
- 旧名称（v1.x 向后兼容）
- 别名映射

### 非阻塞更新检查（带缓存机制）
直接引用 learning-status 的实现：
- 配置文件：`.claude/update-config.json`
- 24小时缓存机制
- 版本比较与提醒

---

# 开始学习

**触发方式**（任意一种）：
- "开始学习 `<模块名>`" / "启动 `<模块名>` 的学习" / "开始学习模块 `<模块名>`"
- "我要学 `<模块名>`" / "我要开始学 `<模块名>`" / "我想学 `<模块名>`"
- "开始 `<模块名>`" / "进入 `<模块名>` 模块" / "学习 `<模块名>`"
- "学 `<模块名>`" / "启动 `<模块名>`" / "开启 `<模块名>` 学习"
- "`<模块名>` 开始学习" / "对 `<模块名>` 开始学习"

**执行步骤**：

### 步骤 0：非阻塞更新检查

引用 learning-status 的"非阻塞更新检查"机制：
- 如存在更新提醒，存储并在最终输出前显示
- 不阻塞学习流程，仅作为信息提醒

### 步骤 0.5：检查知识缓存（整合自 learning-cache）

1. 读取模块的 `knowledge/.metadata.json`（如果存在）

2. **情况 A：缓存存在**
   - 显示：`📦 发现本地缓存 (缓存日期: YYYY-MM-DD)`
   - 询问用户：
     - 1. 使用本地缓存（快速开始）
     - 2. 更新缓存（拉取最新资料）
     - 3. 跳过缓存（直接开始学习）

3. **情况 B：缓存不存在**
   - 显示：`⚠️  未找到知识缓存`
   - 询问用户：
     - 1. 初始化缓存（推荐，首次拉取）
     - 2. 跳过缓存（直接开始学习）

4. **用户选择后的处理**：
   - 选择使用/初始化/更新缓存：调用 learning-tools 的缓存功能
   - 选择跳过：直接进入下一步

### 步骤 1：模块名称别名解析

如果用户输入的模块名不在映射表中，检查别名映射：

| 旧名称 | 新名称 | 说明 |
|--------|--------|------|
| `claude-code-core` | `ai-tools-fundamentals` | AI 工具基础 |
| `mcp-basics` | `mcp-protocol` | MCP 协议入门 |
| `agent-sdk` | `agent-configuration` | Agent 配置与使用 |
| `mcp-advanced` | `mcp-advanced-config` | MCP 高级配置 |
| `openclaw-ecosystem` | `ai-orchestration` | AI 编排平台 |
| `everything-claude-code` | `ai-resources-research` | AI 资源研究 |
| `cc-switch` | `config-management` | 配置管理工具 |
| `spec-kit` | `spec-driven-dev` | 规范驱动开发 |
| `projects` | `practical-projects` | 综合实战项目 |

如果找到别名：
- 显示提示：`💡 注意：'{旧名称}' 已更名为 '{新名称}'，正在使用新名称继续...`
- 使用新名称继续后续流程

### 步骤 2：查找模块路径

从 learning-status 的映射表查找模块路径，优先匹配新名称。

### 步骤 3：验证模块状态

检查模块是否已开始学习（检查 checklist.md 的学习模式选择）
- 如果已开始，显示警告信息：
  ```
  ⚠️  该模块已经开始了！
  当前状态：{状态} {进度}
  是否要重新开始？(y/n)
  ```

### 步骤 4：选择学习模式

询问用户选择：
- 1. 📚 快速模式（约 3 天）- 理论为主
- 2. 🛠️ 完整模式（约 1 周）- 理论+实践

**模式说明**：
- 快速模式：适合快速了解概念，以阅读文档为主
- 完整模式：深入掌握技能，包含实践练习

### 步骤 5：显示更新预览

```
╔═══════════════════════════════════════════════════════╗
║                  开始学习预览                          ║
╠═══════════════════════════════════════════════════════╣
║ 模块：ai-tools-fundamentals                           ║
║ 优先级：P0 🔴 必学                                     ║
║ 模式：📚 快速模式（约 3 天）                           ║
║ 开始日期：2026-03-07                                   ║
╠═══════════════════════════════════════════════════════╣
║ 将要更新：                                             ║
║   ✓ 01-基础入门/ai-tools-fundamentals/checklist.md    ║
║   ✓ 01-基础入门/ai-tools-fundamentals/notes.md        ║
║   ✓ PROGRESS.md                                        ║
╠═══════════════════════════════════════════════════════╣
║ 确认开始学习？(y/n)                                    ║
╚═══════════════════════════════════════════════════════╝
```

### 步骤 6：更新文件

用户确认后，更新以下文件：

**checklist.md**：
```markdown
# 勾选对应的学习模式
- [x] **快速模式**（约 3 天）- 理论为主
- [ ] **完整模式**（约 1 周）- 理论+实践
```

**notes.md**：
```markdown
> **学习模式**：快速模式
> **开始日期**：2026-03-07
```

**PROGRESS.md**：
```markdown
# 更新模块行
| ai-tools-fundamentals | P0 🔴 | 快速模式 | 进行中 | 0% |

# 添加学习日志
| 2026-03-07 | ai-tools-fundamentals | 开始学习 | 选择快速模式 |
```

### 步骤 7：显示成功信息

```
✅ 学习已开始！

📍 模块：ai-tools-fundamentals (快速模式)
📅 开始日期：2026-03-07

下一步：
• 查看 README.md 了解模块概述
• 按照 checklist.md 逐项完成学习
• 随时说"更新进度"同步进度

💡 提示：说"查看 ai-tools-fundamentals 状态"可查看详细进度
```

---

# 完成学习

**触发方式**（任意一种）：
- "完成学习 `<模块名>`" / "标记 `<模块名>` 为已完成" / "完成模块 `<模块名>`"
- "学完了 `<模块名>`" / "`<模块名>` 搞定了" / "`<模块名>` 学完了"
- "结束学习 `<模块名>`" / "`<模块名>` 学习结束" / "`<模块名>` 完成了"
- "`<模块名>` 已经学完" / "搞定 `<模块名>`" / "`<模块名>` 完成"
- "标记完成 `<模块名>`" / "`<模块名>` 已完成" / "完成 `<模块名>` 模块"

**执行步骤**：

### 步骤 0：非阻塞更新检查

引用 learning-status 的"非阻塞更新检查"机制

### 步骤 1：解析 checklist.md 计算完成百分比

### 步骤 2：验证完成情况

从 checklist.md 统计未完成项：

```
╔═══════════════════════════════════════════════════════╗
║                  完成度验证                           ║
╠═══════════════════════════════════════════════════════╣
║ 模块：ai-tools-fundamentals                           ║
║ 当前进度：85% ████████████████░░░░░░░░░               ║
╠═══════════════════════════════════════════════════════╣
║ 未完成项：                                             ║
║   ☐ 第一部分 > Tool Use 高级技巧                      ║
║   ☐ 第二部分 > 实战练习 2                             ║
╠═══════════════════════════════════════════════════════╣
║ ⚠️  还有未完成的学习项                                ║
║                                                      ║
║ 选项：                                               ║
║   1. 继续完成所有项目后再标记                        ║
║   2. 强制标记为完成（即使有未完成项）                 ║
║                                                      ║
║ 请选择 (1/2):                                        ║
╚═══════════════════════════════════════════════════════╝
```

### 步骤 3：显示完成预览

```
╔═══════════════════════════════════════════════════════╗
║                  完成学习预览                         ║
╠═══════════════════════════════════════════════════════╣
║ 模块：ai-tools-fundamentals                           ║
║ 最终进度：100% ████████████████████████████           ║
║ 学习模式：📚 快速模式                                 ║
║ 完成日期：2026-03-10                                   ║
╠═══════════════════════════════════════════════════════╣
║ 将要更新：                                             ║
║   ✓ 01-基础入门/ai-tools-fundamentals/notes.md        ║
║   ✓ PROGRESS.md                                        ║
╠═══════════════════════════════════════════════════════╣
║ 确认完成学习？(y/n)                                    ║
╚═══════════════════════════════════════════════════════╝
```

### 步骤 4：用户确认后，更新以下文件

**notes.md**：
```markdown
> **学习模式**：快速模式
> **开始日期**：2026-03-07
> **完成日期**：2026-03-10
```

**PROGRESS.md**：
```markdown
# 更新模块行
| ai-tools-fundamentals | P0 🔴 | 快速模式 | 已完成 | 100% |

# 添加完成日志
| 2026-03-10 | ai-tools-fundamentals | 完成学习 | 快速模式，学习时长3天 |
```

### 步骤 5：重新计算总体进度

重新计算：
- 总体进度 = 所有模块完成百分比的平均值
- 各优先级进度 = 该优先级下所有模块的平均值

### 步骤 6：显示完成信息

```
✅ 恭喜完成学习！

🏆 模块：ai-tools-fundamentals
📊 进度：100% ████████████████████████████
⏱️  学习时长：3 天
📅 完成日期：2026-03-10

总体进度更新：
• 总体：15% → 30%
• P0 必学：50% → 100%

下一步建议：
• 开始学习下一个模块：mcp-protocol
• 或说"查看学习状态"查看所有模块进度
```

---

# 重置模块

**触发方式**（任意一种）：
- "重置模块 `<模块名>`" / "重新开始 `<模块名>`" / "清除 `<模块名>` 的进度"
- "重学 `<模块名>`" / "`<模块名>` 重新开始" / "从头开始 `<模块名>`"
- "清除进度 `<模块名>`" / "重置 `<模块名>`" / "`<模块名>` 清零"

**执行步骤**：

### 步骤 1：显示警告

```
╔═══════════════════════════════════════════════════════╗
║ ⚠️  重置模块警告                                      ║
╠═══════════════════════════════════════════════════════╣
║ 此操作将清除模块的所有学习进度：                      ║
║   • 取消所有学习项目勾选                              ║
║   • 清除学习模式选择                                  ║
║   • 重置日期和进度记录                                ║
║   • 清除学习笔记                                      ║
╠═══════════════════════════════════════════════════════╣
║ 模块：ai-tools-fundamentals                          ║
║ 当前进度：85% ████████████████░░░░░░░░░               ║
╠═══════════════════════════════════════════════════════╣
║ 确认重置？请输入模块名确认：                          ║
╚═══════════════════════════════════════════════════════╝
```

### 步骤 2：等待用户输入模块名确认

用户必须输入完整的模块名（如 `ai-tools-fundamentals`）才能继续

### 步骤 3：重置文件

**checklist.md**：
```markdown
# 取消所有勾选，清除模式选择
- [ ] **快速模式**（约 3 天）- 理论为主
- [ ] **完整模式**（约 1 周）- 理论+实践

# 取消所有学习项目的勾选
- [ ] 第一部分 > Claude Code 核心概念
- [ ] 第一部分 > Tool Use 机制详解
...
```

**notes.md**：
```markdown
> **学习模式**：待选择
> **开始日期**：待定
```

**PROGRESS.md**：
```markdown
# 更新模块行
| ai-tools-fundamentals | P0 🔴 | 未选择 | 未开始 | 0% |

# 添加重置日志
| 2026-03-10 | ai-tools-fundamentals | 重置模块 | 清除所有进度 |
```

### 步骤 4：显示重置完成信息

```
✅ 模块已重置！

🔄 模块：ai-tools-fundamentals
📊 状态：未开始 (0%)

可以重新开始学习了！说"开始学习 ai-tools-fundamentals"即可。
```

---

# 📝 文件操作模式

## checklist.md 更新模式

```markdown
# 快速模式开始前
- [ ] **快速模式**（约 3 天）- 理论为主
- [ ] **完整模式**（约 1 周）- 理论+实践

# 快速模式开始后
- [x] **快速模式**（约 3 天）- 理论为主
- [ ] **完整模式**（约 1 周）- 理论+实践

# 学习项目勾选
- [x] 第一部分 > Claude Code 核心概念
- [x] 第一部分 > Tool Use 机制详解
- [ ] 第一部分 > Tool Use 高级技巧
```

## notes.md 更新模式

```markdown
# 未开始状态
> **学习模式**：待选择
> **开始日期**：待定

# 快速模式进行中
> **学习模式**：快速模式
> **开始日期**：2026-03-07

# 完成后
> **学习模式**：快速模式
> **开始日期**：2026-03-07
> **完成日期**：2026-03-10
```

## PROGRESS.md 更新模式

```markdown
# 开始学习（从未选择到快速模式进行中）
| ai-tools-fundamentals | P0 🔴 | 未选择 | 未开始 | 0% |
↓
| ai-tools-fundamentals | P0 🔴 | 快速模式 | 进行中 | 0% |

# 更新进度
| ai-tools-fundamentals | P0 🔴 | 快速模式 | 进行中 | 25% |

# 完成学习
| ai-tools-fundamentals | P0 🔴 | 快速模式 | 已完成 | 100% |

# 重置模块
| ai-tools-fundamentals | P0 🔴 | 快速模式 | 已完成 | 100% |
↓
| ai-tools-fundamentals | P0 🔴 | 未选择 | 未开始 | 0% |
```

---

# 📋 注意事项

1. **用户确认**：修改多个文件前，总是先显示预览并等待用户确认
2. **日期格式**：统一使用 YYYY-MM-DD 格式
3. **文件路径**：所有路径相对于仓库根目录
4. **错误处理**：如果文件不存在或模块未找到，给出明确的错误提示
5. **进度计算**：基于实际勾选的 checkbox 数量，不要估算
6. **别名处理**：用户使用旧名称时，友好提示并使用新名称继续
7. **缓存整合**：开始学习时主动检查知识缓存，提供选项而非强制
登录后下载/点赞/收藏 ❤ 3 | ★ 0
learning-manager

目录结构

SKILL.md

举报内容

提示
