用途:pk-distill 将 inbox 知识沉淀为结构化知识:知识页(knowledge page)、技能(skill)或工作流(workflow),优先改进已有内容而非新建。
主要能力:处理前必读 knowledge/index.md、skills/registry.md、workflows/registry.md;需先满足快照条件(.cockpit/ 存在,否则转 pk-init 模式 new)。工作来源需至少其一:inbox 中 domain: knowledge、status: pending 的条目,或达到 promote-candidate 阈值的页面。支持新建、更新、替换、合并知识页,细化(refine)技能/工作流,或跳过归档。含 promote 流程,可将知识页升级为技能/工作流。
使用方式:按流程执行——读注册表、扫描 promote 信号、读 inbox、分析并给出建议、用户逐项审批、执行写入(更新或覆盖 body 前先读现有 body)、更新注册表与交叉引用、处理 promote、清理 inbox(移动到 archive/inbox/,不硬删除)、追加日志。合并或弃用时需 grep -rl "[[slug-cũ]]" .cockpit/ 重写入站链接。
适用场景:个人知识库中把 inbox 待处理知识整理成可复用结构化资产,并在使用量等信号充分时提升为技能或工作流。
限制:只有少量(2)来源时走 promote-only 分支;低于阈值或来源为空则停止。type=thought 不生成最终知识页,需重分类或丢弃。promote 前必须确认页面含 procedure block,否则停止该分支。usage_count 只是辅助证据,需从 log 重算,不信任索引缓存。页面超过 150 行或含 3 个以上无关主题时建议拆分。