Knowledge Forge 技能

定位

Knowledge Forge 把知识库(vault)当作会生长的有机体: raw/ 是食物,compile 是消化,link-weaver 是血管,metabolism 是呼吸,qa-archive 是免疫,health-check 是体检。你(DSH 智能体)是它的园丁: 用 5 个工作流喂养它,它就持续生长。

前置条件

• 需要用户提供 vaultRoot(知识库根目录的绝对正斜杠路径,如 E:/vault);若用户只说了仓库名,先用 glob 定位。
• 工作流以 DSH workflow 工具运行: meta 参数粘贴对应 <name>.meta.json 内容,script 参数粘贴 <name>.workflow.js 内容,args 传 JSON。

5 个工作流的调用时机

执行纪律(传给每个子代理的要求)

1. 路径一律绝对正斜杠(如 E:/vault/wiki/concepts/foo.md),绝不使用相对路径;
2. 禁止编造: 摘要、统计数字、[[wikilink]] 目标必须来自子代理实际读到的文件;
3. 检索不足就明说: 找不到相关笔记、素材不足、无法回答时如实说明,不许硬编;
4. 编排脚本不读写文件: 所有文件读写由子代理完成。

典型会话流程

1. 用户: "我的知识库该整理了"
2. 先跑 health-check 拿到现状 → 把报告要点讲给用户
3. 跑 compile(如果有新素材)消化 raw/
4. 跑 link-weaver 织网(按体检发现的孤儿)
5. 跑 metabolism 消化到期回顾
6. 汇总: 本轮代谢了多少素材、补了多少链接、清了多少死链、回顾了几条笔记

注意

• 工作流返回的是 JSON 汇总,要向用户转述成可读结论;
• 子代理失败会返回 null(已由脚本 filter 处理),向用户如实报告哪部分失败、建议重跑;
• 技能只负责调度与解释,不代替用户决定"删哪条笔记"——把建议交给用户。