用途:Harvest 用于跨 rig 的知识整合,解决各 rig 知识各自孤立的问题。它遍历工作区中的所有 rig,提取知识产物,按内容哈希去重,并将高置信度条目晋升到全局中枢,供其他 rig 通过 ao inject 访问。
主要能力:扫描全部 .agents/ 目录提取 learnings、patterns、research;跨 rig 去重;按最低置信度筛选后晋升到 ~/.agents/learnings/;生成目录文件 .agents/harvest/latest.json。
使用方式:先预览范围 ao harvest --dry-run --quiet,读取 latest.json 并报告发现的 rig、产物总数、去重情况与晋升候选;确认后执行 ao harvest --roots ~/gt/ --promote-to ~/.agents/learnings --min-confidence 0.5;随后运行 ao dedup --merge ~/.agents/learnings/ 清理重复;最后报告扫描的 rig、提取与去重数量、晋升结果及高置信度跨 rig 模式。也可用 /harvest、/harvest --auto、/harvest --min-confidence 0.7、/harvest --roots ~/gt/,~/projects/。
主要参数:--auto 跳过确认;--roots 覆盖扫描根目录,默认 ~/gt/;--min-confidence 晋升最低置信度,默认 0.5;--include 指定提取类型,默认 learnings,patterns,research。
适用场景:evolve 周期前、多个 rig 密集开发之后,或作为每周知识治理的一部分。
限制与注意:$harvest 晋升目标是 ~/.agents/learnings/ 而不是 ~/.agents/,若需逐字镜像全部原始产物应使用 rsync。旧的 /dream 夜间循环已退役,不再有 Dream 进程或 .agents/overnight/run.lock 需要等待。其余治理细节(体积预算、扫描频率、过期阈值、跨 rig 综合触发条件)见 references/governance.md。