agent-self-recovery について
同じ試行を繰り返したり、タスクの目標を見失ったりしたエージェント向けの復旧手順です。状態を記録して停滞パターンを特定し、別の方法を試すか、支援を求めるか、タスクを引き継ぐよう促します。
主な機能
- 01反復試行や目標喪失の検出
- 02試行内容と状態のファイル記録
- 03停滞パターンの分類
- 04問題に応じた復旧手順の選択
- 05行き詰まり時のエスカレーション
活用シーン
- 01同じ修正を繰り返しても結果が変わらない場合
- 02修正のたびに別の依存関係が現れる場合
- 03エラーの原因が不明なタスクの調査
- 04元の要件を見失ったエージェントの軌道修正
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ archieindian/ openclaw-superpowers --skill agent-self-recoveryインストール後、Claude Code で/agent-self-recoveryを入力して読み込まれたか確認します。
同梱ファイルSTATE_SCHEMA.yaml
詳細
エージェントの自己復旧
状態ファイル:~/.openclaw/skill-state/agent-self-recovery/state.yaml
行き詰まっている兆候
- 同じ方法を3回以上試しても、結果が変わらない
- 目的に沿った変更ではなく、手当たり次第に変更している
- 当初の目標が分からなくなった
- 「簡単な」はずの手順に予想以上の時間がかかっている
復旧プロトコル
ステップ1:停止する
変更を加えるのをやめます。これ以上、手早く試すことはしません。
ステップ2:状態を記録する
状態ファイルに次の内容を記録します。
what_trying:何をしようとしていたかwhat_tried:今回の方法をリストに追加するloop_type:パターン名(ステップ3を参照)attempts:1増やすstatus: recoveringstarted_at:現在のタイムスタンプ(初回のみ)
ステップ3:ループの種類を特定する
loop_typeを選びます。
same-fix-variations— 同じ修正を少し変えながら試しているcascading-dependencies— 修正のたびに新たな依存関係が見つかるunclear-error— 実際のエラーが何なのか不明確lost-goal— 当初の要件を見失った
ステップ4:ループを断ち切る
loop_type: unclear-errorの場合 → まず systematic-debugging を使います。
loop_type: lost-goalの場合 → 元の要件を読み直します。
本当に行き詰まっている場合 → 状況を明確に記録してユーザーに尋ねます。状態をstatus: escalatedに更新します。
コンテキストが大きすぎる場合 → context-window-management を使います。
本当に見失っている場合 → task-handoff を使って、ユーザーに方向性を示してもらいます。状態をstatus: escalatedに更新します。
ステップ5:新しい方法で再開する
本当に異なる方法を選びます。状態のlast_approachを更新し、what_triedに追加します。
成功した場合:状態をstatus: recoveredに更新します。
コメント
Markdown 対応