experience_loader について
experience_loader は、タスクの実行前に再利用可能な経験を検索するエージェントスキルです。適用条件と除外条件を確認し、現在の事実に照らしてガイダンスを再検証します。
主な機能
- 01タスクに応じた経験検索
- 02適用条件と除外条件の確認
- 03経験の選択的な読み込み
- 04現在の事実に基づく再検証
- 05複数の意図を含むタスクへの対応
活用シーン
- 01実行前に関連ガイダンスを探す
- 02適用外の経験を除外する
- 03複数の意図を含むタスクを処理する
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ volcengine/ openviking --skill experience_loaderインストール後、Claude Code で/experience_loaderを入力して読み込まれたか確認します。
詳細
experience_loader
再利用可能な実行経験が役立つ可能性がある場合は、タスクに着手する前にこのスキルを使用してください。
必須のワークフロー
- タスクに着手する前に、現在のタスクを説明する自然言語のクエリを使って
search_experienceを呼び出します。 - 現在のドメイン、ユーザーの意図、対象、要求された操作、ポリシー関連のキーワード、および関連しそうなツール/アクションの種類をもとにクエリを作成します。「ユーザーを助ける」のような曖昧なクエリは避けてください。
- 返された候補を確認します。各候補は、マッチしたケースと関連付けられた経験エントリで構成されます。各経験エントリには、
name、uri、適用条件と除外条件を説明する短いsituationの抜粋が含まれます。 - 読み込み前に適用可否を確認します。 関連付けられた各経験について、
situationの抜粋を読み、現在のタスクがその経験の適用条件に一致し、かつ除外条件や「不適用于」/「does not apply to」に該当しないことを確認します。ケースを明示的に除外する経験(例:対象外の客室クラス、搭乗済みのフライト、異なるアクション種別、異なる変更種別)はスキップします。この確認を通過し、適用可能と思われる経験に対してのみread_experienceを呼び出してください。適用可否を通過する経験がない場合は、経験のガイダンスを参照せずに続行します。 - 絞り込んだキーワードで
search_experienceを複数回呼び出してもかまいません。また、確認を通過した経験についてread_experienceを複数回呼び出してもかまいません。 - 読み込んだ経験は再利用可能なガイダンスとして扱い、現在のタスクに関する事実として扱わないでください。現在のポリシー、現在のツール結果、現在のユーザー情報は、過去の経験より優先されます。
- 読み込み後に再確認します。
read_experienceの呼び出し後であっても、経験に基づいて行動する前に、ツールから取得した現在の事実(客室クラス、予約状況、フライトの日付、区間の状態など)に照らして## Situation全体を確認します。現在判明している事実が「不适用于」/除外条件に該当する場合は、その経験を破棄し、経験のApproachやReflectを適用せず、ポリシーとツール結果に基づいて対応してください。 - 複数の意図を含むタスク(例:「キャンセルしてから予約する」「アップグレードしてからフライトを変更する」「変更を断って代替案を提示する」)では、複数の経験が正当に必要になる場合があります。各意図の経験を個別に確認して適用してください。経験の1つの区分がローカルの終了マーカーに達したからといって、タスクを終了(
done/transfer_to_human_agents)してはいけません。ユーザーに未対応の意図が残っているか確認してください。 - 適用可否の確認後、関連すると思われる経験がない場合は、経験のガイダンスを参照せずに続行します。
読み込んだ経験内のローカルな終了マーカー
経験の終了マーカーは、対象となる意図/サブタスクにのみ適用されます。タスク全体の成否を示すものではなく、done を呼び出す許可でもありません。
RETURN_COMPLETED:この経験が対象とする特定の意図/サブタスクが完了しています。通常、必要な業務情報の読み取り/書き込みツールの呼び出しと、必要な顧客への連絡が行われた後を指します。ユーザーに別の独立した意図がある場合は、会話を終了せず、次の意図に対応してください。RETURN_BLOCKED(reason="..."):現在の事実、ポリシー、入力情報の不足、拒否の境界、またはエスカレーションの境界により、対象の意図/サブタスクを続行できません。経験に必要な連絡/エスカレーションを行ったうえで、ユーザーに対応可能な別の意図が残っていれば続行してください。RETURN_NOT_APPLICABLE:経験は現在の事実に合致しません。破棄し、他の該当する経験または現在のポリシー/ツールの事実を使用してください。
拒否、選択肢なし、ポリシー上の対象外、入力情報不足、および transfer_to_human_agents の分岐は、その対象の意図に限って RETURN_BLOCKED(...) と解釈してください。会話全体の終了を意味するものではありません。全体を終了する前に、ユーザーのすべての意図が完了、ブロック、非該当、またはユーザー/環境によって明示的に移管・停止されていることを確認してください。
ツール
search_experience(query, limit=10):現在のユーザーの OpenVikingmemories/casesを検索し、一致した各ケースの## Linked Experiencesセクションを読み取り、ケースのスコア、ケース URI、タスクのシグネチャ、入力の概要、リンクされた経験エントリー(それぞれにname、uri、経験の## Situationセクションから抜粋したsituationの抜粋を含む)を持つ JSON 候補を返します。read_experience(experience_uri):URI 全体で指定した OpenViking の経験メモリーを読み取り、Markdown を返します。
コメント
Markdown 対応