SuperAPI AI 工具集

vault-mocs

智能体与模型

查看项目

更新于 10-16 06:22

技能介绍

用途:为 Obsidian 仓库按标签类别创建或扩展内容地图(MOC),这也是成熟仓库的主要导航入口,比标签更实用、比搜索更易发现。也可把孤立的单条笔记接入已有枢纽,迁移旧版 MOC 标签,以及审计 MOC 覆盖率。

规范形态:frontmatter 中标签必须精确为 📝/moc,文件位于 Zettelkasten/(个人)或 work/MOC/(工作),文件名为“{Subject} MOC.md”(后缀式),正文为一段描述加 ## 小节与 wikilink 列表,不应含 id 等旧版 frontmatter。

主要能力:把 legacy 🗺️ 标签改写为 📝/moc;去重 [🗺, 📝/moc];把误放在 work/z/ 的 MOC 移到 work/MOC/;在 basename 唯一时把 [[Kanban/Foo]] 这类路径限定链接改写为 [[Foo]]。覆盖率分析可通过 vault-agent 的 mocs.analyze_mocs 报告未被任何 MOC 链接的已打标签笔记,区分缺失 MOC、陈旧 MOC、标签不匹配三种情况。

使用方式:创建新 MOC 的启发式阈值为同类标签笔记达到 10 条以上、尚无 MOC 覆盖、且主题足以归入同一枢纽;满足后创建文件并挑选 2–4 个 ## 小节,避免过深层级。扩展已有 MOC 时先读 MOC 找最合适小节,每个 wikilink 一行并按小节内字母排序,描述保持简短。提交信息示例:feat(mocs): add {Category} MOC covering N notes。

离线回退:Obsidian 关闭时,数据源改为直接用 Glob/Grep 解析 .md 语料:读取每个笔记的首尾 --- 之间的 YAML 提取 tags、aliases、context;匹配 [[Target]]、[[Target|Alias]]、[[Target#Heading]]、[[folder/Target]]、![[embed]],按 basename、相对路径、frontmatter 中的 alias 三级、大小写不敏感解析;附件目录从 .obsidian/app.json 的 attachmentFolderPath 读取,未设置时回退到仓库根目录或 Files/。

限制与注意:不要创建 MOC 的 MOC,除非仓库已有 20+ MOC;不要用 Dataview 生成替代人工挑选的主内容;不要把 📝/moc 加在并非 MOC 的笔记上;未更新所有链接前不要重命名已有 MOC;未经用户输入不要改动 MOC 的小节结构,添加链接时保留用户现有排序;不要链接主题明显不符的笔记。相关技能:vault-orphans、vault-tags、vault-wikilinks。