minimind-learning

MiniMind Learning Assistant

自动化学习笔记系统，静默记录你的 MiniMind 学习历程。

When to use

自动激活场景：

1. 学习开始时：

   • 用户说："开始今天的学习"、"开始学习"、"今天学什么"
   • 用户说："继续学习"、"学习 MiniMind"

2. 讨论 MiniMind 内容时：

   • 提问包含：RMSNorm, LayerNorm, RoPE, YaRN, Attention, GQA, SwiGLU, Transformer, LoRA, DPO, PPO, GRPO, SFT, RLHF, RLAIF, MoE
   • 问题词：什么是、如何、为什么、怎样、解释、原理
   • 遇到问题：报错、错误、失败、Bug

3. 显式记录请求：

   • 用户说："记录一下"、"保存笔记"、"写入笔记"

How to use

1. 初始化检查

首次激活时，确保笔记结构存在：

# 检测 Git 仓库根目录
git rev-parse --show-toplevel

# 验证是 MiniMind 仓库（存在以下文件）
# - model/model_minimind.py
# - trainer/train_pretrain.py
# - README.md (包含 "MiniMind")

# 创建笔记目录（如不存在）
mkdir -p docs/learning_materials

# 从模板初始化文件（如不存在）
# - docs/notes.md
# - docs/learning_log.md
# - docs/knowledge_base.md
# - docs/learning_materials/README.md

模板位置：~/.claude/skills/minimind-learning/templates/

2. 学习引导模式

当用户说"开始学习"时，主动引导：

👋 欢迎开始今天的 MiniMind 学习！

你想学习哪个模块？

**基础组件**：
1. 归一化技术 - RMSNorm, LayerNorm
2. 位置编码 - RoPE, YaRN
3. 注意力机制 - Attention, GQA
4. 前馈网络 - FeedForward, SwiGLU

**训练技术**：
5. 预训练 - Pretraining
6. 监督微调 - SFT
7. 参数高效微调 - LoRA
8. 强化学习 - DPO, PPO, GRPO

直接告诉我编号或主题名称，我会为你讲解！

（学习过程中我会自动记录笔记到 `docs/` 目录）

3. 触发检测

每次用户消息后，检查是否满足以下任一条件：

Tier 1: 即时触发（立即更新笔记）

# MiniMind 术语（50+）
TERMS = [
    # 架构
    "RMSNorm", "LayerNorm", "BatchNorm", "GroupNorm",
    "RoPE", "YaRN", "ALiBi", "位置编码",
    "Attention", "注意力", "GQA", "MQA", "FlashAttention",
    "FeedForward", "前馈", "SwiGLU", "GELU", "GLU",
    "Transformer", "TransformerBlock",

    # 训练
    "pretrain", "预训练", "pretraining",
    "SFT", "监督微调", "fine-tuning", "微调",
    "LoRA", "lora", "LoRA-r", "LoRA-alpha",
    "DPO", "PPO", "GRPO", "SPO",
    "RLHF", "RLAIF", "强化学习",
    "distillation", "蒸馏", "知识蒸馏",

    # 模型
    "MiniMind", "MiniMind-Dense", "MiniMind-MoE",
    "MoE", "混合专家", "expert routing",
    "MiniMind-Reason", "R1",
]

# 问题词
QUESTION_WORDS = ["什么是", "如何", "为什么", "怎样", "解释", "原理", "作用"]

# 问题指示
PROBLEM_MARKERS = ["报错", "错误", "失败", "Bug", "不工作", "问题"]

# 检查
if any(term in user_message for term in TERMS):
    trigger_tier_1()
elif any(word in user_message for word in QUESTION_WORDS):
    trigger_tier_1()
elif any(marker in user_message for marker in PROBLEM_MARKERS):
    trigger_tier_1()