用途:这是 PKM 闭环中的整理环节,把杂乱的 Obsidian 收藏规整成结构化、可检索、能聚合的知识,解决归档堆积、未被激活的问题。
主要能力:补 frontmatter(缺 topics/captured_at/author 的补齐);主题归类(读文章内容判断挂哪些 topics 双链,优先复用 _MOC/ 已有主题,避免造重复主题);建/更新两级 MOC(一级分类→二级 topic);按月归位(clip 原生落在 <年>/,按文件名日期归到 <年>/<月>/);补双链(文章间、文章↔书↔日志)。
使用方式:用自然语言说明目标并提供必要输入(文件、vault 等)。安装命令:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-organize -y。配置路径:~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-organize/config.yml,可用环境变量 SOIA_PKM_ORGANIZE_CONFIG_FILE 指定自定义配置;无私有配置时可不创建 config.yml。底层脚本 rebuild_moc.py 支持 --vault/OBSIDIAN_VAULT 指定库路径,分类表可用 _MOC/.categories.json 覆盖默认值。
前置规程:任何整理任务开工前须先加载 references/知识库整理规程.yml,先只读探明现状、发现同类先并入,再提最小方案供确认,确认后才批量执行。
回执要求:执行后须输出做了什么、文件变更(完整路径)、日志摘要、验证、问题与下一步。
限制:依赖项、权限、配置或 key 缺失时须停止相关动作并明确指出;秘密信息只能放私有配置、环境变量或 provider 登录态,不得写入仓库、vault 正文或日志;第三方 skill 只声明依赖和安装方式,不修改其文件;涉及删除、覆盖、发送、发布、写远端状态须先确认,可 dry-run 的先预览。具体支持的脚本参数细节以脚本 --help 与 SKILL.md 为准。