alfredzhang98/research-obsidian-skill

ai-wiki — 将内容归档到知识库（轻量级，默认命令）

将“把这个写下来”变成 AI 管理文件夹中一个命名正确、链接正确的笔记。

此命令不创建主题。 它只生成一条笔记，并且要求至少包含一个指向现有笔记的 [[wikilink]]。若要将笔记放置在主题枢纽下并创建双向链接，请使用 /ai-wiki-full。

为什么默认不创建主题：当每篇论文都拥有自己的枢纽时，这个枢纽就不再是组织工具——它只是给论文起了一个更长的名字。主题是一个研究方向，而不是论文的学科。判断标准见 references/note-specs.md 中的“什么才算是一个主题”。

输出位置

此技能归档的所有内容都放置在 AI 管理的文件夹中。

区域	处理方式
AI 管理文件夹 (<AI_WIKI>/**)	创建 / 编辑 / 移动 / 重命名 / 删除 — 完全自由
用户自己的笔记文件夹	自由读取和搜索；允许追加编辑；删除、重命名、移动或覆盖前必须询问
.claude/rules/, CLAUDE.md	静态配置 — 仅在用户要求更改 Claude 行为时编辑；更新 updated: 字段。唯一的动态例外是 .claude/rules/active.md
.obsidian/, .trash/	可访问但不可操作——编辑 Obsidian 配置可能破坏仓库

权限层面没有任何限制，因此上述约束依赖于判断力。仓库通常不是 git 仓库；对手写笔记的错误覆盖只能通过文件同步历史版本恢复。

从这些区域读取内容并将摘要归档到 AI 管理文件夹中，正是本技能的用途。

参考文件 — 按需阅读，无需全部读取

文件	何时阅读
references/vault-guide.md	决定哪个文件夹 — 路由表、用户示例表述、标签/维基链接模型
references/note-specs.md	编写论文笔记、学习笔记或主题计划时 — 文件名、前置元数据、章节规范、措辞规则
references/figures-diagrams.md	笔记需要图表时 — 提取命令、嵌入格式、mermaid 规则
references/tools.md	选择哪个技能或 CLI 处理输入内容，以及端到端工作流程

常规归档（只有一个明确的文件夹，无图表）无需阅读上述任何文件——下面的流程已足够。

操作流程

1. 分类 — 从 references/vault-guide.md 的路由表中选择恰好一个目标文件夹。一条内容一个文件夹；任何跨领域的内容通过 tags: 和 [[wikilinks]] 处理，绝不重复复制。
   • 未提交的、探索性的或批量内容放入 Inbox/，而非真实文件夹。
   • 在两个文件夹之间确实难以抉择：询问用户，不要猜测并重复。
2. 命名 — 依照 references/note-specs.md（小写 kebab-case）：
   • 论文 → Research/papers/<第一作者姓氏>-<年份>-<2-3关键词-短横线>.md（此命令不创建主题，因此笔记放置在 papers/ 根目录下；/ai-wiki-full 会将其放置在 papers/<主题-slug>/ 下）
   • 学习笔记 → Research/learning/<主题-slug>-<YYYYMMDD>.md
3. 首先检查现有笔记 — 在写入前使用 Glob 搜索目标文件夹（论文使用 Research/papers/**/*.md；注意按主题划分的子文件夹）。更新正确的笔记胜过创建近似的重复；如果已有一篇，则合并进去并告知用户。
4. 填充 — Read Templates/ 中匹配的模板（paper-note.md / learning-note.md）并就地填充；绝不要凭记忆重建结构。章节指导在 references/note-specs.md 中，不在模板的 {{...}} 提示里。
   • > [!callout] 块是强调系统——保留它们，不要添加新类型。
   • 顶部的快速卡片最后编写：它压缩了整个笔记。如果它的六行内容无法填满，说明下面的笔记尚未完成。
   • S0“这篇论文做了什么，用通俗语言解释”是强制性的：3-5句话，面向熟悉该领域基础知识但未读过此论文的人。顺序：他们面临的情景，他们构建了什么，为什么有效，他们得到了什么。如果你无法写出这一节，说明你尚未理解论文——停止并重新阅读，不要继续。
   • 论文笔记的回答顺序为：S0 通俗语言 → S1 背景 → S2 先前工作未能做到什么 → S3-S4 方法和数学 → S5 运行了什么 → S6 得到了什么 → S7 局限性和作者的未来工作 → S8 我的分析和研究机会。
   • S2 和 S8 是笔记存在的意义——两者都不能用泛泛而谈的内容填充。S4 的数学必须能从笔记中重构出来，而不仅仅是可识别。
   • 每个 S8 机会包含全部四行（机会 → 为何仍未解决 → 首个实验 → 放在哪个主题下）。“没有值得把握的机会——<原因>”是有效的；编造一个机会则不然。
   • 专业措辞：不要使用隐喻性标签（“这篇论文的切割点”、“结论”、“最强数字”）。详见 references/note-specs.md 中的措辞表。每个判断必须基于具体证据。
   • 在写作前阅读论文。绝不要仅从摘要填充章节；如果 PDF 文本不可用，编写 {{在来源中不可用}} 而非填充看似合理的内容。
5. 图表 — 依照 references/figures-diagrams.md：论文图表通过 paper-figures 技能放入 _attachments/paper-figures/<论文-slug>/（附件树保持扁平，绝不镜像到主题文件夹中），嵌入在该图表发挥作用的章节处。
   • 嵌入前缀取决于笔记的深度：在 papers/ 根目录下使用 ../../_attachments/...，在 papers/<主题-slug>/ 内使用 ../../../_attachments/...。这是一项在笔记移动时会静默失败的事情——请抽查一张图片。
   • 作者绘制的图表使用 mermaid 代码块。禁止使用 ASCII 艺术。
6. 链接（强制，至少一个） — 笔记必须至少包含一个指向现有笔记的 [[wikilink]]：Research/topics/ 中的枢纽、另一篇论文笔记或学习笔记。
   • 首先使用 Glob 搜索 Research/topics/ 和 Research/papers/，选择最近的目标，并用一句话说明关系，而不是丢弃一个孤立的链接。
   • 此命令不创建主题。 如果确实没有可链接的内容，在 .claude/rules/active.md 中标记此内容开启了一个新领域，并告知用户 /ai-wiki-full 是构建枢纽的命令。
   • 当笔记确实属于现有主题时，将该正向链接添加到该主题的 S6 列表中——双向链接是形成图谱聚簇的关键。
7. 注册 — 如果此内容开启了新方向或是进行中的工作，在 .claude/rules/active.md 中添加一行指向，并更新其 updated: 字段。不要在那里镜像状态。active.md 是本工作流程中唯一一个无需明确请求更改配置即可触碰的规则文件。

完成前的自我检查

• 写入的每个路径都在 AI 管理的文件夹内
• 文件名符合其笔记类型的规范；论文笔记位于 papers/ 根目录（此命令不创建主题）
• 嵌入前缀与笔记的深度匹配，且至少抽查了一张图片
• 前置元数据完整（tags: 存在且具体，而不仅仅是 research/）
• 至少有一个指向现有笔记的 [[wikilink]]，并说明了关系
• 基于实际模板文件构建，章节顺序和标注框完整
• S0 通俗语言摘要已填写，没有术语堆砌
• 快速卡片最后编写；所有六行都是具体陈述，且能独立存在
• 交付的笔记中没有残留的 {{占位符}}
• 没有隐喻性标签
• 图表已行内嵌入，而非堆放在末尾
• 论文笔记： S2 提及了实际的前期方法及其具体失败；S7 区分了作者声明的 / 我发现的 / 作者的未来工作；S8 的结论引用了证据，每个机会包含全部四行
• 学习笔记： S1 是用户问题的原样复制；S5 包含真实的数字示例
• 告知了用户写入的确切路径

相关命令

要创建或查找带有双向链接的主题枢纽，请使用 /ai-wiki-full。 根据输入类型选择工具：references/tools.md。完整区域规则：.claude/rules/permissions.md。