mcpField
O
obsidian-vault-management

obsidian-vault-management

github.com/julianobarbosa生産性14309 回インストール2 日前に更新
リポジトリ

obsidian-vault-management について

PARA に近いフォルダー構成で Obsidian の保管庫を整理・管理するスキルです。ノート、テンプレート、クエリ、プラグインの利用規則を示します。

主な機能

  1. 01PARA に近いフォルダー構成
  2. 02ノートとデイリーノートのテンプレート
  3. 03ウィキリンクとコールアウトの規則
  4. 04Dataview クエリの例
  5. 05プラグインと保管庫の管理ガイド

活用シーン

  1. 01プロジェクトノートと資料の整理
  2. 02形式をそろえたデイリーノートの作成
  3. 03保管庫内のコンテンツ検索
  4. 04ファイル変更後のリンク管理

インストール

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

$npx skills add https://github.com/julianobarbosa/claude-code-skills --skill obsidian-vault-management

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
canvas.md
dataview.md
plugins.md
templater.md
scripts/
create-daily-note.py
find-orphan-notes.py
tag-overview.py

詳細

Obsidian Vault の管理

Vault の構成(PARA ベース)

この vault では、PARA に似た構成を採用しています。

フォルダー用途
00 - Maps of Content関連するトピックをつなぐインデックスノート
01 - Projects進行中のプロジェクトノート
02 - Areas継続的な責任事項
03 - Resources参考資料
04 - Permanentエバーグリーンノート/ツェッテルカステンノート
05 - Fleetingクイックキャプチャノート
06 - Dailyデイリーノート(YYYY/MM/YYYYMMDD.md)
07 - Archives完了済み/非アクティブなコンテンツ
08 - books書籍ノートと抜粋
99 - Metaテンプレート、設定
ClippingsWeb クリップとインポート

クイックリファレンス

リンク構文
[[Note Name]]                    # Basic wikilink
[[Note Name|Display Text]]       # Aliased link
[[Note Name#Heading]]            # Link to heading
[[Note Name#^block-id]]          # Link to block
![[Note Name]]                   # Embed note
![[image.png]]                   # Embed image
![[Note Name#Heading]]           # Embed section
フロントマターテンプレート
---
created: {{date:YYYY-MM-DDTHH:mm}}
updated: {{date:YYYY-MM-DDTHH:mm}}
title: "Note Title"
type: note
status: draft
tags:
  - tag1
  - tag2
aliases:
  - "Alternate Name"
cssclasses:
  - custom-class
---
コールアウト
> [!note] Title
> Content

> [!warning] Important
> Warning content

> [!tip] Helpful tip
> Tip content

> [!info]+ Collapsible (open by default)
> Content

> [!danger]- Collapsed by default
> Content

利用可能なコールアウトの種類:note、abstract、info、todo、tip、success、question、warning、failure、danger、bug、example、quote

ノートの作成

デイリーノート

06 - Daily/YYYY/MM/ に、ファイル名を YYYYMMDD.md として作成します。

---
created: 2025-12-09T09:00
updated: 2025-12-09T09:00
title: "20251209"
type: daily-note
status: true
tags:
  - daily
  - journal
  - 2025
  - 2025-12
aliases:
  - "2025-12-09"
date_formatted: 2025-12-09
topics:
  - "[[daily]]"
  - "[[journal]]"
related:
  - "[[2025-12-08]]"
  - "[[2025-12-10]]"
cssclasses:
  - daily
---

# Daily Note - 2025-12-09

### Tasks
- [ ] Task 1

### Journal
...

### Navigation
<< [[2025-12-08]] | **Today** | [[2025-12-10]] >>
ツェッテルカステンノート

04 - Permanent/ に作成します。

---
created: {{date}}
type: zettelkasten
tags:
  - permanent
  - topic
---

# Note Title

## Main Insight
**Key Idea**: [Main point]

## Connections
- [[Related Note 1]]
- [[Related Note 2]]

## References
- Source citation

Dataview クエリ

Dataview クエリの構文については、references/dataview.md を参照してください。

簡単な例:

LIST FROM "06 - Daily" WHERE file.cday = date(today) SORT file.ctime DESC
TABLE status, tags FROM "01 - Projects" WHERE status != "completed"

テンプレート

テンプレートの場所:99 - Meta/00 - Templates/

Templater の構文については、references/templater.md を参照してください。

よく使う Templater 変数:

<% tp.file.title %>              # Current file name
<% tp.date.now("YYYY-MM-DD") %>  # Current date
<% tp.file.cursor(1) %>          # Cursor position
<% tp.system.prompt("Question") %> # User input prompt

インストール済みプラグイン

プラグイン用途
Dataviewノートのデータをクエリして表示
Templaterスクリプト機能を備えた高度なテンプレート
Auto Note Moverタグに基づいてノートを自動整理
Periodic Notes日次/週次/月次ノート
KanbanMarkdown でカンバンボードを作成
Tag Wranglerタグの一括管理
Table EditorMarkdown テーブルの編集
Advanced URIノートへのディープリンク
Local REST API外部 API アクセス

ファイル操作

ノートの作成
  1. ノートの種類に応じて適切なフォルダーを決定します
  2. 適切なフロントマターを追加します
  3. 一貫した命名規則を使用します
  4. 自動整理に役立つ関連タグを追加します
ベストプラクティス
  • 内容が分かりやすいファイル名を使用します(ハイフン以外の特殊文字は避けてください)
  • created と updated のタイムスタンプを必ず含めます
  • 見つけやすいようにノートにタグを付けます
  • 関連ノート同士を双方向にリンクします
  • 重要な情報にはコールアウトを使用します
  • デイリーノートにはナビゲーションリンクを含めます

高度な機能


注意点

  • Obsidian の外部での一括操作では、リンクの再構築が実行されません — 外部スクリプトから :Reindex を通知するか、次に vault を開くまで待つ必要があります。
  • Dataview のキャッシュは vault ごと、セッションごとに管理されます — Obsidian を異なるフィルターを使った状態で最後に開いていた場合、CLI スクリプトによる DQL クエリが古い状態を参照することがあります。
  • CLI 経由で実行する Templater スクリプトは、UI とは異なるコンテキストで動作します — UI にプロンプトを表示する環境がないため、多くの tp.system.* 関数は nil を返します。
  • PARA フォルダーの移動により、タグベースのクエリが機能しなくなります — クエリでフォルダーパスをハードコードしている場合は、再構成の前にタグまたはプロパティを使うように修正してください。
  • デイリーノートの形式変更:vault の運用途中でデイリーノートの形式を変更すると、古いノートが孤立します — 新しい形式には自動で移行されないため、名前の一括変更が必要です。

コメント