用途：把 Obsidian 知识库作为开发者知识库和自动工作日志来管理。当用户要求管理笔记、更新知识库、添加到 Obsidian、记录到知识库、搜索笔记或查找相关内容时启用。
主要能力：支持笔记操作（新增、搜索、更新、导入、链接、归档）；处理应存入知识库的项目文档；自动捕获提交、任务或 Claude Code 组件；组织与查找知识库信息。
知识库结构：根目录为 ~/guerra_vault/，包含 projects、technologies、claude-code（agents/hooks/skills/tools）、ideas、personal、todo、references、journal（commits/tasks/creations）和 _archive。
Frontmatter 标准：所有笔记必须包含 YAML frontmatter，字段为 title、description、tags、related、created、updated。title 需描述性并与主标题一致；description 为一句话说明；tags 始终包含分类标签；related 使用 Wiki 链接格式；created 创建时设定一次；updated 每次修改时更新。
可用命令：/obsidian-vault:init 初始化配置与结构；/obsidian-vault:add <category> <title> 新建笔记；/obsidian-vault:search <query> 按标题、内容或标签查找；/obsidian-vault:update <note> 编辑 frontmatter 或追加内容；/obsidian-vault:import <file> 导入带 frontmatter 的外部文件；/obsidian-vault:list [category] 列出笔记；/obsidian-vault:tags [--stats] 查看标签与统计；/obsidian-vault:link <note1> <note2> 创建双向关联；/obsidian-vault:archive <note> 归档笔记。
自动捕获：Git 提交生成 journal/commits/YYYY-MM-DD-<slug>.md，含提交信息、日期、项目、分支、变更文件及 What/Why 占位段；任务完成生成 journal/tasks/YYYY-MM-DD-<slug>.md，含摘要、完成内容与决策；Claude Code 组件生成 claude-code/<type>s/<name>.md 并记录到 journal/creations/。
最佳实践：创建时选对分类、使用描述性标题、立即添加标签并链接相关笔记；更新时维护 updated 日期与关联链接；搜索时先宽后窄，可用 --title、--content、--tag、--category 缩小范围；组织上保持命名一致，归档而非删除，维护双向链接。
配置：配置文件为 ~/.claude/obsidian-vault.json，知识库路径为 ~/guerra_vault。参考文件 references/frontmatter-spec.md 提供详细 frontmatter 规范。
限制：资料未提供收费、价格、平台兼容性及具体效果等信息。