obsidian-vault-exporter

Obsidian Vault エクスポーター

概要

このスキルは、Research Agent がリサーチ成果物（文献ノート、論文比較マトリクス、リサーチ統合、仮説、投稿先ジャーナルの提案）をすべて、Obsidian Vault（セカンドブレイン）に取り込めるインタラクティブなノートに変換・整理できるよう支援するために設計されています。エージェントは、構造化された YAML Frontmatter を自動で作成し、双方向 WikiLinks（[[Note Name]]）を追加し、カスタムタグを付与して、豊富で検索しやすいリサーチの ナレッジグラフ を構築するための Dataview クエリ スクリプトを提示します。

依存関係

• extract-methodology
• paper-matrix-builder
• synthesize-research

クイックスタート

使用例： 「この文献レビューと論文マトリクスの全成果を、Frontmatter、論文間の WikiLinks、Dataview クエリを含む完全な Obsidian Vault 構造に整形してください。」

ワークフロー

1. ファイルと Vault 構造の検出

• 処理するリサーチ文書の種類を特定します（例：文献ノート、統合ノート、リサーチギャップ分析、または ワークフロー全体のエクスポート）。
• ユーザーが指定していない場合は、標準的な Obsidian フォルダー階層を決定します。例：
  • Vault/Literature/（個々の論文ノート用）
  • Vault/Gaps & Hypotheses/（リサーチギャップと仮説用）
  • Vault/Synthesis/（統合と比較マトリクス用）
  • Vault/Manuscript/（原稿のメインドラフト用）

2. 構造化された YAML Frontmatter の作成

• 各 Markdown ファイルの先頭に YAML Frontmatter のエントリーを作成します：

  ---
  title: "Judul Catatan / Paper"
  aliases: ["Alias 1", "Shorthand"]
  tags:
    - research/literature
    - status/processed
    - quartile/q1
  authors: ["Author 1", "Author 2"]
  year: 2026
  doi: "10.xxxx/xxxxx"
  quartile: "Q1"
  sinta_rank: "S1"
  created: 2026-07-15
  ---
  

3. テキストリンクを双方向 WikiLinks に変換

• 通常のテキスト参照を Obsidian の双方向 WikiLinksに変換します：
  • 論文への参照：[Smith et al., 2025] $\rightarrow$ [[Literature Note - Smith 2025]]
  • リサーチギャップへの参照：Research Gap 1 $\rightarrow$ [[Gap - Low Resource Paraphrasing]]
  • 手法への参照：Transformer Model $\rightarrow$ [[Method - Transformer Architecture]]

4. Dataview クエリとビジュアル図の作成

• インデックス／概要ノートに、そのまま使える Dataview コードブロックを含めます：

  TABLE authors, year, quartile, doi
  FROM "Literature"
  WHERE quartile = "Q1"
  SORT year DESC
  

• 概念フレームワークの図はすべて、Obsidian がネイティブにサポートする Mermaid 構文で記述します。

5. 認証情報のセキュリティ監査と出力ファイルの検証

• API トークン、プライベート認証情報、またはワークスペース外の機密性の高いローカルパスが、Frontmatter やノートの内容に含まれていないことを確認します。
• エクスポートした Markdown 文書を提示します。ユーザーの Obsidian Vault にそのままコピー＆ペーストするか、直接保存できます。

よくある間違いと重要なルール

• WikiLinks の構文が壊れている：WikiLink 名に余分なスペースや使用できない文字を含める（例：[[ Literature Note ]] や [[File/Path:Invalid]]）。
• YAML Frontmatter が無効：YAML ブロックを --- で閉じ忘れる、または YAML 仕様に違反するインデント構文を使用する。
• 機密パスの漏えい：認証情報やローカルユーザー名を含むシステムの絶対ローカルパスを公開する。
• 独自 Markdown 形式：Obsidian のネイティブ Markdown 表示でサポートされていない、または表示を壊す複雑な HTML タグを使用する。