obsidian

Obsidian 連携

Obsidian の Markdown ベースのシステムを使用して、ノートの作成、タスク管理、ナレッジの整理など、Claude のワークフローを Obsidian と連携するための専門的なガイダンスです。

このスキルを使う場面

• Claude との開発セッション中にノートを作成する
• Obsidian でタスクや TODO を管理する
• Claude と発見した意思決定や解決策を記録する
• プロジェクトの知見を蓄積するナレッジベースを構築する
• Claude とのセッションで得た調査結果を整理する
• 議事録やセッションの概要を作成する

補助ファイル

このスキルはいくつかのファイルに分かれています。必要に応じて関連ファイルを読み込んでください。

• best-practices.md - MOC、プロパティ、整理の考え方、dump タグの要件
• templates.md - ノートテンプレート：セッション、技術、タスク、分析計画、テーマ別リファレンス、TODO、HOME.md
• organization-patterns.md - ホーム MOC、プロジェクト MOC、TODO の統合、アーカイブ戦略、プロジェクト間のリンク
• vault-management.md - Vault の再編成、セッションの統合、リンク管理、プロジェクトディレクトリの設定、ブレインダンプの処理
• reference.md - Obsidian の Markdown 構文、bash ヘルパー、プラグイン、Claude 連携パターン、トラブルシューティング
• cli-reference.md - Obsidian CLI（1.12 以降）のコマンドリファレンス。多くの bash パターンを置き換えます
• changelog.md - バージョン履歴

基本原則

1. CLI を優先する - 可能な場合は bash/cat パターンより obsidian CLI コマンド（1.12 以降）を使用します。cli-reference.md を参照してください
2. Vault の場所 - ファイルに直接アクセスする場合は $OBSIDIAN_VAULT 環境変数を使用します。CLI では vault=<name> オプションを使用します
3. ノートの保存場所は必ずユーザーに確認する - 事前にユーザーへ尋ねずに、ノートの保存場所を決めてはいけません。Vault の構造を示して選択肢を提案し、ユーザーに選んでもらいます。
4. アトミックなノート - 各ノートは単一の概念またはトピックに焦点を当てます
5. リンク - 関連するアイデアをつなぐには、ウィキリンク [[note-name]] を使用します
6. タグ - #project/feature のような階層タグで整理します
7. タスク - 実行可能な項目にはチェックボックス構文を使用します
8. タイムスタンプ - 時系列の文脈を把握できるよう、日付を含めます

重要なルール

ルール 1：ノートの保存場所を決めつけない

重要：Obsidian でノートを作成するときは、必ず保存場所をユーザーに尋ねてください。明らかに思える場合でも、自分で場所を決めてはいけません。

理由：Vault の整理方法を把握しているのはユーザーです。保存場所を決めつけると、後でユーザーが整理し直す必要が生じます。

あらゆるノート作成でのワークフロー：

1. ユーザーが判断できるように、現在の Vault の構造を示す
2. 選択肢（ルート階層、特定のフォルダー、カスタムパス）を提案する。場所は決めない
3. 書き込みを始める前に、ユーザーの指示を得る
4. 選ばれた場所に作成する

唯一の例外：.claude/project-config に、以前ユーザーが選択した保存場所がすでに指定されている場合の、プロジェクトのセッションノート。

鉄則：Obsidian Vault にファイルを書き込もうとしている場合は、いったん止まり、まず保存場所をユーザーに尋ねてください。

ルール 2：セッションノートには必ず Dump タグを含める

セッションノートや日次ノートには、必ず dump タグを含めてください。これは次の用途に不可欠です。

• プロジェクトを横断してすべてのセッションノートを絞り込む：tag:#dump
• /consolidate-notes によるアーカイブのワークフロー
• 作業中のノートと恒久的なドキュメントの切り分け

新しいセッションファイル用の Python テンプレート：

f.write("---\n")
f.write("type: session\n")
f.write(f"project: {PROJECT_NAME}\n")
f.write(f"date: {date_str}\n")
f.write("tags:\n")
f.write("  - session\n")
f.write("  - dump\n")  # REQUIRED
f.write("status: completed\n")
f.write("---\n\n")

ルール 3：必ずプロパティ（フロントマター）を追加する

すべてのノートには、最低限、次の YAML フロントマターを含める必要があります。

---
type: session | planning | reference | todo | moc | development | analysis
project: project-name
status: active | in-progress | completed | archived
tags:
  - relevant-tags
created: YYYY-MM-DD
---

プロパティの完全なスキーマについては、best-practices.md を参照してください。

ルール 4：深いフォルダー階層より MOC を使う

• フォルダー構造は浅く保ちます（最大 2～3 階層）
• ナビゲーションのハブとして、Maps of Content（MOC）ノートを使います
• MOC の項目数は 25 未満に保ちます
• セクションが大きくなりすぎたら、サブ MOC を作成します
• トピックの分類にはフォルダーではなく、プロパティとタグを使います

MOC の詳しいガイダンスについては、best-practices.md を参照してください。

Vault の設定

環境の設定

# Check vault location
echo $OBSIDIAN_VAULT
# Should return something like: /Users/username/Documents/Notes

# If not set, add to ~/.zshrc or ~/.bashrc
export OBSIDIAN_VAULT="/path/to/your/vault"

Obsidian CLI（1.12+）

Obsidian にはネイティブ CLI（obsidian）が搭載されました。ノートの作成、読み取り、追記、検索には、bash のパターンより CLI コマンドを優先してください。

# Verify CLI is available
obsidian version

# List vaults
obsidian vaults verbose

# Target a specific vault
obsidian files vault="My Vault"

CLI コマンドの完全なリファレンスについては、cli-reference.md を参照してください。

主なワークフロー

ノートの作成

1. Vault にアクセスできることを確認します（obsidian vault または echo $OBSIDIAN_VAULT）
2. Vault の構造をユーザーに表示します（obsidian folders または obsidian files）
3. ノートの保存先を尋ねます
4. 適切なフロントマター（type、project、tags、作成日）を付けて作成します
5. セッションノートの場合は dump タグを含めます
6. 関連ノートへのウィキリンクを追加します

CLI を使用する場合：

obsidian create name="my-note" path="projects/my-note.md" template="session" open
# Or with inline content:
obsidian create name="my-note" content="---\ntype: session\ntags:\n  - dump\n---\n\n# Content"

bash を使用する場合（複雑な複数行の内容向け）：

cat > "$OBSIDIAN_VAULT/projects/my-note.md" <<'EOF'
---
type: session
tags:
  - dump
---
# Content
EOF

ノートテンプレートについては、templates.md を参照してください。

セッションの要約の作成

/safe-exit および /safe-clear コマンドで使用します。

1. Vault のパスを確認するため、.claude/project-config からプロジェクト設定を読み取ります
2. プロジェクトの session-saves/ ディレクトリにノートを作成します
3. type: session と dump タグを含むフロントマターを追加します
4. コンテキスト、要約、決定事項、アクションアイテム、コード参照を記録します
5. 関連ノートへのリンクを追加します

セッションノートの統合

セッションフォルダーにノートが 5 件以上ある場合、またはプロジェクトのマイルストーンに達した場合：

1. すべてのセッションノートを確認し、テーマを特定します
2. 日付ではなくトピックごとに、テーマ別のリファレンスノートを作成します
3. TODO をプロジェクトの TO-DOS.md に抽出します
4. 処理済みのセッションを archived/daily/ にアーカイブします
5. プロジェクトの HOME.md と MOC を更新します

統合ワークフローの詳細については、vault-management.md を参照してください。

Vault の再編成

Vault を再構成する場合：

1. 目標とする構造を記録します
2. まず新しいフォルダーを作成します
3. ファイルとフォルダーを移動します
4. すべてのリンクを体系的に更新します
5. リンク切れを検出します
6. tree コマンドで確認します

再編成の詳細な手順については、vault-management.md を参照してください。

標準的なプロジェクト構造

project-name/
├── TO-DOS.md
├── session-saves/
├── archived/
│   ├── daily/
│   └── monthly/
└── [project-specific folders]

Obsidian 構文クイックリファレンス

[[Note Name]]              # Wikilink
[[Note Name|Display Text]] # Wikilink with alias
[[Note#Heading]]           # Link to heading
#tag  #project/feature     # Tags
- [ ] Task to do           # Task
- [x] Completed task       # Done task
> [!note]                  # Callout
> Content here

構文の完全なリファレンスについては、reference.md を参照してください。

他のスキルとの連携

• folder-organization - Vault 構造の標準
• managing-environments - 開発ワークフロー
• claude-collaboration - チームのナレッジ共有

---

忘れないでください：目標は、Claude との各セッションを通じて成長する、検索可能で相互にリンクされたナレッジベースを構築することです。シンプルに始め、必要に応じて構造を追加してください。