knowhow-distill 用于把 .knowhow/inbox/ 中堆积的收集内容提炼为知识库资产,可以是 wiki 页面、技能或工作流。它强调一个核心规则:处理 inbox 前必须先读 wiki/index.md、skills/registry.md、workflows/registry.md,优先改进已有内容而非新建,避免知识碎片化。
使用前检查 .knowhow/ 是否存在于工作区根目录,inbox 至少有一个文件;若为空则提示“Không có gì để đúc kết.”并停止。
流程上,它先读注册表,再扫描 schema-signals.md 中的 promote-candidate 信号:同一页面 slug 累计 3 票以上,或用户主动放入 promote_of,就建议把该 wiki 页面升级为技能或工作流。随后读取 inbox 每个文件并分类:可复用的操作归技能,带领域、多步骤、调用多个技能的链路归工作流,概念、决策、经验、故障处理等归 wiki 页面;不确定时默认 wiki 页面。对每个条目,它会用关键词 grep 实际内容查重,再按决策表选择新建、更新、替代并标记旧内容 deprecated、添加“## Mâu thuẫn đang mở”保留双方说法并降低 confidence、精炼技能/工作流、合并同类页面或归档跳过。
它还会记录结构进化信号:出现不属于现有 wiki 类型的条目时发 no-fit-type,重复出现标准模板外的自定义小节时发 adhoc-section。
执行前需用户逐条批准,并可修改动作、目标页面和类型。执行时按标准格式创建或更新页面,至少写入 title、type、tags、created、updated、status,wiki 加 confidence,技能/工作流加 version;技能必须填 trigger、input、output。随后更新对应 registry,建立 [[...]] 与 related 双向链接,合并或弃用时用 grep -rln "[[old-slug]]" .knowhow 改写入链,追加 changelog 并提高版本。被升级的页面保留并反向链接新技能。处理成功的 inbox 条目移动到 archive/inbox/,不硬删除;操作记录写入 wiki/log.md。
限制:它不自行改动 schema,结构变更交由 knowhow-lint schema-review;不删除未经用户批准的 inbox 条目;不新建可被更新替代的页面;合并时保留原页面所有有价值信息;修改页面时保留与本次变更无关的部分。资料未提供具体安装命令、收费方式或平台支持信息。