harvest について
harvest は、修正点や確定した事実、作業上の教訓、スキルの不足を記録するセッション学習スキルです。知見を一時保管し、承認後に永続的なナレッジファイルへ反映します。
主な機能
- 01セッション中の修正点と事実を収集
- 02作業上の教訓とスキル不足を記録
- 03既存ノートとの重複を除外
- 04一時保管した項目を承認用に整理
- 05反映後にナレッジ索引を更新
活用シーン
- 01セッション終了時にプロジェクトの決定事項を記録
- 02永続化の前に一時保管ノートを確認
- 03繰り返す教訓をスキルやルールの修正に反映
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ huytieu/ cog-second-brain --skill harvestインストール後、Claude Code で/harvestを入力して読み込まれたか確認します。
詳細
/harvest — セッション学習の記録
dwarves-kit の harvest フックと vault lizard パイプラインをベースにしています。暗黙知がトランスクリプトの中で失われるのを防ぎます。
トリガー
/harvest— セッション終了時に手動で実行/harvest promote— ステージングから lizard の下書きを整理(harvest-curator を使用)stopフックがステージングファイルを書き込みます(.cursor/hooks/harvest-stager.sh)
フェーズ 1 — 収集(自動または手動)
現在のセッションをスキャンし、次の項目を確認します。
- あなたが行った訂正(「いいえ、実際は X です」、成果物の却下)
- 新たに得られた安定した事実(ID、URL、決定事項)のうち、05-knowledge にまだ記録されていないもの
- プロセスに関する教訓(うまくいったこと、失敗したこと、摩擦)
- スキルの不足(Verify の手順や CLAUDE.md のルールに加えるべきこと)
04-projects/harness/harvest/staging-<YYYY-MM-DD>.md に追記します。
## <HH:MM> — <trigger>
- type: correction|fact|process|skill-gap
- source: <file or "session">
- text: <one paragraph max>
- proposed_home: <path or "new lizard note">
重複排除:同じ事実が今日のステージングファイルまたは 05-knowledge にすでに記録されている場合はスキップします。
フェーズ 2 — 整理(/harvest promote)
harvest-curator(Sonnet)を起動します。/tmp/harvest-curate-<date>.md に書き込みます。
リード(Opus)がユーザーに提示します。
- 昇格リスト →
05-knowledge/lizard/YYYY-MM-DD-<slug>.mdに追加する項目を承認 - 統合リスト → 既存のメモへのインライン編集を承認
- スキルのパッチ → CLAUDE.md / SKILL.md の差分を承認
承認後にのみ、永続ファイルを書き込みます。05-knowledge/lizard/index.md を更新します。
フェーズ 3 — 振り返りの記録
01-daily/journal/<today>.md に 1 行記録します。
Harvest: <n> staged, <m> promoted, <k> folded
ルール
- Harvest は提案のみを行います。05-knowledge への書き込みは自動で行いません。
- 既存の知識と矛盾する場合は、両方にフラグを付けてユーザーに確認します。
- 環境に依存する事実を
~/.claude/.../memory/に記録する場合は、毎月/memory-hygieneと組み合わせてください。
夜間の拡張(任意)
Harvest を無人で実行する場合は、次の順序でスキルを呼び出すジョブをスケジュールします。COG にはフックが含まれていないため、事前にインストールするものはありません。
/memory-hygiene
/harvest promote # only if the staging file is non-empty
/content-factory # only if scheduled
コメント
Markdown 対応