session-notes（会议笔记）

Session Notes

Create and manage Obsidian notes using MCPVault MCP for structured documentation.

Workflow

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

Each note type has its own workflow. Use any type independently based on user needs.

Vault Resolution

Run once per session before any write operation.

1. Verify MCPVault MCP is available (write_note, read_note tools present)
2. If multiple vaults exist, ask user which one to use
3. All write operations use paths relative to the vault root

For project path resolution, load mapping.md/session-notes/references/mapping.md). Fixed-path refs (brag.md, challenge.md, transcription.md) write directly to Brags/, Challenges/, Meetings/ without path resolution.

Filename Sanitization

When generating filenames from user input:

• Remove invalid characters: / \: *? " < > |
• Preserve accented characters (valid in filenames)
• Use Title Case for all filenames
• Example: What's Next? becomes Whats Next.md

Context Loading Strategy

Load only the reference or guide matching the current trigger. Never load multiple simultaneously unless explicitly noted.

• templates/*.md are not loaded into context. The agent uses them as reference to compose note content.

Triggers

Notes:

• markdown.md and vault-structure.md are informational guides (no write operations).
• mapping.md is not a direct trigger. It is loaded by project.md to resolve vault paths.
• All other references are note-creation workflows (compose, write, link).

Cross-References

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

Writing Style

• Language: English for all notes
• Body: rich prose context after the heading, not just bullet points
• Bullet points: describe what happened and why, with natural language, and with enough context to understand weeks later
• Observations: #category content syntax -- tags are indexed by Obsidian natively
• Relations: typed verbs + wikilinks (- follows [[X]], - part_of [[Project]], - contains [[Session]]) -- common types include follows, part_of, expands, relates_to, implements, requires, replaces, pairs_with, extends, depends_on, contains; inline [[wikilinks]] in prose cover ordinary mentions, the Relations section holds typed edges that add graph value; omit the section if no typed edges apply
• Wikilinks must point to existing files. Before adding a project link, verify the {Name} Overview.md file exists in the vault. Never create orphan wikilinks -- clicking them creates empty files at the vault root

Guidelines

DO:

• Ask one question at a time when gathering context from the user
• Resolve vault once per session (see Vault Resolution above)
• Compose note content following templates/*.md structure
• Use write_note for new notes, read_note + patch_note for updates
• Use search_notes to check if a note exists before creating
• Link related notes using Obsidian wiki-links [[Note Name]]
• Use Title Case for filenames (e.g., My Project.md)
• Sanitize filenames from user input (see Filename Sanitization above)

DON'T:

• Batch multiple questions to the user (contrasts: one question at a time)
• Overwrite or delete existing vault files (contrasts: append, rename, or cancel)
• Assume vault location without confirmation (contrasts: resolve vault once per session)
• Use templates for updates (contrasts: templates are for new notes only)
• Create duplicate notes (contrasts: search first with search_notes)
• Use absolute paths in wiki-links (contrasts: always relative)
• Create wikilinks to files that don't exist in the vault (contrasts: verify target exists before linking)

Output

Notes are created in the user's Obsidian vault:

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

The {VaultFolder} depends on the project category (e.g., Work/, Ventures/, Projects/). See mapping.md/session-notes/references/mapping.md) for resolution.

Error Handling

• MCPVault unavailable: inform user the skill requires MCPVault MCP server
• Vault not found: ask user for correct vault name
• Note already exists: ask to append, choose new name, or cancel
• Empty required fields: prompt user for missing information