用途：将任意含 Markdown 文件的 Git 仓库初始化为 Obsidian Vault，作为项目采用 Obsidian 的入口技能，负责前置依赖校验与安装引导、Vault 配置初始化、排除过滤设置，以及验证 Vault 是否可供智能体操作。
主要能力：校验目标目录存在且含 .md 文件；创建 .obsidian/ 配置目录；写入 app.json 排除过滤；更新 .gitignore 排除 .obsidian/；报告后续步骤。默认排除 node_modules/、.worktrees/、.vector_data/、.git/、venv/、pycache/、.json、.jsonl 及多种机器生成快照文件，避免污染图谱。
依赖：需 Python 3.8+ 且仅用标准库；CRUD 操作需 ruamel.yaml。安装命令：pip-compile ./requirements.in 与 pip install -r ./requirements.txt。Obsidian 桌面应用为必需，macOS 可用 brew install --cask obsidian，或从 https://obsidian.md/download 下载，验证 ls /Applications/Obsidian.app。推荐 Obsidian CLI v1.12+：npm install -g obsidian-cli，验证 obsidian --version；CLI 需运行中的桌面实例，无头环境可用 vault_ops.py 直接操作文件系统。
用法：交互初始化 python ./init_vault.py --vault-root <path>；自定义排除 python ./init_vault.py --vault-root <path> --exclude "custom_dir/" "*.tmp"；仅校验 python ./init_vault.py --vault-root <path> --validate-only。之后在 Obsidian 中“Open Folder as Vault”选择根目录，验证索引与 wikilink，并设置 export VAULT_PATH=/path/to/vault。
可选 Wiki 引擎初始化：运行 /wiki-init 或 python ./scripts/raw_manifest.py --init --wiki-root /path/to/wiki-root，交互登记原始内容目录，生成 .agent/learning/rlm_wiki_raw_sources_manifest.json，随后可用 /wiki-ingest、/wiki-distill、/wiki-query。
适用场景：任何含 Markdown 的 Git 仓库，尤其是开发者项目。限制：CLI 依赖运行中的 Obsidian 桌面实例；技能为项目无关，换项目时以新根路径重跑初始化脚本。其他收费、平台与效果信息暂未提供。