分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。
分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。
npx skills add https://github.com/Treasoni/Study-Notes --skill generate-linksこのコマンドをClaude Codeにコピー＆ペーストしてスキルをインストール
| name | generate-links |
| description | 分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。 |
用户希望为某个文件夹内的笔记自动建立 [[双链]] 关联时。
ls 检查）.md 文件（否则无配对可能，提前终止）用 find 或 ls 获取目录下所有 .md 文件，排除：
. 开头）MOC.md 或 _index.md 文件对每个文件提取以下元数据：
.md）：作为 wikilink 目标和显示名tags：读取 YAML frontmatter 中的 tags 字段，处理 [tag1, tag2] 和 - tag1\n- tag2 两种格式# 开头的行，作为笔记标题[[...]] 的目标（不含别名、锚点），去重得到已有链接集合## 和 ### 标题中提取名词短语（中英文均可），过滤停用词（如"概述""总结""前言""参考"等无实质内容的标题）对所有文件两两配对（N 个文件产生 N×(N-1)/2 个配对）。
Pass A: Tag 重叠得分
[react, hooks, frontend]，B 的 tags: [react, typescript]
共享 react → +3 分Pass B: 内容相似度得分
总分 = Pass A + Pass B
相关性判定： 总分 ≥ 阈值（默认 3 分）的配对为"相关"
对每个相关配对：
[[B]] 且文件 B 已有 [[A]]，跳过- [[Other Note]] — {理由简述}
共享 tag: #react、涉及概念: useEffect、同一主题链接插入位置：
## 相关笔记 小节 → 追加到该小节末尾## 参考 / ## 来源 之前，若有的话）创建：
## 相关笔记
- [[Other Note]] — {理由}
以表格呈现所有配对：
## 链接方案
文件夹：`path/to/folder/`
文件数：N，配对总数：P，相关配对：R
| # | 文件 A | 文件 B | 得分 | 理由 |
|---|--------|--------|------|------|
| 1 | React Hooks | useEffect 详解 | 7 | 共享 #react, #hooks; 共有 useEffect |
| 2 | 组件设计 | React Hooks | 4 | 共享 #react; 共有组件 |
| ... | ... | ... | ... | ... |
询问用户：
对每个批准的配对：
Read 确认文件当前内容（避免 stale context）Edit 工具精确插入链接行最小 diff 原则： 只插入新行，不修改文件其他任何部分。
## 链接生成完成
- 分析文件：N 个
- 发现相关配对：R 个
- 实际添加链接：M 个（跳过已存在的 S 个）
- 涉及文件：K 个
## 相关笔记 小节追加 [[wikilinks]]）## 相关笔记 小节外的任何内容美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。
写笔记阶段。根据整理好的资料和用户偏好的笔记类型（概念/实战/对比/速查/心得），选择模板，提取关键信息，用学习者友好的语言生成笔记初稿。触发时机：用户审核通过 curate 产出后（研究驱动型），或用户审核通过 review 产出后（心得笔记），Phase 3。
扫描 Obsidian vault 中所有失效的 [[双链]]（目标文件不存在），呈现死链清单，提供删除链接、创建占位笔记、替换为正确链接三种修复方式。触发时机：用户发现链接失效、手动删除文件后需清理、定期 vault 健康检查时。
安全删除 Obsidian 笔记文件。删除指定文件前自动搜索全库 [[双链]] 引用，清理所有指向该文件的链接，经用户确认后执行删除。触发时机：用户要求删除笔记、清理文件、移除内容时。
扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。
美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。