关于 harvest
用于汇总工作区各 rig 的 `.agents/` 目录中的经验、模式和研究内容。它会去重,并将高置信度项目推广到 `~/.agents/learnings/`,供各 rig 使用。
主要功能
- 01扫描各 rig 的 `.agents/` 目录
- 02提取经验、模式和研究内容
- 03按内容哈希去重
- 04将符合条件的项目推广到共享目录
- 05执行前预览并确认
适用场景
- 01汇总多 rig 开发后的知识
- 02定期进行知识治理扫描
- 03将选定内容推广至各 rig
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ boshu2/ agentops --skill harvest安装后在 Claude Code 中输入/harvest确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/governance.mdharvest.featurescripts/validate.sh详细介绍
Harvest — 跨 Rig 知识整合
用法:
/harvest用于手动扫描和 CI 运行。(旧版用于封装 harvest 的每晚/dream start循环已停用——会话外的复利流程已移至 Gas City;目前没有运行中的 Dream 进程,也没有需要等待的.agents/overnight/run.lock。)
扫描工作区中的所有 .agents/ 目录,提取经验、模式和研究成果,跨 Rig 去重,并将高价值内容提升至全局知识中心(~/.agents/learnings/)。
命名陷阱。
$harvest会将内容提升至~/.agents/learnings/,而不是~/.agents/。用户常说“将所有内容 harvest 到~/.agents”,实际指的是 提升中心。如果确实要原样镜像所有原始产物(而不仅是待提升的内容),应使用rsync,而不是$harvest。
我需要哪个 skill?
请参阅 docs/skills-decision-tree.md,查看涵盖 harvest、compile、 dream、knowledge-activation 和 quickstart 的完整“下一步使用哪个 skill?”决策表。
此技能的作用
知识飞轮会按 Rig 捕获经验,但这些经验仍彼此隔离。Harvest 会遍历所有 Rig、提取产物、按内容哈希去重,并将高置信度内容提升至全局中心,供每个 Rig 通过 ao inject 访问,从而形成闭环。
使用时机: 在 evolve 周期之前、跨多个 Rig 密集开发之后,或作为知识治理的一部分每周使用。
输出: .agents/harvest/latest.json(目录)+ 提升至 ~/.agents/learnings/ 的文件
执行步骤
步骤 1:预览范围(试运行)
ao harvest --dry-run --quiet
读取 .agents/harvest/latest.json 并报告:
- 发现的 Rig 数量
- 提取的产物总数
- 唯一项与重复项的数量
- 候选提升项(置信度 >= min confidence 的产物)
步骤 2:确认执行
如果设置了 --auto,则跳过。 否则,显示试运行摘要并询问:
Harvest will promote N artifacts from M rigs to ~/.agents/learnings/.
Proceed? [Approve / Adjust threshold / Abort]
步骤 3:执行 Harvest
ao harvest --roots ~/gt/ --promote-to ~/.agents/learnings --min-confidence 0.5
步骤 4:Harvest 后清理
对提升目标执行去重,清理所有剩余重复项:
ao dedup --merge ~/.agents/learnings/ 2>/dev/null || true
步骤 5:报告结果
向用户报告:
- 扫描的 Rig 数量
- 提取的产物数量及唯一项数量
- 发现的重复项(附主要重复组)
- 已提升的产物(附来源信息)
- 主要发现(置信度最高的跨 Rig 模式)
标志
| 标志 | 默认值 | 说明 |
|---|---|---|
--auto | off | 跳过确认环节 |
--roots | ~/gt/ | 覆盖要扫描的根目录 |
--min-confidence | 0.5 | 提升内容所需的最低置信度 |
--include | learnings,patterns,research | 要提取的产物类型 |
快速开始
/harvest # Full sweep with confirmation
/harvest --auto # Hands-free sweep
/harvest --min-confidence 0.7 # Only promote high-confidence items
/harvest --roots ~/gt/,~/projects/ # Scan additional directories
治理
请参阅 references/governance.md,了解持续治理模型: 大小预算、扫描频率、过时阈值和跨 Rig 综合触发条件。
另请参阅
- skills/compile/SKILL.md — 单 Rig 的 Mine/Grow/Defrag
- skills/flywheel/SKILL.md — 飞轮健康监控
- skills/inject/SKILL.md — 将知识注入会话
- skills/forge/SKILL.md — 从对话记录中提取知识
参考文档
- references/governance.md — 持续知识整合的治理模型
- references/harvest.feature — 可执行规范:扫描 .agents 内容、整合并去重、编写经验,手动执行或通过 dream 循环执行(soc-qk4b)