obsidian

Obsidian Vault Manager

アセット

このスキルでは、モジュール式のアセットアーキテクチャを使用します。詳細なワークフロー、テンプレート、ヘルパーは assets/ ディレクトリにあります。

• assets/modes/ - 詳細なワークフローを含む2つの操作モード
• assets/helpers/ - フロントマター、相互参照、ランキング、一括操作の共通ヘルパー

ディレクトリの一覧は assets/README.md を参照してください。

メタデータに関する注意：このファイルのYAMLフロントマターでは、実行時の動作（auto_invoke トリガー、allowed-tools、scope）を定義しています。manifest.json では、レジストリのメタデータ（バージョン、タグ、プロバイダー、依存関係）を定義しています。フロントマターはClaude Codeのスキルローダーによって読み込まれ、マニフェストはインストールと更新のために skills CLI によって読み込まれます。

---

目的

Obsidian Vaultのすべての操作を統合するスキルです。エージェントのワークスペースとObsidian Vaultの間で双方向のナレッジブリッジとして機能します（MCPを優先し、利用できない場合はファイルシステムにフォールバックします）。

• SYNCモード：ワークスペースからVaultにドキュメント（Markdownレポート、計画、分析）を書き込みます
• READモード：Vaultのノートをコンテキスト情報源として読み取り、検索し、内容を把握します

以前の obsidian-sync スキルと obsidian-reader スキルの機能を、段階的な開示を備えた一貫性のある1つのツールに統合しています。

---

言語サポート（i18n）

このスキルは英語とスペイン語のバイリンガル運用をサポートしています。

• トリガーキーワード：モードの判定では、英語（sync、read、search）とスペイン語（guardar、lee、busca）の両方を認識します。
• ## Referencias セクション見出し：このプロジェクトで採用しているObsidianの慣例として、意図的にスペイン語の形式を使用しています。このスキルが作成するすべてのドキュメントでは、## Referencias を使用し、## References は使用しません。
• クエリの例：実際のバイリンガル利用を反映するため、ドキュメントには両方の言語で例を記載しています。
• 出力言語：スキルはユーザーが使用する言語と同じ言語で応答します。ユーザーがスペイン語で書いた場合はスペイン語で、英語で書いた場合は英語で応答します。ドキュメントの内容は翻訳せず、そのまま同期または読み取りを行います。

慣例：## Referencias は固定のセクション見出しです。生成するドキュメントで ## References に翻訳しないでください。

---

重要なルール

ルール1 — モードの判定：ユーザーの意図に基づいて自動選択する

ユーザーの入力から操作モードを判定します。状況に合わないモードを強制してはいけません。

ルール2 — 内容の整合性を保つ（SYNCモード）

書き込み前にソースファイルをすべて読み込みます。ドキュメント本文（見出し、段落、表、コードブロック、## Referencias セクション）は変更しないでください。フロントマターのメタデータのみを追加またはマージします。相互参照の修正では related フロントマター配列のみを更新し、ドキュメント本文は変更しません。

ルール3 — 内容を捏造しない（READモード）

ノートにそのまま記載されている情報のみを報告します。パスを示して出典を引用します。「ノートにXと書かれている」ことと「ノートに基づくXの解釈」を区別します。

ルール4 — OBSIDIAN MARKDOWN標準に従う

すべての操作で、フロントマター、Wikiリンク、タイプ、相互参照に関する仕様として、Obsidian Markdown標準に従います。

---

ツールの依存関係

このスキルでは、ネイティブのClaude Codeツールのみを使用します：Read、Write、Edit、Glob、Grep、Bash、AskUserQuestion。MCPや外部依存関係は必要ありません。

---

操作モード

モードの検出

次のシグナルを使って、ユーザーの意図からモードを自動検出します。

モード	シグナル（EN）	シグナル（ES）	入力例
SYNC	「sync」、「save」、「store」、「write」、「move」＋「obsidian」	「guardar」、「sincronizar」＋「obsidian」	「sync this report to obsidian」、「guardar en obsidian」
READ	「read」、「search」、「find」、「check」、「consult」、「what do my notes say」＋「obsidian」／「vault」／「notes」	「lee」、「busca」、「consulta」＋「obsidian」／「vault」／「notas」	「read my vault notes about X」、「busca en obsidian」

意図が曖昧な場合の解決方法： ユーザーの意図が SYNC または READ のシグナルに明確に一致しない場合（例：「help me with obsidian」、「manage my notes」、「obsidian」のみで動詞がない場合）は、ユーザーに確認してください。

AskUserQuestion:
  question: "What would you like to do with your Obsidian vault?"
  header: "Mode"
  options:
    - label: "Read / Search"
      description: "Read notes, search for information, or get project context from your vault"
    - label: "Sync / Write"
      description: "Save or sync documents from your workspace to your vault"

モード機能マトリックス

機能	SYNC モード	READ モード
Vault への書き込み	✅	❌
Vault からの読み取り	❌	✅
Vault の検索	❌	✅
フロントマターの生成	✅	❌
クロスリファレンスの修正（フロントマター）	✅	❌
クロスリファレンスの診断	✅	✅
一括操作	✅	✅
Vault の閲覧	✅	✅
優先順位付け	❌	✅
標準準拠チェック	❌	✅
ノートの削除／アーカイブ	✅	❌
ノートの移動／再整理	✅	❌
ノートへのパッチ適用（一部編集）	✅	❌
メタデータのみの読み取り	❌	✅

---

アセットの読み込み（モード別）

モードを検出した後、そのモード用として一覧にあるアセットのみを読み込んでください。他のモードのアセットは読み込まないでください。コンテキストトークンを無駄に消費します。

モード	読み込むアセット	読み込まない
SYNC	assets/modes/SYNC.md	READ.md、priority-ranking.md、obsidian-linter.md
READ	assets/modes/READ.md	SYNC.md、frontmatter-generator.md、cross-ref-validator.md、batch-sync-pattern.md

各モードのアセットには、必要なヘルパーと標準への参照が含まれています。モードのワークフローの指示に従って、必要に応じて読み込んでください。事前に読み込まないでください。

両モードで必要となる MCP ツールのパラメーター仕様については、assets/helpers/tool-reference.md を参照してください。ToolSearch の出力だけでは不十分な場合に限り、読み込んでください。

---

クイックスタート

SYNC モード

ワークスペースのドキュメントを Obsidian の Vault に保存する場合に使用します。

このレポートを obsidian に同期してください。

今すぐ読み込むアセット： assets/modes/SYNC.md（frontmatter-generator、cross-ref-validator、batch-sync-pattern を必要に応じて参照します）

READ モード

Vault のノートを読み取り、検索し、その内容について考察する場合に使用します。

アーキテクチャに関する Vault のノートを読んでください。

今すぐ読み込むアセット： assets/modes/READ.md（priority-ranking、obsidian-linter を必要に応じて参照します）

---

モードのワークフロー

SYNC モード - Obsidian Vault への書き込み

適切なフロントマターとクロスリファレンスの検証を行い、Markdown ドキュメントをワークスペースから Obsidian Vault に同期します。

今すぐ読み込むアセット： assets/modes/SYNC.md（frontmatter-generator、cross-ref-validator、batch-sync-pattern を必要に応じて参照します）

概要：

1. ソースファイルを特定します（ワークスペースのドキュメントを Glob で検索）
2. アクセスモードを検出します（MCP またはファイルシステムへのフォールバック）
3. Vault を閲覧し、保存先をユーザーに確認します
4. ソースファイルを読み取ります
5. フロントマターを生成します（→ SYNC.md で frontmatter-generator を参照）
6. mcp__obsidian__write_note を使って Vault に書き込みます
7. クロスリファレンスを検証します（→ SYNC.md で cross-ref-validator を参照）
8. 結果を報告します

READ モード - Obsidian Vault から読み取る

Vault のノートを読み取り、検索し、内容を推論して、意思決定に役立つ文脈情報を提供します。

今すぐ読むアセット： assets/modes/READ.md（優先順位付け、オンデマンドの obsidian-linter を参照）

概要：

1. MCP ツールを読み込む（MCP が利用できない場合はファイルシステムにフォールバック）
2. ユーザーの意図を解析する（ノートを読む、検索する、プロジェクトのコンテキストを取得する、質問に答える）
3. 操作を実行する（検索／読み取り／推論）
4. 結果を優先度順に並べる（→ READ.md から priority-ranking を参照）
5. 出典を引用した構造化出力を提示する

---

設定の解決

{vault_destination} は実行時に解決されます。SYNC モードでは Vault を参照し、保存先をユーザーに尋ねます。事前設定や永続化は不要です。SYNC.md の Step 3 を参照してください。

ステージングを考慮した動作： ユーザーが「出力を Vault に同期して」と言うと、SYNC モードは生成元スキル（universal-planner、code-analyzer）の .agents/ ディレクトリを検出し、利用可能な出力を一覧表示して、ユーザーに選択してもらってから、選択された Vault の保存先に同期します。

---

共通ヘルパー

• frontmatter-generator - 汎用スキーマに従って Obsidian のフロントマターを生成します
• cross-ref-validator - 双方向参照を検証します
• batch-sync-pattern - 最適化された一括ファイル同期ワークフロー
• priority-ranking - 検索結果を関連度順に並べます

---

Obsidian 出力標準

すべての操作は、内部の Obsidian markdown standard に従います。

1. フロントマター：title、date、project、type、status、version、tags、changelog、related を含む汎用スキーマ
2. タイプ分類：14 種類のドキュメントタイプ（analysis、plan、sprint-plan、technical-report など）
3. Wiki リンク：[[note-name]] 形式を使用し、Markdown リンクは使用しません
4. 双方向参照：A→B の場合、B→A も設定します
5. ステータス遷移：draft → active → completed → archived

準拠状況の検証については、assets/validators/obsidian-linter.md を参照してください。

---

他のスキルとの連携

生成元スキル	obsidian との連携方法
universal-planner	SYNC：計画ドキュメントを Vault に保存します。READ：過去の計画をコンテキストとして提供します
code-analyzer	SYNC：技術レポートを保存します。READ：アーキテクチャに関するノートを提示します
universal-planner（EXECUTE モード）	READ：スプリント計画と進捗を取得します

組み合わせパターン：

Producer skill generates docs → obsidian SYNC mode writes to vault
Agent needs context → obsidian READ mode retrieves from vault

スキル間の呼び出し

別のスキルやエージェントから obsidian を呼び出す場合は、次の優先順位に従ってください。

優先度 1：Skill ツール（推奨）

スキルが読み込まれた Claude Code で実行している場合：

Skill("obsidian")

次に、操作を説明します（例：「.agents/staging/code-analyzer/ 内のファイルを Vault に同期してください」）。

優先度 2：自然言語のトリガー

auto_invoke に一致するフレーズを使います。

• "出力を obsidian に同期して"
• "これらのレポートを Vault に保存して"
• "Guardar en obsidian"

優先度 3：SKILL.md を直接読む（スキルのコンテキストを持たないサブエージェント）

Skill ツールを利用できない場合（例：Task ツール経由のチームサブエージェント）、SKILL.md を直接読みます。

Read: cognitives/skills/integrations/obsidian/SKILL.md

その後、SYNC または READ モードのワークフローに従います。このスキルを読む前に mcp__obsidian__* ツールを呼び出してはいけません。

---

ベストプラクティス

SYNC モード：

• 同期する前に、ソースファイルが存在することを確認します
• 保存先を必ずユーザーに尋ねます（保存先を決めつけてはいけません）
• 一括同期後に相互参照を検証します
• ファイルの保存先となった正確な Vault パスを報告します

READ モード：

• まず MCP を試し、利用できない場合はファイルシステムにフォールバックします
• 検索対象を関連フォルダーに絞ります（必要なく Vault 全体を検索しないでください）
• 正確なノートパスを使って必ず出典を引用します
• 引用した内容と解釈を区別します

---

制限事項

• Markdown のみ：.md ファイルを処理します。バイナリアセットや画像は対象外です
• 単一の保管庫：一度に操作できる保管庫は 1 つです
• 双方向同期には非対応：保管庫への書き込み（SYNC）または保管庫からの読み取り（READ）を行います。双方向同期はできません
• READ モードでは読み取り専用：READ モードではノートを変更できません（書き込みには SYNC を使用してください）
• 検索は正規表現／リテラルのみ：Grep を使用するため、あいまい検索には対応していません。結果が少ない場合はパターンの範囲を広げてください。

---

トラブルシューティング

問題	モード	解決策
"Tool not found: mcp__obsidian__*"	両方	最初に ToolSearch query: "+obsidian write" を実行してください
"MCP server not connected"	両方	スキルは自動的にファイルシステムモードに切り替わります。プロンプトが表示されたら、保管庫のパスを指定してください。
"Note already exists"	SYNC	上書きする前にユーザーに確認してください
"No results found"	READ	検索範囲を広げ、別のフォルダーを確認し、保管庫のパスを確認してください
"Empty content"	SYNC	Glob を使用してソースファイルのパスを確認してください
"Confirmation path mismatch"	SYNC	delete_note では、confirmPath が path と完全に一致している必要があります
"Multiple matches found"	SYNC	複数の一致がある場合、patch_note は replaceAll: false だと失敗します。replaceAll: true に設定するか、文字列を絞り込んでください
"Frontmatter merge conflict"	SYNC	update_frontmatter は merge: true で既存の内容を保持します。完全に置き換えるには merge: false を使用してください
メタデータクエリが遅い	READ	ノート全体を読み取る代わりに、get_frontmatter または get_notes_info を使用してください