扫描 Obsidian vault 中所有失效的 [[双链]]（目标文件不存在），呈现死链清单，提供删除链接、创建占位笔记、替换为正确链接三种修复方式。触发时机：用户发现链接失效、手动删除文件后需清理、定期 vault 健康检查时。
扫描 Obsidian vault 中所有失效的 [[双链]]（目标文件不存在），呈现死链清单，提供删除链接、创建占位笔记、替换为正确链接三种修复方式。触发时机：用户发现链接失效、手动删除文件后需清理、定期 vault 健康检查时。
npx skills add https://github.com/Treasoni/Study-Notes --skill fix-broken-links이 명령을 Claude Code에 복사하여 붙여넣어 스킬을 설치하세요
| name | fix-broken-links |
| description | 扫描 Obsidian vault 中所有失效的 [[双链]]（目标文件不存在），呈现死链清单，提供删除链接、创建占位笔记、替换为正确链接三种修复方式。触发时机：用户发现链接失效、手动删除文件后需清理、定期 vault 健康检查时。 |
用户发现链接失效、手动删除了文件需要清理残留链接、或定期 vault 健康检查时。
ls 检查）使用 Grep 在扫描范围内搜索所有 [[...]] 模式：
Grep pattern="\[\[.*?\]\]" path="{scope}" output_mode="content" -n
对每条匹配结果，提取并记录：
| 字段 | 提取方式 |
|---|---|
| 源文件路径 | Grep 返回的文件名 |
| 行号 | Grep 返回的行号 |
| 原始链接文本 | 完整的 [[...]] 部分 |
| 链接目标 | 去掉别名 |...、去掉锚点 #...、去掉嵌入前缀 ! |
| 是否有别名 | 链接中含 | 则为 true |
| 是否有锚点 | 链接中含 # 则为 true |
去重： 同一链接目标（标准化后的小写文件名）只验证一次，但保留每条引用记录。
对每个唯一的链接目标，在 vault 中搜索对应的 .md 文件：
3a. 精确匹配：
{VAULT_PATH}/**/{target}.mdfind 搜索3b. 若精确匹配失败，模糊搜索：
subfolder/target），在对应子目录下搜索**/*{target}*.md 宽松匹配状态标记：
✅ 存在 — 目标文件找到，链接有效❌ 目标不存在 — 完全找不到对应文件⚠️ 模糊匹配 — 找到 N 个可能的目标🔗 有效（忽略） — 存在，跳过只展示状态为 ❌ 和 ⚠️ 的条目：
## 失效链接报告
- 扫描范围：`{scope}`
- 总链接数：{total} 处
- 失效：{broken} 处（涉及 {N} 个文件）
- 模糊匹配：{ambiguous} 处
| # | 源文件 | 行号 | 失效链接 | 状态 |
|---|--------|------|---------|------|
| 1 | Notes/A.md | L12 | [[Deleted-Note]] | ❌ 目标不存在 |
| 2 | Notes/B.md | L5 | [[old/OldNote]] | ❌ 目标不存在 |
| 3 | Notes/C.md | L8 | [[Renamed]] | ⚠️ 找到 2 个候选 |
若没有失效链接 → 告知用户"所有链接有效"，结束。
呈现每条失效链接，逐一或批量询问修复方式：
四种策略：
delete — 移除死链（从源文件的该行删除链接语法）stub — 创建占位笔记 {target}.md，内容为 > 待补充，让链接变有效replace:新目标 — 替换链接为 [[新目标]]（用户指定正确的目标笔记名）skip — 暂时保留，不做处理批量选择语法示例：
1-3 delete ← 删除 #1 到 #3 的死链
4 stub ← 为 #4 创建占位笔记
5 replace:Hooks ← 将 #5 的链接替换为 [[Hooks]]
6-8 skip ← 跳过 #6 到 #8
对模糊匹配（⚠️）的条目，先展示候选列表让用户确认：
#3 [[Renamed]] 可能指向：
a) Notes/React/RenamedNote.md
b) Notes/Vue/RenamedGuide.md
请选择正确的目标（a/b），或手动输入。
按用户选择的策略逐条处理：
delete 策略：
- [[BrokenLink]]）→ 使用 Edit 删除整行详见 [[BrokenLink]] 了解更多）→ 仅移除 [[BrokenLink]]，保留周围文字[[BrokenLink\|旧文档]]）→ 移除整个链接语法，保留别名文本stub 策略：
---
tags: [stub]
created: {YYYY-MM-DD}
---
# {title}
> 此笔记由 [[fix-broken-links]] 自动创建。原内容待补充。
replace 策略：
[[旧目标]] 替换为 [[新目标]][[旧目标\|别名]] → 保留别名：[[新目标\|别名]][[旧目标#heading]] → 保留锚点（前提新目标有对应标题，否则仅替换目标名）每修复一条报告：[N/M] {策略}: {源文件} — 完成
## 修复完成
| 策略 | 数量 |
|------|------|
| 🗑️ 删除死链 | N |
| 📝 创建占位笔记 | M |
| 🔗 替换链接 | P |
| ⏭️ 跳过 | Q |
| **合计处理** | **{total}** |
所有失效链接已处理。
美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。
写笔记阶段。根据整理好的资料和用户偏好的笔记类型（概念/实战/对比/速查/心得），选择模板，提取关键信息，用学习者友好的语言生成笔记初稿。触发时机：用户审核通过 curate 产出后（研究驱动型），或用户审核通过 review 产出后（心得笔记），Phase 3。
安全删除 Obsidian 笔记文件。删除指定文件前自动搜索全库 [[双链]] 引用，清理所有指向该文件的链接，经用户确认后执行删除。触发时机：用户要求删除笔记、清理文件、移除内容时。
分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。
扫描目录生成 Obsidian MOC（Map of Content）索引笔记，包含按子目录分组的 wikilink 列表和 Mermaid 结构图。触发时机：用户要求创建 MOC、索引文件夹、映射目录结构、或导航 Obsidian vault 中的笔记时。
美化排版阶段。套用 Obsidian Markdown 规范，添加双链、标签、Callout 块、Mermaid 图表、YAML frontmatter 等 Obsidian 特性，优化段落长度和术语一致性。触发时机：用户审核通过 write 产出后，Phase 4。