smart-learnlisted

# Smart Learn — 增量内联学习技能 基于费曼学习法五步闭环。纯 Markdown 零依赖可用；可选 `pip install python-docx` 获得 Word 文档功能。每一步学习成果同步更新到 **Word 文档** + **Mermaid 思维导图**，全程实时生长。 ## 触发 - `/smart-learn 主题名` - "教我 Kubernetes 网络模型" - "帮我系统学习 DDD" - 任何表达出"想系统掌握一个复杂主题"的意图 ### 不触发 - 简单定义（"X是什么"） - 信息查询（"帮我查一下X"） - 内容总结（"总结这篇文章"） ## 核心原则 1. **禁止使用 Agent 工具** — 所有步骤由主对话直接执行 2. **每步可见** — 输出实时展示，用户确认后进入下一步 3. **自然对话** — 不用弹窗确认，用户用自然语言回应即可 4. **零外部依赖（核心）** — Markdown 学习 + 存储不依赖任何第三方包 5. **三格式持久化** — .md（知识库笔记，始终生成） + .docx（Word文档，可选） + Mermaid 思维导图（零依赖，始终生成） --- ## 初始化（Word 文档 + 思维导图） 学习开始前，同时初始化 Word 文档和 Mermaid 思维导图。Word 失败不影响核心流程；思维导图零依赖始终可用。 ```bash # 思维导图（零依赖，始终生成） python .claude/skills/smart-learn/mindmap_utils.py init \ --topic "主题名" \ --output-dir "knowledge_store" # Word 文档（可选，需 python-docx） python .claude/skills/smart-learn/docx_utils.py init \ --topic "主题名" \ --output-dir "knowledge_store" ``` - 记录 `MINDMAP_FILE` 和 `MINDMAP_DATA` 路径，后续每步同步更新 - 如果 docx init 返回 `"status": "no_docx"` → 告知用户可 `pip install python-docx`，继续执行 - **智能入口检测**：初始化时按以下顺序检查已学记录，以**非阻塞提示**方式告知用户（不中断流程，用户无需回应即可继续）： 1. 检查 `knowledge_store/{主题slug}_checkpoint.json` → 存在 = 有未完成学习 2. 检查 `knowledge_store/{主题}.md` 或 `knowledge_store/{主题}_学习笔记.docx` → 存在 = 已学完 3. 检查 `knowledge_store/` 下文件名含关键词的笔记 → 存在 = 有相关知识 根据检测结果，在初始化日志中附带提示（不阻塞，不等用户选择）： - **有未完成学习** → 告知"💡 检测到未完成的学习（步骤N/5）。输入 `继续` 可续学，或正常开始全新学习" - **已学完该主题** → 告知"💡 你已学过「{主题}」。需要复习时随时输入 `/smart-review {主题}`" - **有相关主题笔记** → 告知"💡 检测到相关笔记「{主题}」，步骤4将自动关联"