用途:维护 PKM 闭环的基础设施,不产出新知识内容,只处理内容腐化、地图过时、AI 改动无留痕三类问题。
主要能力: 一、周维护。运行 python3 scripts/lint_vault.py --vault <path> 做死链、重复文件名、主标签漂移、过期文章四类体检,AI 汇总写周简报至 <vault>/<周报目录>/<YYYY>-W<ISO周数>-vault周报.md,含 frontmatter 与四个小节。 二、全库地图重生成。python3 scripts/gen_vault_map.py --vault <path> 覆盖 <vault>/20_资料库/OB知识库地图.md,或用 --output /tmp/x.md 干跑预览;.md 渲染为 wikilink,非 .md 只列名,大目录压缩显示。 三、会话日志接入。按 references/session-log-setup.md 配置 Claude Code 的 hooks.SessionEnd 与 Codex 的 notify 加包装层,脚本为 scripts/session_end_log.sh 与 scripts/codex_notify_wrapper.sh。
使用方式:安装命令 npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-maintain -y;配置路径 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-maintain/config.yml 或环境变量 SOIA_PKM_MAINTAIN_CONFIG_FILE;vault 用 --vault <path> 或私有配置 env.OBSIDIAN_VAULT(--vault 优先)。修改 settings.json 或 config.toml 前须征得用户明确同意,已有 hooks 需合并追加而非覆盖。
适用场景:Obsidian vault 周期性体检、周报生成、知识库地图更新、AI 会话留痕配置。
限制:仅安全且无歧义的修复才直接执行;涉及主题归类或 MOC 合并转交 soia-pkm-organize-article-moc,书库相关需求转交其他技能;未指定 vault 且无配置时报错退出;附件类 wikilink 跳过死链检查。具体收费、许可等资料暂未提供。