soia-pkm-extract-vault-knowledge 是一款面向 Markdown/Obsidian 知识库的长期知识提炼技能,目标是把带时间、任务状态或来源噪声的材料,提炼为“20 区长期知识”,新建知识而不搬走证据;原始报告、文章、日志和历史导入语料继续留在各自证据层。
主要能力 先查重,再从一个或多个来源提炼概念、指南、参考、检查表或通用模式;删除当前进度、责任人、下一步和一次性环境值,保留适用边界、反例、时效说明与来源 wikilink;在写入前识别账号、密码、token、cookie、个人路径、客户数据等敏感内容,知识笔记只保留抽象方法;盘点资料库时区分“精选长期知识”和“历史导入/来源语料”,不把旧语料的目录位置当成可信度;处理 PDF、Word、表格或图片来源时,先标记原始附件类型和提取/OCR 状态,没有正文提取证据时只能引用文件名/路径,不能把附件标题当成结论。
使用方式 提供 vault 路径以及来源笔记、主题或待整理范围。Agent 先给候选与去向;单篇且目标明确时可直接 create-only,新建超过 3 篇、存在重名或涉及敏感内容时必须先确认逐项计划。执行流程包括:读取根 AGENTS.md、来源区与 20_资料库/AGENTS.md;用查询技能先查目标标题、主题和反向链接;把候选分为 extract、move、evidence_only、needs_review 四类;对 extract 写计划并用脚本生成 create-only manifest;检查 ready_to_write 并让客户确认后 create-only 写入;用脚本验证来源未漂移、目标 schema、来源 wikilink、开放项、私有绝对路径和秘密值候选;涉及 20 区或新建文件时按索引同步合同重建地图,必要时运行 vault_index_verify.py。
安装命令 装整个域(Claude Code 与 Codex 共用同一份域插件): 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-extract-vault-knowledge -y
WorkBuddy 的装载单位是角色化专家而不是插件,npx skills add -a '*' 覆盖不到它,需要单独安装,见 docs/install/workbuddy.md。
依赖与边界 需要 soia-pkm-query-vault 做查重与来源定位;移动误放文件时转 soia-pkm-manage-vault-lifecycle;完成后可用 soia-pkm-maintain-vault-health 检查链接和地图;文章主题/MOC 整理由 soia-pkm-organize-article-moc 负责。不得用 move 把 30 区冻结证据迁到 20,应保留 30 原件并新建 20 区提炼稿。目录改名属于生命周期迁移,不由本技能直接执行。
私密信息与验收 默认不把历史导入语料的正文片段写进终端或会话日志;不得把凭据、真实账号、私有绝对路径、客户身份或家庭信息复制到知识笔记、manifest 或公开 skill 仓库。验收要求:来源保留且 SHA-256 与计划一致;目标是新文件,frontmatter 完整,首标签为 资料库,含长期知识 与来源 wikilink;正文没有当前任务状态、开放待办或可识别秘密值;同主题已有笔记已合并或明确说明为何并存。回执包含来源、来源 SHA-256、查重结果、创建/跳过文件、剥离的状态类别、敏感信息处理、来源是否保留、链接验证和待人工判断项。
适用场景与限制 适用于从整个知识库或指定模块的工作台、冻结证据、文章、项目研究与历史语料中提炼长期知识;触发语包括“从知识库提炼长期知识”“把这份材料沉淀为知识”“从指定模块提炼”“从这份报告抽方法”。限制在于:需要先安装并配合查询技能;涉及多重名、冲突、过时或敏感信息时需人工确认;不负责移动文件、目录改名和健康检查;具体收费、价格、平台与效果资料暂未提供。