用途:在 Claude Code 中操作已有 Obsidian 知识库,包括添加、编辑、查询内容,安装与配置插件,通过 Local REST API 或 CLI 集成,自动化采集、整理与检索,以及设计个人知识管理(PKM)工作流;也覆盖课程/考试/学习库构建。支持多库场景:个人手动库默认对智能体不可写,默认写入 Claude 原生库,除非用户显式授权。
主要能力:提供从零构建或批量填充章节时的检查点式渐进验证流程(先做第一章并停下,用户确认格式与结构后再继续,最后按 QA 清单做系统校验);给出基础插件建议(Local REST API、Obsidian Git、Templater、Daily Notes、Style Settings、QuickAdd、Smart Connections、Bases 等,建议活跃插件不超过约 10 个);总结五种 Claude Code 与库交互模式(文件系统直接读取、obsidian.com CLI 搜索、Local REST API curl、Bases 查询、外部工具生成图表);提供图表工具选择(默认 Mermaid,备选 Excalidraw、Draw.io、PlantUML、D2 等);给出备份纪律(git init、.gitignore 排除工作区与插件凭据、自动提交、推送私有远端、定期恢复演练);并列出常见渲染陷阱与反模式。
使用方式:按技能触发条件调用;具体路径与覆盖环境变量应写入用户自己的 CLAUDE.md 以保持可移植;详细内容见 references/ 下的 plugins.md、interaction-patterns.md、diagrams.md、rendering-pitfalls.md、academic-vault.md、qa-checklist.md、voice-capture-macro.md。
限制:Obsidian Sync 的 30 天版本历史不算备份;不要让 Dataview/Bases 查询成为某条事实的唯一存放处;提交 .obsidian/plugins/*/data.json 可能泄露明文凭据;REST API PUT 非 ASCII 正文需显式 UTF-8 头;Smart Connections 处理多语言内容前需换用多语言嵌入模型。该技能尚未经外部完整 PKM 构建验证,版本为 v0.2.0。