obsidian-study-vault-builder

Obsidian Study Vault Builder

試験対策に適した学習用 Obsidian Vault を構築するための包括的なパターン

実際のプロジェクトから得られた体系的なエラー防止、品質保証、効率化のパターンを活用し、構造化されたモバイル対応の学術学習用 Vault を構築します。

⚠️ 重要：828KB／37 ファイルの Vault プロジェクトで実証済みのパターンについては、REFERENCE.md を参照してください。

このスキルを使う場面

次のような Obsidian の学習教材を作成するときに呼び出します。

• 期末試験の準備（あらゆる科目）
• コース知識の整理（CS、医学、ビジネス、法律など）
• 独学教材の構成
• 技術ドキュメント用 Vault
• 大規模な学習プロジェクト（10 ファイル以上、200KB 以上）

あらゆる科目に対応します：

• コンピューターサイエンス（アルゴリズム、データ構造、システム）
• 医学（解剖学、薬理学、病理学）
• ビジネス（金融、マーケティング、オペレーション）
• STEM（物理学、化学、工学）
• 人文科学（歴史、文学、哲学）

---

基本的な方法論

チェックポイントベースのワークフロー（重要）

最初にすべての章を生成してはいけません。 段階的に検証します。

1. 第 1 章を生成 → 停止
2. ユーザーが確認 → 形式、構成、品質を承認
3. 第 2 章から N 章まで → 検証済みのパターンに沿って続行
4. 最終 QA → 体系的に確認

これが重要な理由：

• 30 ファイル以上に広がる前に、形式の問題を発見できます
• 早い段階で、進め方がユーザーのニーズに合っているか確認できます
• 修正コストが低い段階（第 1 章）で軌道修正できます。第 8 章ではコストが高くなります
• 5 時間以上の手戻りを防げます

所要時間の内訳： 第 1 章（約 30 分）→ 確認（約 15 分）→ 残り（約 90 分）→ QA（約 30 分）＝ 手作業の 80 時間に対し 2.5 時間

メモリファイルの階層

3 段階のコンテキスト構造（詳細は REFERENCE.md を参照）：

• レベル 1： ルート Vault（CLAUDE.md）
• レベル 2： 科目フォルダー（School/CLAUDE.md）
• レベル 3： コースプロジェクト（School/algorithms/CLAUDE.md）

---

Obsidian の汎用機能（モバイルファースト）

✅ 使用する機能： Mermaid 図、LaTeX 数式、標準コールアウト、内部リンク、表、コードブロック
❌ 使用しない機能： Dataview クエリ、カスタムコールアウト、プラグイン

詳しいパターンは REFERENCE.md を参照してください。

---

エラーパターンの認識（8 パターン）

パターン 1：Mermaid 内の Unicode 文字化け

• 症状： 図がレンダリングされない
• 診断： grep -r "≤\|≥\|∞\|∈\|≠\|→" *.md
• 修正： ASCII に置き換えます（<=、>=、infinity、in、!=、->）

パターン 2：表の破損（LaTeX のパイプ）

• 診断： grep -r "| \$.*|.*\$" *.md
• 修正： パイプをエスケープします：| → \|

パターン 3：折りたたみ可能な解答の欠落

• 診断： grep -A 5 "## Problem" practice-problems.md | grep -v "\[!example\]-"
• 修正： > [!example]- Solution を使用します

パターン 4～8：REFERENCE.md を参照

• ナビゲーションの不整合
• 学習目標の欠落
• 目次の不整合
• 核心概念の未記入
• 相互参照の破損

体系的な修正方法の全容は REFERENCE.md を参照してください。

---

コンテンツの品質パターン

応用理解（暗記ではなく）

良い問題の例：

• 「[コンテキスト] に適した [システム] を設計してください。現在の [問題] を踏まえ、[目標] を達成する解決策を説明してください。トレードオフを分析し、理由を述べてください。」

科目に応じて調整します：

• CS：アルゴリズム設計のシナリオ
• 医学：症例に基づく診断
• ビジネス：戦略分析
• 物理学：実験設計

網羅的なカバー範囲

原資料にあるすべてのトピックを含める必要があります。検証するには、原資料のアウトラインと Vault の目次を照合します。

相互参照のパターン

関連する概念は、すべての箇所で [[links]] を使ってリンクします。

詳しい例は REFERENCE.md を参照してください。

---

標準的な Vault の構成

course-name/
├── 00-overview/          # Course map, schedule, strategy
├── 01-chapter-name/      # Core concepts, quick-ref, practice
├── cross-chapter/        # Comparisons, patterns, catalog
└── mock-exams/           # Practice tests + solutions

---

品質保証（概要）

完了とする前に、次の項目を確認してください。

• 構成の一貫性（ナビゲーション、学習目標、目次）
• コンテンツの網羅性（すべてのトピックをカバーしている）
• 形式の正確性（Mermaid に Unicode が含まれていない、LaTeX のパイプがエスケープされている）
• モバイル対応（プラグインを使用していない）
• 評価との整合性（練習問題が試験形式に沿っている）

50 項目以上の完全なチェックリストについては、REFERENCE.md を参照してください。

---

よくあるアンチパターン

1. 「あとで直します」 → すぐに直す
2. チェックポイントを設けずに生成する → 第 1 章 → レビュー → 続行
3. モバイルユーザーを忘れる → すべての環境で使える機能のみを使用する
4. 表面的な練習問題 → 推論を伴うシナリオ形式にする

---

成功指標

一般的なプロジェクト：

• ファイル数：30～40
• サイズ：600～900KB
• 網羅率：ソースのトピックを 100％網羅
• レンダリングエラー：0
• 削減できる時間：80 時間以上
• 練習問題：80～100 問
• 模擬試験：2～3 回

---

統合パターン

大規模な分析のためのタスクエージェント

100 ページ以上の資料には、subagent_type=Explore を指定して Task ツールを使用してください。

Git ワークフロー

git commit -m "Initial vault structure"
git commit -m "Complete Chapter 1 (checkpoint)"
git commit -m "Complete: Study vault (37 files, 828KB)"

---

CLI 統合

Obsidian CLI（v1.12 以降）は、特定の操作において Write ツールを補完します。Obsidian アプリの実行が必要です。

CLI と Write ツールの使い分け

操作	ツール	理由
新規ファイルの一括作成	Write tool	高速で、シェルのオーバーヘッドやエスケープが不要
フロントマターの設定／読み取り	CLI property:set/property:read	YAML をネイティブに処理
既存ファイルへの追記	CLI append/prepend	Obsidian に対応し、インデックスを即時更新
ビルド後の QA	CLI search, unresolved, orphans	Obsidian のライブインデックスを使用
Vault の状態確認	CLI files total, vault, sync:status	Obsidian のメタデータに直接アクセス

ビルド後の検証

問題を検出するため、Vault の生成後に実行してください。

obsidian.com files folder=<course> total        # Verify file count matches expected
obsidian.com tags counts                        # Verify tags are populated
obsidian.com unresolved                         # Find broken [[wiki-links]]
obsidian.com orphans                            # Find files with no incoming links
obsidian.com deadends                           # Find files with no outgoing links
obsidian.com search query="TODO"                # Catch unfinished placeholders

フロントマターの操作

プロパティを操作する場合は、YAML を手動で編集する代わりに CLI を使用してください。

obsidian.com property:set name=tags value="[exam-prep,chapter-1]" type=list path=<file>
obsidian.com property:set name=status value=draft path=<file>
obsidian.com property:read name=tags path=<file>

差分更新

既存の Vault ファイルをすべて書き直さずにコンテンツを追加する場合：

obsidian.com append path=<file> content="## New Section\n..."
obsidian.com daily:append content="- [ ] Review chapter 3"

同期状態の確認

大規模な操作の前後に、同期状態を確認してください。

obsidian.com sync:status    # Verify sync is not paused before starting vault build

---

その他のリソース

REFERENCE.md の内容：

• Obsidian の汎用機能に関する完全なドキュメント
• 詳細な Mermaid 図のパターン（フローチャート、マインドマップ、グラフ、再帰木）
• 表内のエスケープを含む、詳細な LaTeX 表記パターン
• 解答を折りたたむ完全なテンプレート
• 例を含む 50 項目以上の品質保証チェックリスト全文
• 分野別の応用例（CS、医学、ビジネス、人文科学）
• 手順をすべて示したワークフローの例
• エラーパターンの認識（例を含む 8 つのパターンすべて）
• 体系的な修正アプローチ（5 ステップのプロセス）
• 効果的なコミュニケーションパターン
• 避けるべきアンチパターン
• 作業時間の内訳

---

以下の実績に基づいて検証済みです：

• 37 ファイルの学術用 Vault
• 828KB の包括的な内容
• 複数の分野（CS、工学、ビジネス）
• レンダリングエラーゼロを達成
• プロジェクトごとに約 80 時間の手作業を削減

体系的な品質保証により、あらゆる分野の試験対策用学習 Vault を作成できます。