session-notes

Session Notes

使用 MCPVault MCP 创建和管理 Obsidian 笔记，实现结构化文档编写。

Workflow

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

每种笔记类型都有自己的工作流。可根据用户需求独立使用任意类型。

Triggers

触发模式	参考文档
Project, new project note, document project	project.md
Challenge, technical challenge, take-home, coding interview	challenge.md
Brag, achievement, accomplishment	brag.md
Transcription, meeting notes, standup, lecture, course notes	transcription.md
Markdown, syntax, wikilink, callout, embed	markdown.md
Vault structure, organize vault	vault-structure.md

说明：

• markdown.md 和 vault-structure.md 是信息指南（不执行写入操作）。
• mapping.md 不是直接触发项。它由 project.md 加载，用于解析 vault 路径。
• 其他所有参考文档都是笔记创建工作流（撰写、写入、链接）。
• templates/ 下的模板仅用于参考结构；不要将其加载到上下文中。

Cross-References

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

Filename Sanitization

根据用户输入生成文件名时：

• 移除无效字符：/ \ : * ? " < > |
• 将带重音符号的字符替换为对应的 ASCII 字符（例如，é → e，ã → a）
• 所有文件名均使用 Title Case
• 示例：What's Next? 变为 Whats Next.md

Writing Style

• 语言：所有笔记均使用英语
• 正文：标题后应包含丰富的上下文叙述，而不只是项目符号
• 项目符号：描述发生了什么以及原因，使用自然语言，并提供足够的上下文，确保几周后仍能理解
• 观察：使用 #category content 语法——Obsidian 会原生索引标签
• 关系：使用带类型的动词 + wikilinks（- follows [[X]]、- part_of [[Project]]、- contains [[Session]]）——常见类型包括 follows、part_of、expands、relates_to、implements、requires、replaces、pairs_with、extends、depends_on、contains；正文中的内联 [[wikilinks]] 用于普通提及，Relations 部分用于记录能为关系图增加价值的带类型边；如果没有适用的带类型边，则省略此部分
• Wikilinks 必须指向现有文件。添加项目链接前，先确认 vault 中存在 {Name} Overview.md 文件。切勿创建孤立的 wikilinks——点击它们会在 vault 根目录创建空文件

Guidelines

应当：

• 收集用户提供的上下文时，一次只问一个问题
• 按照 templates/*.md 的结构撰写笔记内容
• 新建笔记时使用 write_note，更新笔记时使用 read_note + patch_note
• 创建笔记前使用 search_notes 检查笔记是否已存在
• 使用 Obsidian wiki-links [[Note Name]] 链接相关笔记
• 文件名使用 Title Case（例如，My Project.md）
• 清理用户输入生成的文件名（参见上文“Filename Sanitization”）

不要：

• 一次向用户提出多个问题（与一次只问一个问题相反）
• 覆盖或删除 vault 中已有的文件（应改为追加、重命名或取消）
• 更新时使用模板（模板仅用于新建笔记）
• 创建重复笔记（应先使用 search_notes 搜索）
• 在 wiki-links 中使用绝对路径（应始终使用相对路径）
• 创建指向 vault 中不存在文件的 wikilinks（链接前应先确认目标存在）

Output

笔记会创建在用户的 Obsidian vault 中：

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

{VaultFolder} 取决于项目类别（例如，Work/、Ventures/、 Projects/）。有关解析方式，请参见 mapping.md。

Error Handling

• MCPVault 不可用：告知用户此技能需要 MCPVault MCP 服务
• 未找到 vault：询问用户正确的 vault 名称
• 笔记已存在：询问用户是要追加内容、选择新名称还是取消
• 必填字段为空：提示用户补充缺失信息