用途：不产出新知识内容，只保证 vault 基础设施干净可信并可留痕，处理死链、重复文件名、标签漂移、过期文章、总览地图过时、多 AI 改动无记录三类问题。
主要能力： ① 周维护，运行 python3 scripts/lint_vault.py --vault <path> 得到四类发现，AI 汇总生成 <vault> 内周报（如 2026-W28-vault周报.md），含近 7 天新增统计、四类发现、已执行安全修复、建议人工处理清单，四节均写，无发现写“无”。只做确定性安全修复，有歧义只记入简报。 ② 地图重生成，python3 scripts/gen_vault_map.py --vault <path> 覆盖 <vault>/20_资料库/OB知识库地图.md，支持 --output 干跑预览；遍历目录树，.md 渲染为 wikilink，超 40 文件目录压缩显示，统计动态计算。 ③ 会话日志接入，按 references/session-log-setup.md 配置 Claude Code hooks 或 Codex notify 加 wrapper，底层脚本 session_end_log.sh（--agent 区分子目录）与 codex_notify_wrapper.sh。改配置前必须征得用户同意，已有配置合并追加不覆盖。
使用方式：安装命令 npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-maintain -y。vault 路径用 --vault <path> 或私有 config.yml 的 env.OBSIDIAN_VAULT（--vault 优先），未提供则报错退出。私有配置路径 ~/.config/soia-skills/soia-pkm-maintain/config.yml，可用 SOIA_PKM_MAINTAIN_CONFIG_FILE 覆盖。日志目录可用 --log-dir 或 SOIA_SESSION_LOG_DIR 覆盖，默认 30_日志与思考/20_Agent工作日志。lint 支持 --json、--exclude、--tags。
限制与边界：需 Python 3（纯 stdlib）与 bash；附件类 wikilink 跳过死链检查；主题归类、MOC 重建转交 soia-pkm-organize-article-moc，微信读书同步与书库补建分别转交对应技能；敏感信息只放私有配置或环境变量；执行后需给出完成回执、文件变更、验证与下一步。具体收费与平台细节资料暂未提供。