[Skill 名] obsidian-helper

Obsidian Helper - スマートノートアシスタント

これは Obsidian MCP と深く統合されたスマートアシスタントで、ノートの効率を高める3つの主要機能を提供します。

⚡ 初めて使用する方へ：自動検出と設定ガイド

いずれかの機能を実行する前に、Claude はまず STEP 0 を実行する必要があります。

STEP 0: MCP 接続検出（各セッションで初めて使用する際に実行）
├─ obsidian_list_files_in_vault() の呼び出しを試行
├─ 成功した場合 → ユーザーが要求した機能の実行を続行
└─ 失敗した場合 → 【設定ガイドフロー】に進む

設定ガイドフロー（すべて日本語で表示）

MCP 接続が失敗した場合、Claude はユーザーに以下のガイド情報を表示する必要があります。

Obsidian MCP が未接続であることを検出しました。設定をお手伝いします！

📋 設定手順

ステップ1：Obsidian プラグインのインストール

1. Obsidian を開く → 設定 → サードパーティプラグイン
2. 「セーフモード」をオフにする
3. 「閲覧」をクリックし、Local REST API を検索する
4. このプラグインをインストールして有効にする

ステップ2：API Key の取得

1. Obsidian の設定で Local REST API プラグインの設定を見つける
2. 「Copy API Key」をクリックして API Key をコピーする
3. ポート番号を控える（デフォルトは 27124 です）

ステップ3：Claude Code MCP の設定

ターミナルで以下のコマンドを実行し、あなたのAPI_KEY を先ほどコピーした Key に置き換えてください。

# MCP 設定ディレクトリを作成（存在しない場合）
mkdir -p ~/.claude

# Obsidian MCP 設定を追加
cat >> ~/.claude/mcp.json << 'EOF'
{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "あなたのAPI_KEY",
        "OBSIDIAN_HOST": "https://127.0.0.1:27124"
      }
    }
  }
}
EOF

または、~/.claude/mcp.json を手動で編集する：

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "あなたのAPI_KEY",
        "OBSIDIAN_HOST": "https://127.0.0.1:27124"
      }
    }
  }
}

ステップ4：Claude Code の再起動

# Claude Code を完全に終了し、再起動する
claude

ステップ5：接続の検証

再起動後、再度希望のコマンド（例：/daily）を入力してください。接続が成功したかどうかを自動的に検証します。

❓ よくある質問

ヘルプが必要ですか？ 遭遇した具体的なエラーメッセージを教えてください。解決をお手伝いします。

接続成功後のプロンプト

MCP 接続が成功した場合、Claude は簡潔に確認すべきです。

✅ Obsidian に接続しました！あなたの知識ベースを検出しました。今から [機能名] を実行します...

🎯 主要機能の概要

🏗️ 推奨される Vault 構造（PARA + Zettelkasten）

Vault/
├── 00_Inbox/                 # 随時メモ
│   └── AI/                   # 【重要】AI 専用の保存場所
├── 10_Projects/              # 期限のあるプロジェクト
├── 20_Areas/                 # 長期的な領域（学習/健康/キャリア）
├── 30_Resources/             # 資料ライブラリ
│   └── Products/             # 製品カード
├── 40_Zettels/               # 永久ノート（結論/洞察）
├── 90_Archive/               # アーカイブ
├── 99_System/Templates/      # テンプレート
└── Daily Notes/              # 日記

⚠️ AI 書き込みの3つの厳格なルール

Claude は以下のルールを遵守する必要があります。

ルール1: AI 専用の保存場所

新規ノートのデフォルト位置: 00_Inbox/AI/
ユーザーが確認した後のみ、他の場所に移動する

ルール2: 追記形式の書き込み

✅ obsidian_append_content を使用して追記する
✅ obsidian_patch_content を使用して指定された見出しの下に追記する
❌ ノート全体を書き換えない

ルール3: Properties ホワイトリスト

# これらのフィールドのみ書き込みを許可し、新しいフィールドを作成しない
---
type: note | product | project | zettel
title: ""
tags: []
status: active | done | archived
created: {{date}}
---

📋 機能1：/daily - スマート日誌アシスタント

トリガー条件

• ユーザーが /daily と入力する
• ユーザーが「今日のジャーナルを始める」「今日のジャーナル」「daily note」と言う

実行フロー

STEP 0: MCP 接続検出（上記参照）

STEP 1: 日誌情報の取得
├─ obsidian_get_periodic_note(period: "daily") を試行
├─ 失敗した場合、obsidian_list_files_in_dir("Daily Notes") を使用して今日のファイルを探す
├─ obsidian_get_recent_periodic_notes または手動で昨日の日誌を取得する
└─ 日誌が既に存在するかどうかを確認する

STEP 2: 昨日の内容を分析
├─ 昨日の日誌内容を読み込む
├─ 未完了の TODO を抽出する（正規表現 `- \[ \]` でマッチ）
├─ 重要な事項を識別する
└─ 簡潔な要約を生成する

STEP 3: 今日の日誌を生成
├─ 今日の日誌が存在しない場合、新しい日誌を作成する
├─ 標準テンプレート構造を使用する
├─ 自動入力する：
│   ├─ 昨日の未完了事項 → 今日のToDo
│   ├─ 日付と曜日（日本語形式）
│   └─ 基本テンプレート構造
└─ obsidian_append_content を使用して書き込む

STEP 4: ユーザーに報告
├─ 日誌の作成/更新ステータスを表示する
├─ 継承された未完了タスクの数をリストアップする
└─ 内容の追加が必要かどうかを尋ねる

日誌テンプレート構造

---
date: {{YYYY-MM-DD}}
tags: [daily]
---

# {{曜日}}, {{月}} {{日}}, {{年}}

## 今日の重点

> [!tip] Focus
>

## タスク

### 昨日から継承
{{yesterday_incomplete_todos}}

### 必須完了
- [ ]

### 完了すべき
- [ ]

### 完了可能
- [ ]

## 今日のノート

### 午前


### 午後


### 晩


## アイデアとインスピレーション


## 今日作成されたリンク


## 晩の振り返り

### うまくいった点


### 改善できる点


### 感謝

使用例

ユーザー入力: /daily または 今日のジャーナルを開始

Claude 実行:

1. MCP 接続を検出 ✓
2. 今日の日誌を取得（例：2026-01-19）
3. 昨日の日誌を取得し、未完了事項を抽出
4. 今日の日誌を作成/更新
5. 返信：「✅ 今日の日誌が作成されました！昨日からX件の未完了タスクが継承されました。」

📋 機能2：/capture - 迅速な知識キャプチャ

トリガー条件

• ユーザーが /capture <テーマ> または /capture <テーマ> <内容> と入力する
• ユーザーが「記録する」「キャプチャ」「メモを追加」「capture」と言う

実行フロー

STEP 0: MCP 接続検出

STEP 1: ユーザー入力を解析
├─ テーマキーワードを抽出する（最初の単語または引用符内の内容）
├─ 記録する内容を抽出する（テーマ以降のすべてのテキスト）
└─ テーマのみで内容がない場合、ユーザーに何を記録するか尋ねる

STEP 2: 既存のノートを検索
├─ obsidian_simple_search(query: テーマ) を使用して検索する
├─ 検索結果の関連性を分析する
└─ 関連度順に並べ替える

STEP 3: 決定と実行
├─ ケースA：高度に関連するノートが見つかった場合（タイトルにテーマが含まれる）
│   ├─ ユーザーに「関連ノート《XXX》が見つかりました。このノートに追記しますか？」と伝える
│   ├─ ユーザーが確認した後、obsidian_patch_content を使用して追記する
│   └─ 追記形式：## {{タイムスタンプ}} キャプチャ\n{{内容}}
│
├─ ケースB：部分的に関連するノートが見つかった場合
│   ├─ 最も関連性の高い3つのノートをリストアップする
│   ├─ 「どのノートに追記しますか、または新しいノートを作成しますか？」と尋ねる
│   └─ ユーザーの選択に基づいて実行する
│
└─ ケースC：関連ノートが見つからなかった場合
    ├─ ユーザーに「関連ノートが見つかりませんでした。新しいノートを作成します」と伝える
    ├─ 保存場所を尋ねる（既存のフォルダをリストアップする）
    └─ obsidian_append_content を使用して作成する

STEP 4: 完了を確認
└─ 表示：「✅ 《XXX》に保存されました」

キャプチャ内容の形式

## 2026-01-19 14:30 キャプチャ

{{ユーザー入力の内容}}

---

使用例

例1:

ユーザー: /capture API設計 RESTful API は動詞ではなく名詞を使用すべき

Claude: 検索 → 「API設計ベストプラクティス.md」が見つかる → 確認を尋ねる → 内容を追記

例2:

ユーザー: /capture 新しいアイデア

Claude: 「何を記録したいですか？」→ ユーザー入力 → 検索 → 処理

📋 機能3：/review - 定期的な振り返りジェネレーター

トリガー条件

• ユーザーが /review または /review weekly または /review monthly と入力する
• ユーザーが「週次レビュー」「月次要約」「振り返り」「review」と言う

実行フロー

STEP 0: MCP 接続検出

STEP 1: 振り返り期間を決定
├─ パラメータを解析：daily / weekly（デフォルト）/ monthly
└─ 時間範囲を計算する

STEP 2: データを収集
├─ 期間内の日誌ファイルを取得する
│   ├─ obsidian_get_recent_periodic_notes を試行
│   └─ 代替：obsidian_list_files_in_dir + 日付フィルタリング
├─ obsidian_batch_get_file_contents を使用して一括で読み込む
├─ obsidian_get_recent_changes を使用してアクティブなファイルを取得する
└─ すべての関連内容を抽出する

STEP 3: 内容を分析
├─ タスクの完了状況を統計する
│   ├─ 完了済み：`- \[x\]` にマッチ
│   └─ 未完了：`- \[ \]` にマッチ
├─ 重要なイベントと成果を抽出する
├─ 高頻度なテーマワードを識別する
├─ 知識の関連性を見つける
└─ 洞察を生成する

STEP 4: レポートを生成
├─ 対応する期間のテンプレートを使用する
├─ 統計データを埋め込む
├─ 分析内容を追加する
├─ Daily Notes/ フォルダに保存する
│   ├─ 週報：YYYY-WXX 週次レビュー.md
│   └─ 月報：YYYY-MM 月次レビュー.md
└─ obsidian_append_content を使用して書き込む

STEP 5: 結果を表示
├─ 振り返りの要約を表示する
├─ 主要なデータをリストアップする
└─ 修正や追加が必要かどうかを尋ねる

週次レビューテンプレート

# {{年}}-W{{週}} 週次レビュー | {{日付範囲}}

## 📊 データ概要
| 指標 | 数値 |
|------|------|
| 📝 ノート数 | {{count}} |
| ✅ 完了タスク | {{completed}} |
| ⏳ 未完了タスク | {{incomplete}} |
| 📂 アクティブファイル | {{active}} |

## 🏆 今週の成果
{{achievements}}

## 📋 タスクまとめ

### ✅ 完了済み
{{completed_list}}

### ⏳ 継続中
{{incomplete_list}}

## 💡 主要な洞察
{{insights}}

## 🔗 知識のつながり
今週の主なテーマ：{{themes}}

## 🎯 来週の重点
1.
2.
3.

## 📝 振り返り
### うまくいった点

### 改善できる点

---
*生成時間: {{timestamp}}*

🔧 設定

(原文がここで切り詰められています)