扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。
扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。
npx skills add https://github.com/Treasoni/Study-Notes --skill moc复制此命令并粘贴到 Claude Code 中以安装该技能
美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。
写笔记阶段。根据整理好的资料和用户偏好的笔记类型（概念/实战/对比/速查/心得），选择模板，提取关键信息，用学习者友好的语言生成笔记初稿。触发时机：用户审核通过 curate 产出后（研究驱动型），或用户审核通过 review 产出后（心得笔记），Phase 3。
扫描 Obsidian vault 中所有失效的 [[双链]]（目标文件不存在），呈现死链清单，提供删除链接、创建占位笔记、替换为正确链接三种修复方式。触发时机：用户发现链接失效、手动删除文件后需清理、定期 vault 健康检查时。
安全删除 Obsidian 笔记文件。删除指定文件前自动搜索全库 [[双链]] 引用，清理所有指向该文件的链接，经用户确认后执行删除。触发时机：用户要求删除笔记、清理文件、移除内容时。
分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。
美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。
| name | moc |
| description | 扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。 |
用户要求为某个目录生成 MOC、索引、目录地图时。
ls 或 find 检查）{target_dir}/{dir_name} MOC.mdupdated: 字段为当前日期用 find 递归扫描目标目录下所有 .md 文件：
排除规则（必须）：
. 开头的路径（.obsidian、.git、.claude、.learnings 等）MOC.md 结尾或名为 _index.md 的文件find {dir} -not -path '*/\.*' -name '*.md' 获取文件列表分组规则：
根目录 组元数据提取：
# 开头的标题；无 H1 则用文件名（不含扩展名）tags 字段按以下顺序生成内容：
4a. YAML frontmatter
---
title: "{目录名} MOC"
tags: [moc]
created: {当前日期}
updated: {当前日期}
---
4b. ## 目录结构 — Mermaid 图表
| 笔记总数 | 图表策略 |
|---|---|
| ≤15 | 画出完整层级：目录 → 子目录 → 具体笔记节点。对笔记节点应用 class NodeName internal-link; 使其可点击。 |
| >15 | 降维：仅画出目录和子目录节点及其关系，不画具体笔记节点。避免 50+ 节点的"面条图"。 |
graph TD
Root[{目录名}]
Root --> SubA[子目录A]
Root --> SubB[子目录B]
SubA --> Note1[笔记1]
SubA --> Note2[笔记2]
class Note1,Note2 internal-link;
4c. ## 笔记索引 — 按组列出
### {组名}
- [[笔记标题]] #tag1 #tag2
- [[另一篇笔记]]
.md）作为 wikilink 显示文本#tag 形式追加在链接后4d. ## 概览
- 📂 目录：`{path}`
- 📝 笔记总数：{N}
- 📁 子目录数：{M}
- 📅 生成日期：{YYYY-MM-DD}
新建模式（目标路径无已有文件）：
修改模式（目标路径已有 MOC 文件）：
Edit 工具原位更新已有文件，最小 diff### {组名} 列表末尾追加 - [[新笔记]]updated: 字段为当前日期updated: 日期并告知用户当用户对已有 MOC 执行 /update --mode refresh 时，触发本技能的修改模式：
updated 字段. 开头）