session-notes

セッションノート

構造化されたドキュメントを作成するために、MCPVault MCP を使用して Obsidian のノートを作成・管理します。

ワークフロー

resolve-vault --> select-type --> compose-note --> write --> link-related

ノートの種類ごとに独自のワークフローがあります。ユーザーのニーズに応じて、各種類を個別に使用できます。

トリガー

トリガーパターン	参照先
プロジェクト、新しいプロジェクトノート、プロジェクトをドキュメント化	project.md
課題、技術的な課題、持ち帰り課題、コーディング面接	challenge.md
自慢できる実績、成果、達成事項	brag.md
文字起こし、会議メモ、スタンドアップ、講義、コースノート	transcription.md
Markdown、構文、ウィキリンク、コールアウト、埋め込み	markdown.md
Vault の構造、Vault を整理する	vault-structure.md

メモ：

• markdown.md と vault-structure.md は情報提供用のガイドです（書き込み操作はありません）。
• mapping.md は直接のトリガーではありません。Vault のパスを解決するために project.md によって読み込まれます。
• その他の参照先はすべてノート作成のワークフロー（作成、書き込み、リンク）です。
• templates/ 内のテンプレートは参照用の構造にすぎません。コンテキストに読み込まないでください。

相互参照

mapping.md <-- project.md   (project loads mapping to resolve vault path)
challenge --> brag           (completed challenge becomes achievement)

ファイル名のサニタイズ

ユーザー入力からファイル名を生成する場合：

• 無効な文字を削除します：/ \ : * ? " < > |
• アクセント記号付きの文字を ASCII 相当の文字に置き換えます（例：é → e、ã → a）
• すべてのファイル名にタイトルケースを使用します
• 例：What's Next? は Whats Next.md になります

執筆スタイル

• 言語：すべてのノートで英語を使用します
• 本文：見出しの後に、箇条書きだけでなく、内容の豊かな説明を記述します
• 箇条書き：何が起きたのか、なぜ起きたのかを自然な言葉で、数週間後に読んでも理解できるだけの十分な背景とともに記述します
• 観察事項：#category content の構文を使用します。タグは Obsidian によってネイティブにインデックス化されます
• 関連：型付き動詞とウィキリンクを使用します（- follows [[X]]、- part_of [[Project]]、- contains [[Session]]）。一般的な型には follows、part_of、expands、relates_to、implements、requires、replaces、pairs_with、extends、depends_on、contains があります。本文中のインライン [[wikilinks]] は通常の言及に使用し、「Relations」セクションにはグラフ上の価値を高める型付きエッジを記載します。該当する型付きエッジがない場合は、このセクションを省略します
• ウィキリンクは既存のファイルを指している必要があります。プロジェクトへのリンクを追加する前に、Vault に {Name} Overview.md ファイルが存在することを確認してください。孤立したウィキリンクは作成しないでください。クリックすると Vault のルートに空のファイルが作成されます

ガイドライン

推奨事項：

• ユーザーから情報を集める際は、一度に一つだけ質問します
• templates/*.md の構造に従ってノートの内容を作成します
• 新しいノートには write_note を、更新には read_note + patch_note を使用します
• 作成前にノートが存在するか確認するには search_notes を使用します
• Obsidian のウィキリンク [[Note Name]] を使って関連するノートをリンクします
• ファイル名にはタイトルケースを使用します（例：My Project.md）
• ユーザー入力からファイル名をサニタイズします（上記の「ファイル名のサニタイズ」を参照）

禁止事項：

• ユーザーに複数の質問をまとめてしないでください（対照：一度に一つだけ質問します）
• 既存の Vault ファイルを上書きまたは削除しないでください（対照：追記、名前変更、またはキャンセルします）
• 更新にテンプレートを使用しないでください（対照：テンプレートは新しいノート専用です）
• ノートを重複して作成しないでください（対照：まず search_notes で検索します）
• ウィキリンクに絶対パスを使用しないでください（対照：常に相対パスを使用します）
• Vault に存在しないファイルへのウィキリンクを作成しないでください（対照：リンクする前に対象が存在することを確認します）

出力

ノートはユーザーの Obsidian Vault に作成されます：

Vault/
├── {VaultFolder}/
│   └── {Project}/
│       └── {Project Name} Overview.md
├── Challenges/
├── Brags/
└── Meetings/

{VaultFolder} はプロジェクトのカテゴリ（例：Work/、Ventures/、 Projects/）によって異なります。解決方法については mapping.md を参照してください。

エラー処理

• MCPVault が利用できない：このスキルには MCPVault MCP サーバーが必要であることをユーザーに伝えます
• Vault が見つからない：正しい Vault 名をユーザーに尋ねます
• ノートがすでに存在する：追記、新しい名前の選択、キャンセルのいずれかをユーザーに尋ねます
• 必須フィールドが空：不足している情報をユーザーに求めます