mcpField
O
obsidian-vault-ops

obsidian-vault-ops

github.com/ballred生産性1.9k69 回インストール36 週間前に更新
リポジトリ

obsidian-vault-ops について

Obsidian vault のファイルを読み取り、作成、編集、整理するスキルです。ノート管理時に vault の規約に従い、frontmatter、テンプレート、wiki-links を維持します。

主な機能

  1. 01ノートの読み取りと vault コンテキストの確認
  2. 02テンプレートを使ったノート作成
  3. 03YAML frontmatter とリンクの維持
  4. 04タグと見出し階層の統一
  5. 05関連ノートの検索とリンク候補の提示

活用シーン

  1. 01テンプレートからデイリーノートを作成
  2. 02既存構造を保ってノートを編集
  3. 03関連ノートを探して wiki-links を提案
  4. 04タグと目標リンクでタスクを整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ballred/obsidian-claude-pkm --skill obsidian-vault-ops

インストール後、Claude Code で/obsidian-vault-opsを入力して読み込まれたか確認します。

詳細

Obsidian Vault の操作スキル

Obsidian Vault 内のファイルの読み取り、書き込み、管理に関する基本操作です。

Vault の構造

vault-root/
├── CLAUDE.md           # Main context (always read first)
├── Daily Notes/        # YYYY-MM-DD.md format
├── Goals/              # Goal cascade files
├── Projects/           # Project folders with CLAUDE.md
├── Templates/          # Reusable note structures
└── Archives/           # Completed/inactive content

ファイル操作

ノートの読み取り
  • Glob を使用してファイルを検索します：*.md、Daily Notes/*.md
  • Vault のコンテキストを把握するため、最初に CLAUDE.md を読みます
  • 関連するノートへの Wiki リンクを確認します
ノートの作成
  1. ノートがすでに存在するか確認します
  2. 利用可能な場合は、適切なテンプレートを使用します
  3. 日付とタグを含む YAML フロントマターを追加します
  4. 関連するノートへの Wiki リンクを挿入します
ノートの編集
  • YAML フロントマターの構造を維持します
  • 既存の Wiki リンクを保持します
  • 見出しの階層を統一します
  • 標準のタグ形式を適用します

Wiki リンクの形式

[[Note Name]]                    # Simple link
[[Note Name|Display Text]]       # Link with alias
[[Note Name#Section]]            # Link to section

YAML フロントマター

標準的なフロントマターの構造：

---
date: 2024-01-15
tags: [tag1, tag2]
status: active
---

テンプレート変数

テンプレートを処理する際は、以下を置き換えます：

  • {{date}} - 今日の日付（YYYY-MM-DD）
  • {{date:format}} - 指定した形式の日付
  • {{date-1}} - 昨日
  • {{date+1}} - 明日
  • {{time}} - 現在の時刻

よく使われるパターン

デイリーノートの作成
  1. 今日の日付を YYYY-MM-DD 形式で計算します
  2. Daily Notes/{date}.md が存在するか確認します
  3. 存在しない場合は、Templates/Daily Template.md を読みます
  4. テンプレート変数を置き換えます
  5. Daily Notes/{date}.md に書き込みます
関連するノートの検索
  1. 現在のノートから重要な用語を抽出します
  2. Vault 内で一致する内容を検索します
  3. 関連するノートへの Wiki リンクを提案します
タグの操作
  • 優先度：#priority/high、#priority/medium、#priority/low
  • ステータス：#active、#waiting、#completed、#archived
  • コンテキスト：#work、#personal、#health、#learning

ベストプラクティス

  1. Vault 固有の規約を確認するため、必ず CLAUDE.md を確認します
  2. 編集時は既存の構造を維持します
  3. 内部リンクには相対パスを使用します
  4. 新しいノートにはフロントマターを追加します
  5. タスクを作成する際は、関連する目標にリンクします

コメント

Markdown 対応