用途
session-notes 用于在 Obsidian 笔记库中创建和管理结构化文档，覆盖项目笔记、技术挑战、成果记录（brag documents）与会议转录等类型，底层依赖 MCPVault MCP。
主要能力
技能提供统一的五步工作流：
resolve-vault --> select-type --> compose-note --> write --> link-related
每种笔记类型有自己的工作流，可按用户需要独立使用任意一类。
触发模式与对应参考文件：
| 触发模式 | 参考文件 |
|---|---|
| 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 加载以解析笔记库路径。其余参考文件均为含撰写、写入与关联的笔记创建流程。templates/ 下的模板仅作结构参考，不加载进上下文。
交叉引用关系：project.md 加载 mapping.md 以解析笔记库路径；challenge 完成后可转为 brag 成就。
使用方式
收集上下文时，一次只问用户一个问题。撰写内容时依照 templates/*.md 的结构组织。新笔记使用 write_note；更新使用 read_note 加 patch_note。创建前用 search_notes 检查笔记是否已存在。使用 [[Note Name]] 形式的 Obsidian wiki-link 关联相关笔记。文件名使用 Title Case（如 My Project.md），并对用户输入的非法字符做清理（见下）。
文件名清理规则：
- 移除非法字符：
/ \ : * ? " < > | - 将重音字符替换为 ASCII 等价字符（如 é → e，ã → a）
- 所有文件名使用 Title Case
- 示例：What's Next? 变为 Whats Next.md
写作风格要求：
- 语言：所有笔记使用英文
- 正文：标题之后使用较为丰富的叙述性上下文，而非仅有要点
- 要点：用自然语言描述发生了什么、为什么发生，上下文要充分，以便数周后仍可理解
- 观察：采用 #category content 语法，标签由 Obsidian 原生索引
- 关联：使用带类型动词加 wikilink（如 - follows [[X]]、- part_of [[Project]]、- contains [[Session]]）。常见类型包括 follows、part_of、expands、relates_to、implements、requires、replaces、pairs_with、extends、depends_on、contains。正文中的普通提及用行内 [[wikilinks]]，Relations 段放置具有图谱价值的带类型边；若无适用类型边则省略该段
- wikilink 必须指向已存在的文件。添加项目链接前，需确认笔记库中存在 {Name} Overview.md。不得创建孤立 wikilink，否则点击会在笔记库根目录生成空文件
适用场景
项目文档、技术挑战与面试题记录、成果与成就记录、会议转录与站立会/课程笔记等。笔记写入用户的 Obsidian 笔记库，目录结构形如：
Vault/
├── {VaultFolder}/
│ └── {Project}/
│ └── {Project Name} Overview.md
├── Challenges/
├── Brags/
└── Meetings/
其中 {VaultFolder} 取决于项目分类（如 Work/、Ventures/、Projects/），解析方式见 mapping.md。
限制与注意事项
应做：向用户收集上下文时一次只问一个问题；按 templates/*.md 结构撰写；新笔记用 write_note，更新用 read_note 加 patch_note；创建前用 search_notes 检查是否已存在；用 [[Note Name]] 关联相关笔记；文件名用 Title Case；对用户输入的文件名做清理。
不应做：一次向用户批量提出多个问题；覆盖或删除笔记库中已有文件（应改为追加、改名或取消）；用模板做更新（模板仅用于新笔记）；创建重复笔记（应先搜索）；在 wiki-link 中使用绝对路径（应始终使用相对路径）；链接到笔记库中不存在的文件（应先验证目标存在）。
错误处理：MCPVault 不可用时，告知用户该技能需要 MCPVault MCP 服务器；笔记库未找到时，询问用户正确的笔记库名称；笔记已存在时，询问是追加、另起名称还是取消；必填字段为空时，提示用户补充缺失信息。
其他信息（如收费、价格、平台支持范围、具体效果等）暂未提供。