Obsidian 项目同步管理

问题：项目知识容易散落在临时对话里

工程协作中，真正有复用价值的事实通常来自仓库、文档、测试、配置和验证命令，而不是助手的聊天记录。若只把对话存进笔记，Obsidian 库会快速变成“我做了什么”的过程流水，难以回答项目架构、关键路径、当前状态、验证方式等问题。这个技能把关注点从工作叙述切回项目事实。

工作方式：像维护项目维基，而不是写日志

• 解析目标库：优先使用用户指定路径，其次读取 SCHEMA.md、AGENTS.md、CLAUDE.md 或 handoff 说明；也可从 OBSIDIAN_VAULT_PATH、WIKI_PATH 和现存本地 Obsidian/Markdown 目录推断。若仍不明确，会要求确认。
• 限定同步范围：只写入绑定真实本地项目或仓库的项目型知识，不保存普通聊天、状态更新、工具操作历史、“agent 做了什么”日志，以及密钥、令牌、.env 内容、凭据和噪声日志。
• 先查后写：读取现有 index.md、log.md 和近期笔记，搜索已有页面，再决定是否创建新页面；若库已有 schema，优先遵循本地约定。
• 沉淀持久事实：更新项目实体页，覆盖 overview、架构、技术栈、重要路径、关键文件、当前状态、验证命令、开放问题和相关项目；追加带修改时间与内容的变更记录，并维护 index.md、log.md、wikilinks.md 等页面。
• 用双链组织知识：通过 [[wikilinks]] 连接项目、变更日志、技术、决策、PRD/spec 和可复用概念，同时保持 concepts/、comparisons/、queries/ 低频页面克制。

适用边界

它适合把真实项目文件转成 Obsidian 兼容的知识页，不适合作为聊天存档或运行轨迹记录。执行前最好提供明确 vault 路径或项目根目录；若库不可访问，最终回复会给出压缩的 Obsidian Memory Update 块。完成时建议检查目标笔记存在、双链未断裂、敏感信息扫描无凭据泄露。