用途：在本地 Markdown/Obsidian 知识库（vault）中以只读方式查找证据，按来源层级排序并给出可核验引用，不做整理、不维护索引、不改状态。
主要能力：支持文件名、正文、frontmatter 字段、标签、反向链接和清单检索，覆盖 Markdown、Bases、需求及常见 UTF-8 代码文件；对 PDF、DOC/DOCX、PPT、XLS、图片、音视频先做文件名/路径/入链检索，正文优先经已验证的 Omnisearch/Text Extractor 或 obsidian-mcp-server，不可用时须回退为文件名命中或显式 OCR/转换。结果按 10 当前 → 20 精选长期知识 → 30 冻结证据 → 40/50/60 专项 → 20 历史导入 → 90 归档排序，并标记来源层与 needs_review、deprecated、superseded_by 等状态。
使用方式：提供 vault 路径和关键词，按问题类型先窄后宽查询。综合检索：python3 scripts/query_vault.py --vault <vault-path> --query '<keyword>' --json。文件名：--mode filename。标签或字段：--mode tag / --mode frontmatter --field status --query active。入链与清单：--mode backlinks / --mode inventory。可用 --path-prefix、--exclude-prefix（可重复，仅接受 vault 相对路径）、--limit、--no-snippets、--include-ext 控制范围与输出；敏感语料建议加 --no-snippets。
依赖与安装：本地确定性后端只需 Python 3，不建持久索引；装整个域：claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-pkm-vault@soia；只装本技能：npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-query-vault -y。WorkBuddy 需单独安装。
限制：默认跳过隐藏目录、.git、.obsidian、凭据配置目录和二进制正文；不上传文件、不写持久缓存、不启用 RAG（语义召回需用户显式启用并降级为候选）；不移动、删除、改 frontmatter 或创建待办；缺少 MOC/导航等证据时只能报告部分完成或未知；vault 仅提供线索，强时效事实仍需外部核验；未连接后端时不能声称正文命中。