菜单
分析指定文件夹内的 Obsidian 笔记，基于共享 tags 和内容相似度自动识别相关笔记对，生成 [[双链]] 互链。触发时机：用户要求建立笔记关联、生成文件夹内链接、连接相关内容时。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
多篇既有学习笔记的批量更新编排。用于用户想一次更新一个目录、文件列表、Obsidian vault 子目录或多篇旧笔记，例如“批量更新这些笔记”“多篇笔记过时了”“把一组笔记更新到新版本”“refresh multiple notes”。先生成更新清单和批量计划，经用户确认后逐篇调用 note-updater 局部 patch，避免全文重写和批量误覆盖。
旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。
学习笔记需求澄清与引导。分析用户学习需求，引导明确学习目标和方向，调用 workflow-orchestrator 生成项目结构。触发词：想学、帮我整理、研究一下、了解一下、不知道从哪开始、research planning、explore topic。
业务工作流实例化器。由 planner 技能调用，接收 workflow_id、topic、project_slug 等参数，按 .claude/workflows/{workflow-id}/state-template.md 生成 workspace/workflow-runs/{run-id}.workflow.md。不直接面向用户；通用状态格式和状态流转由 workflow-todo-state 负责。
Create or retrofit reusable named workflow state machines for multi-step agent projects. Use when a project needs recoverable workflow state files, multiple workflow definitions, phase gates, restart-safe agent workflows, explicit skipped/blocked states, workflow routing rules, or reusable workflow templates across repositories.
自我学习阶段。回顾本次学习会话，记录学习心得和错误到 .claude/rules/learnings/，当文件超阈值时自动压缩去重，更新 RULES.md，促进系统持续改进。
| 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]]）## 相关笔记 小节外的任何内容