salvage について
salvage は、方針が停滞したり再開を検討したりする際に学びを抽出するエージェントスキルです。発見事項や制約、背景、再利用できる成果を再出発用のレポートにまとめ、日常的な振り返りとは区別します。
主な機能
- 01作業をサルベージするタイミングの判断
- 02学びと制約の体系的な抽出
- 03新たな試行向けの再開キット
- 04重要な知見の記録
- 05セッション引き継ぎレポート形式
活用シーン
- 01停滞した方針を断念する前の学びの記録
- 02実装中に判明した制約の記録
- 03新しいセッションへの背景と成果の引き継ぎ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ open-horizon-labs/ skills --skill salvageインストール後、Claude Code で/salvageを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/extraction.md
詳細
/salvage
再開する前に学びを抽出します。コードは安価ですが、学びは資産です。
使用するタイミング
作業が迷走している、アプローチを何度も覆している、スコープが広がり続けている、ゴールが何度も先送りされている、または最初からやり直すのがよいと感じる場合は、/salvage を実行してください。
使用しない場合: 作業が順調なとき。Salvage は、定期的な振り返りではなく、再開前に学びを抽出するためのものです。
JIT リファレンス
サルベージでコアレポート以上に深い学びの抽出が必要な場合に限り、references/extraction.md を読み込みます。
Salvage の手順
ステップ 1:現状を認識する
「このセッション/アプローチは、[理由] によりサルベージします。当初の目的は [目的] でした。実際には [現実] となりました。」
ステップ 2:重要なことを抽出する
存在する内容だけを抽出し、空のカテゴリを無理に埋めないでください。
コアカテゴリ:
- 学び: 理解が変わったのはどのような点ですか?
- 前提の変化: 現実を説明できなくなった見立ては何ですか?
- ガードレール: どのような制約を苦労して発見しましたか?
- 不足していたコンテキスト: 何をもっと早く調べるか、尋ねるべきでしたか?
- オーナーシップ/調整: 権限、担当者、引き継ぎ、レビュー、異論、検証の境界で曖昧になったものは何ですか?
- 再利用できる断片: 残しておく価値のあるコード、パターン、または部分的なアプローチは何ですか?
RNA/OH ツールが利用できる場合は、新しいものを書く前に既存の metis/ガードレールを確認してください。類似した項目を新たに作るのではなく、既存の項目を更新または強化してください。
ステップ 3:再スタート用にまとめる
再スタートキットを作成します。当初の目的、サルベージした理由、重要な学び、前提の変化、新たなガードレール、オーナーシップ/調整の問題、再開に必要なコンテキスト、再利用できる断片をまとめてください。
ステップ 4:学びを記録する
ノイズではなく、metis を記録します。後の判断を変えるような、明白ではない制約、異常、トレードオフ、ローカルなパターンだけを記録してください。一般的なベストプラクティスの助言は、ローカルでの活用価値がないままコンテキストコストを増やします。
同じ学びがサルベージを繰り返すたびに現れる場合は、/distill を実行してください。コーパスには知識がありますが、参照されていません。
出力形式
## Salvage
### Salvage Report
**Salvaged:** [date/session identifier]
**Reason:** [why this work is being salvaged]
**Original Aim:** [what we were trying to do]
### Learnings
[Numbered list of key insights]
### Frame Shifts
[Old frame → new frame, with evidence]
### New Guardrails
[Explicit constraints with reason and trigger]
### Missing Context
[What would have helped]
### Ownership / Coordination Breakdowns
[Authority boundary, missing owner, or handoff rule]
### Reusable Fragments
[Code or patterns worth keeping]
### Fresh Start Recommendation
[How to approach this next time]
セッションの引き継ぎ
セッションファイルを使用している場合は、以前のフェーズのセクションを読み取ってから、## Salvage を置き換えるか追記してください。後続の試行では、サルベージレポートを再開時のコンテキストとして使い、失敗したコードを維持する指示として扱わないでください。