Communitygithub.com

学習振り返りスキル

エージェント非依存のスキルで、リトライループを解消し、検証済みのワークフローレッスンを永続的なコンテキストとして保存します。

学習振り返りスキル とは?

このスキルは、AIエージェントが同じ問題で繰り返し失敗するループ(リトライループ)を防止し、一度解決した問題を再度試行錯誤させないための仕組みを提供します。主に「既知の問題」と「新規の問題」の2つのモードを持ち、既知の問題には過去のレッスンを即座に呼び出し、新規の問題では探索を妨げずに解決後にレッスンを記録します。Claude Code、Cursor、Codexなどのエージェントフレームワークで動作し、フックによる自動アクティベーションも可能です。レッスンの記録は書き込み許可ゲートを通過した後に、メモリやプロジェクトドキュメント、スキル本体などの適切な保存先に保存されます。また、独立したレビュアーによる検証を任意で行い、レッスンの品質と安全性を確保します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add Yingqi-Han/learning-retrospective-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

学習振り返り

このスキルは、検証済みのレッスンを将来のエージェントのための永続的なコンテキストに変換し、一度解決した問題が試行錯誤によって再解決されることを防ぎます。メインタスクを進行させ続けてください。振り返りは短い制御ループであり、新しいプロジェクトにしてはいけません。

失敗はエラーではありません。新しい問題への繰り返しの試行は正当な探索であり、抑制してはいけません。新しい問題に必要な規律は、逐語的な再試行を行わず、試行ごとに1つの明確な仮説を立てることだけです。このスキルが排除しようとする動作は異なります。それは、最初の解決策が保存されなかったか、保存されても呼び出されなかったために、同じ問題を二度目に苦労して解決することです。したがって、このスキルには強みの異なる2つのモードがあります。

  • 既知の問題(保存されたレッスンまたはメモリがこの失敗シグネチャをカバーしている):早期に介入する - 次の試行の前にレッスンを呼び出し、それに従う。
  • 新規の問題(事前のレッスンがない):探索を中断しない。逐語的な再試行ではなくアプローチを変え、解決した後にレッスンを記録する。

解決後キャプチャ

これは主要な自動モードです。タスクが成功した後、ターンを終了する前に1つの質問をチェックします。ここにたどり着くまでに2回以上の失敗、明白でない回避策、マシン固有の事実、または将来のエージェントが再発見しなければならない操作手順が含まれていましたか?「はい」の場合、ワークフローのステップ5〜6を実行します(レッスンをキャプチャし、適切な保存先に保存し、書き込み許可ゲートに従います)。「いいえ」の場合、通常通り終了します - ルーチンワークからレッスンを捏造してはいけません。

キャプチャは、証拠がまだコンテキストにあるうちに行わなければなりません:正確なコマンド、正確なエラーテキスト、試したことと失敗した理由。苦闘の記憶から書かれたレッスンは、そのトランスクリプトから書かれたレッスンよりも価値が低くなります。

ループシグナル

以下の1つ以上のシグナルが現れた場合、振り返りをトリガーします。

  • 同じコマンド、テスト、変換、インストール、API呼び出し、またはUIアクションが2回失敗する。
  • 検証済みのローカルファクトがチェックされるべきだった後に、エージェントが広範なディスカバリーを開始する。
  • 新しい仮説なしにエージェントが繰り返しツールを切り替える。
  • ユーザーがエージェントはループしている、以前の作業を忘れている、またはレッスンを覚えるべきだと言う。
  • 修正がマシン固有のパス、環境変数、インストール済みツール、認証情報フロー、アカウント状態、またはプロジェクトの慣習に依存する。
  • 失敗が明白でないコマンド、ローカルの回避策、または操作手順によって解決された。

このワークフローをすべての小さなエラーに対して実行しないでください。レッスンが再利用可能であるか、現在の動作が時間を無駄にし始めている場合に使用してください。

非トリガー

以下の場合、このスキルを呼び出さないでください。

  • 初回の通常のエラーで、明らかな次の修正がある場合。
  • 各試行が新しい証拠を生成する通常のデバッグ。
  • 純粋な説明、要約、翻訳、または作成タスク。
  • 繰り返しの失敗パターンがまだ現れていない広範なプロジェクトレビュー。
  • ワークフローレッスンを含まない、ユーザーが要求したメモリ更新。

書き込み許可ゲート

ユーザーメモリ、リポジトリドキュメント、プロジェクトルール、または別のスキルに書き込む前に:

  • ユーザーが明示的にレッスンの保存、更新、または書き込みを要求した場合、続行します。
  • それ以外の場合、最初に提案されたレッスンとターゲット保存先を提示します。
  • プロジェクトの指示、スキル、または永続メモリをサイレントに変更しないでください。
  • シークレット、トークン、認証情報、クッキー、プライベートデータ、または長い生のログを保存しないでください。

ワークフロー

  1. ループを一時停止する。

    • 逐語的な再試行、広範で焦点の定まらない検索、投機的な編集を停止する。
    • 即時の目標、最後に失敗したアクション、正確なエラーまたは症状を述べる。
    • 方向転換する前に、実行中のプロセスやユーザーデータを保持する。
  2. 証拠を再構築し、問題を分類する。

    • まず、既存のメモリとプロジェクトガイダンスをこの失敗シグネチャについて検索する。以前のレッスンがそれをカバーしている場合、これは既知の問題です:レッスンを再導出する代わりにそれに従う。
    • 何もカバーしていない場合、これは新規の問題です:変化する仮説で探索を続け、解決後にレッスンをキャプチャする計画を立てる。
    • すでに検証されているもの(パス、バージョン、コマンド、出力、ファイル)をリストする。
    • ドリフトしやすい事実については、仮定よりも安価な検証を優先する。
  3. 1つの次の仮説を選択する。

    • 主要な仮説を直接テストする最小のコマンドまたは編集を選択する。
    • 失敗ゲートを追加する:どの結果が成功を意味するか、どの結果が停止を意味するか、どのフォールバックが許可されるかを定義する。
    • ゲートが失敗した場合に関連のないフォールバックディスカバリーに陥ることを避ける。
  4. 最初にユーザータスクを完了する。

    • 実際のターゲットを修正、変換、インストール、テスト、または設定する。
    • 自信ではなく、観察された証拠で検証する。
    • バックアップは一時的に保持し、ユーザーが不要であることを確認した後に削除する。
  5. レッスンをキャプチャする。

    • 検証済みで、再利用可能で、明白でないレッスンのみを記録する。
    • 正確なコマンド、パス、バージョン、失敗テキスト、より良い操作手順を含める。
    • シークレット、プライベートデータ、長いログ、検証されていない推測を除外する。
    • 大きなナラティブよりも1つの小さなメモリ更新を優先する。
  6. 適切な保存先に保存する。

    • 永続的な編集を行う前に書き込み許可ゲートを通過する。
    • クロスプロジェクトのマシンまたは設定ファクトにはユーザーレベルのメモリを使用する。
    • プロジェクト固有の慣習にはリポジトリ/プロジェクトドキュメントを使用する。
    • レッスンが再利用可能な手順を変更する場合にのみ、既存のスキルを更新する。
    • 手順が繰り返し発生し、移植可能で、自動的にトリガーする価値がある場合にのみ、新しいスキルを作成する。
    • プラットフォームに依存しない配置ガイダンスについては、references/memory-surfaces.mdを参照。
  7. オプションで独立したレビュアーに依頼する。

    • 利用可能な任意のセカンダリエージェント、モデル、レビュアープロンプト、または新しいセッションを使用する。特定のベンダーやモデルを要求しない。
    • アーティファクトパス、失敗ループの要約、具体的な検証質問のみを提供する。
    • 最小の安全性または明確性の改善を依頼する。
    • サブエージェントが存在しない場合、自分で同じチェックリストを実行する。
    • references/reviewer-prompt.mdを参照。

自動アクティベーション

このスキルは通常、その説明を通じて呼び出されますが、これはエージェントがループの途中にあるときに最も弱くなります。ハーネスがフックやツールイベントコールバックをサポートしている場合、このスキルを呼び出すリマインダーを注入する繰り返し失敗検出器を配線します。実行可能な検出器スクリプトはhooks/(Claude CodeおよびCodexバリアント)にあり、tests/に自動テストスイートがあります。登録、信頼要件、および他のハーネスのための一般的なパターンについては、references/hook-activation.mdを参照してください。作成するフック設定はすべて、このスキル自身のルールの対象となるアーティファクトとして扱います:テストスイートを実行し、次に実際の1つの失敗を強制してそれが動作することを証明してから、信頼します。

例

トリガーと実行の動作のアンカーとして例を使用します。

  • examples/pdf-rendering-loop.md
  • examples/github-actions-loop.md
  • examples/docx-conversion-loop.md
  • examples/zotero-linked-attachment-loop.md
  • examples/dependency-install-loop.md
  • examples/filled-lesson-libreoffice.md(完了したレッスン、パターンではない)
  • examples/bad-lessons.md(アンチパターン:メモリを汚染するキャプチャ)

レッスンテンプレート

# レッスン: <短い名前>

## トリガー
- 将来のエージェントがこれを思い出すべきパターンは何ですか?

## 検証済みの事実
- 正確なパス、バージョン、コマンド、ファイル、またはアカウント状態。

## 避けるべき失敗した試行
- 試行された試行と、それらが間違っていたか無駄だった理由。

## 推奨手順
1. 最初のコマンド/チェック。
2. 検証ゲート。
3. ゲートが失敗した場合のみフォールバック。

## 検証証拠
- 推奨手順が機能することを証明した正確なコマンドと観察された出力。

## ドリフトリスク
- このレッスンを無効にする可能性があるもの:バージョン、パス、API形状、アカウント状態、OS、権限。

## 最終検証日
- YYYY-MM-DD

## 範囲
- 適用対象:<マシン/プロジェクト/ツール/コンテキスト>
- 適用外:<既知の境界>

最終応答

ユーザーに伝えます:

  • どのループが検出されたか。
  • どのタスク結果が達成されたか。
  • どのレッスンがキャプチャされ、どこに書き込まれたか。
  • どのような制限が残っているか、特に将来のエージェントがメモリを明示的にロードするかスキルを呼び出す必要がある場合。

関連スキル