harvest

Harvest — リグ間のナレッジ統合

使用方法： /harvest は手動の一括処理と CI の実行に使用します。（以前の、harvest をラップしていた夜間ループ /dream start は廃止されました。セッション外での蓄積は Gas City に移行しており、稼働中の Dream プロセスも、待機すべき .agents/overnight/run.lock もありません。）

ワークスペース内のすべての .agents/ ディレクトリを巡回し、学び、パターン、調査内容を抽出してリグ間で重複を排除し、価値の高い項目をグローバルナレッジハブ（~/.agents/learnings/）に昇格します。

名前に関する注意点。 $harvest が昇格する先は ~/.agents/ ではなく、~/.agents/learnings/ です。ユーザーが「すべてを ~/.agents に harvest して」と言う場合、昇格先のハブを意味していることがよくあります。すべての生のアーティファクト（昇格対象だけでなく）をそのままミラーリングしたい場合は、$harvest ではなく rsync を使用してください。

どのスキルが必要ですか？

harvest、compile、dream、knowledge-activation、quickstart を対象とした「次にどのスキルを使うか？」の決定表全体については、docs/skills-decision-tree.md を参照してください。

このスキルの機能

ナレッジフライホイールはリグごとに学びを蓄積しますが、それぞれがサイロ化しています。Harvest はすべてのリグを巡回してアーティファクトを抽出し、コンテンツハッシュで重複を排除し、信頼度の高い項目をグローバルハブに昇格させることで、この循環を完結させます。各リグは ao inject を通じてハブにアクセスできます。

使用するタイミング： evolve サイクルの前、複数のリグで集中的に開発を行った後、またはナレッジガバナンスの一環として毎週使用します。

出力： .agents/harvest/latest.json（カタログ）＋ ~/.agents/learnings/ に昇格されたファイル

実行手順

ステップ 1：対象範囲をプレビューする（ドライラン）

ao harvest --dry-run --quiet

.agents/harvest/latest.json を読み込み、以下を報告します。

• 検出されたリグ数
• 抽出されたアーティファクトの合計数
• 一意のアーティファクト数と重複数
• 昇格候補（信頼度が最小値以上のアーティファクト）

ステップ 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：結果を報告する

ユーザーに以下を報告します。

• スキャンしたリグ数
• 抽出したアーティファクト数と一意のアーティファクト数
• 検出された重複（上位の重複グループを含む）
• 昇格されたアーティファクト（出所を含む）
• 主な発見事項（信頼度が最も高いリグ間パターン）

フラグ

フラグ	デフォルト	説明
--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 を参照してください。

関連項目

• skills/compile/SKILL.md — 単一リグでの 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）