用途:创建平台中立的 Markdown 内容骨架与 AI 协作规则,初始化 AI-native PKM 基座。不创建 .obsidian、不装插件、不配 hook、不删除或覆盖现有文件,其他消费端配置由各自特化技能负责。
主要能力:创建 00/10/20/30/40/50/60/90 分区、下钻 AGENTS.md、工作台 Schema v2、长期知识 Schema 及模板;20 区精选目录为 10_主题知识、20_规范与手册、30_学习指南,历史导入用 90_历史导入。默认元信息目录为 00_Obsidian系统/,工作台收件箱为 10_工作台/00_Inbox/。建立 AGENTS.md 唯一规则源及 Claude/Gemini/opencode/workbuddy 适配层。支持 JSON/YAML 自定义配置、默认 plan、显式 --apply、create-only 幂等与 --check。
使用方式:提供目标目录、语言/命名偏好和是否继承默认结构;先运行 plan 审查 create/skip/conflict/drift;确认后加 --apply;再运行 --check 验证。命令: python3 scripts/init_vault.py <vault-path> python3 scripts/init_vault.py <vault-path> --apply python3 scripts/init_vault.py <vault-path> --check python3 scripts/init_vault.py <vault-path> --config <config.json> python3 scripts/init_vault.py --print-default-config --force --apply 为高风险兼容选项,须先显示逐文件 overwrite plan 并获授权。安装: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-bootstrap-vault-base -y。WorkBuddy 需单独安装。依赖 Python 3,JSON 零第三方依赖,YAML 需 PyYAML。配置 Schema v2 优先级:CLI > custom config > bundled defaults;目标须为 vault 相对路径,绝对路径、..、symlink 逃逸会失败。与其他技能有明确边界(Obsidian 设置、健康检查、生命周期、日志 hook、查询、附件提取、知识提炼等)。默认资产不含个人资料、账号、凭据、绝对路径或私有项目事实。