mcpField
S
salvage

salvage

github.com/open-horizon-labsエージェントワークフロー3105 回インストール12 週間前に更新
リポジトリ

salvage について

salvage は、方針が停滞したり再開を検討したりする際に学びを抽出するエージェントスキルです。発見事項や制約、背景、再利用できる成果を再出発用のレポートにまとめ、日常的な振り返りとは区別します。

主な機能

  1. 01作業をサルベージするタイミングの判断
  2. 02学びと制約の体系的な抽出
  3. 03新たな試行向けの再開キット
  4. 04重要な知見の記録
  5. 05セッション引き継ぎレポート形式

活用シーン

  1. 01停滞した方針を断念する前の学びの記録
  2. 02実装中に判明した制約の記録
  3. 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 を置き換えるか追記してください。後続の試行では、サルベージレポートを再開時のコンテキストとして使い、失敗したコードを維持する指示として扱わないでください。

コメント