用途:把工作区里生成的 Markdown 报告、计划与文档,经 Obsidian MCP 服务器同步到 Obsidian 知识库,作为其他技能(规划器、分析器、报告器)产出的持久化环节。
主要能力:支持单文件、整个目录或按模式匹配的批量同步;同步前浏览知识库目录并让用户选择目标文件夹;为笔记生成或合并 frontmatter(title、date、project、type、source、tags),并根据内容推断文档类型;同步后报告文件数量、保存路径与跳过原因。
使用方式:触发场景包括用户要求同步、保存、移动或存储文件到 Obsidian,或要求创建报告/计划并保存到 Obsidian。关键规则:调用任何 Obsidian MCP 工具前必须先用 ToolSearch 加载,例如 ToolSearch query: "+obsidian write"、"+obsidian list"、"+obsidian read";不得假设目标文件夹,需列出知识库根目录让用户选择;写入前完整读取源文件,不修改正文,仅在缺少 frontmatter 时添加或合并字段;写入使用 mcp__obsidian__write_note,批量时先 Glob 匹配 .md 文件、并行读取、只加载一次工具、只询问一次目标路径、顺序写入。
适用场景:把 .agents/plan/ 等目录下的规划、分析、需求、架构、代码评审等 Markdown 文档归档到 Obsidian;与其他技能组合,实现“创建计划并保存到 Obsidian”。
限制:必须配置并运行 Obsidian REST API MCP 服务器;仅处理 .md 文件,不同步图片等二进制资源;只写入 Obsidian,不反向拉取;目标笔记已存在时会覆盖(需用户确认);仅操作 MCP 连接的那一个知识库,无法在多个知识库间切换。