用途：PKM 整理环节，把杂乱收藏规整成结构化、可检索、可聚合的知识，激活存量收藏、规整新归档。
主要能力：补 frontmatter 的 topics/captured_at/author；读取文章内容判断应挂哪些 topics 双链，优先复用 _MOC/ 已有主题；运行 scripts/rebuild_moc.py 重建两级主题地图（一级分类→二级 topic）；按月归位（clip 原生落 <年>/，按文件名日期移到 <年>/<月>/）；补文章间及文章与书、日志的关联双链；新建、移动、改名或删除文件/目录后按索引同步合同重建叶级地图，写入 20_资料库/ 时验证相关 .base。
使用方式：用自然语言说明目标并提供 vault 等必要输入。开工前须先加载并遵循 references/知识库整理规程.yml：先只读探明现状（结构、约定、模板，同类先并入）→ 提最小方案给用户确认 → 才批量执行。按月归位前先生成逐文件 source/target/SHA-256 清单，禁止裸 mv 猜目标。单篇归档后默认对该文件做最小整理闭环。用户说「仅归档」「不要整理」时只执行 clip；批量导入先收集清单，获确认后再调用。
安装：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-organize-article-moc -y；注意会落入共享真源 ~/.agents/skills，与插件同装会产生两份索引漂移，建议二选一。配置路径 ~/.config/soia-skills/soia-pkm-organize-article-moc/config.yml，可用 SOIA_PKM_ORGANIZE_ARTICLE_MOC_CONFIG_FILE 指定自定义路径；无私有配置可不创建。密钥、cookie、session 只能放私有配置、环境变量或 provider 登录态，不得写入仓库、vault 正文或日志。
分类原则：topic 优先复用 _MOC/ 已有项，无对应 MOC 时用纯文本分类或列入 unknown-topic 报告，不建空占位笔记；people 仅在人物笔记存在时用 wikilink；附件缺失保留原文件名与缺失证据，不伪造文件或假链接；映射写死在 rebuild_moc.py 分类表，可按库用 _MOC/.categories.json 覆盖。
限制：不先探明即动手会返工，重复造轮子、空模板、瞎猜分类均属浪费；整理失败不得把「已归档」包装成「已整理」；执行涉及删除、覆盖、发送、发布、写远端状态时需先确认。缺失事实（如具体价格、平台支持范围、效果指标）暂未提供。