self-learning-feedback について
self-learning-feedbackは、タスク完了後にフィードバックを集め、以後の出力に反映するエージェントスキルです。タスクの文脈ごとに評価を記録し、改善が必要な場合の反復手順を定めています。
主な機能
- 01タスク完了後のフィードバック依頼
- 02文脈別の連続評価記録
- 03構造化された改善質問
- 04深刻度に応じた反復上限
- 05改善指摘後の評価カウンターリセット
活用シーン
- 01個別タスクの完了後に評価を収集
- 02定期 cron job の品質シグナルを追跡
- 03改善依頼を後続の出力に反映
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ proftrader/ openclaw-self-learning-skill --skill self-learning-feedbackインストール後、Claude Code で/self-learning-feedbackを入力して読み込まれたか確認します。
同梱ファイルreference.md
詳細
自己学習型フィードバック
目的
このスキルを使用すると、ユーザーの作業を妨げずに、タスクや cron ジョブの完了後に再帰的な学習を行えます。
デフォルト値
GOOD_APPROVAL_TARGET = 10SLIGHT_MAX_ITERATIONS = 5MEDIUM_MAX_ITERATIONS = 10SEVERE_MAX_ITERATIONS = 20
ユーザーが異なるしきい値(たとえば、良好評価 20 回)を明示的に求めた場合は、GOOD_APPROVAL_TARGET のみを更新します。
起動するタイミング
明確な完了時点で起動します。
- 個別のタスクが完了した。
- cron ジョブの実行と応答が完了した。
リクエストからタスクの種類/コンテキスト(たとえば、cron ジョブ名、レポートの種類、コマンド、目標)を特定し、良好評価カウンターと問題のシグネチャーを適切な範囲に設定します。
次の場合は起動しません。
- タスクの途中。
- 自然な完了時点に達する前の、複数ステップから成るプロセスの途中。
- 同じ完了イベントに対して複数回。
邪魔にならないフィードバックの依頼
完了後、短いフィードバックを 1 回求めます。
タスクが完了しました。よかったですか、それとも改善が必要ですか?
依頼は 1~3 行に収めます。
フィードバックに応じた分岐
分岐 A:ユーザーが「よかった」と答えた場合
- 同じターン内で、次のように尋ねます。
この出力のどこがよかったですか? - ユーザーからの肯定的な評価(品質、形式、スタイル、速度、明瞭さなど)を記録します。
- このタスクの種類/コンテキスト(同じ cron ジョブ、同じレポートの種類、同じコマンドなど)の、連続する良好評価カウンターを 1 増やします。前回のタスクでユーザーが「改善が必要」と答えていた場合、そのコンテキストのカウンターはすでにリセットされています。目標に向けてカウントするのは、連続した「よかった」の回答のみです。
- カウンターが
GOOD_APPROVAL_TARGETに達するまで、同じタスクの種類が完了するたびに、この学習動作を繰り返します。 - 目標に達したら、パターンを学習済みとして扱い、フィードバックを求める頻度を減らします。
- タスクの種類が変わった場合、品質が低下した場合、または定期的な再調整が必要な場合にのみ、「どこがよかったか」を尋ねます。
- カウンターのリセット:ユーザーがこのタスクの種類/コンテキストについて「改善が必要」と答えた場合、そのコンテキストの良好評価カウンターを 0 にリセットし、次の「よかった」から新たに連続回数を数えます。
分岐 B:ユーザーが「改善が必要」と答えた場合
まず選択式の質問をし、その後、自由記述による詳細化を行う構造化された学習ループを実施します。
- 次の 3 つの観点で、改善の意図を確認します。
- 改善が必要な理由。
- どのように改善すべきか。
- 変更すべきコンテキストやスタイル。
- 可能であれば、例を尋ねます。
- 深刻度を分類し、反復の上限を設定します。
- Web 調査と反復的な推論によって問題を解決します。
- 次回の類似する出力に改善を適用します。
- 完了後、再度フィードバックを求めます。
選択式の質問テンプレート
利用可能な場合は AskQuestion を使用します。
改善が必要な理由
選択肢:
- 結果が不正確、または不完全
- 形式や構成が不適切
- 遅すぎる、または非効率
- トーンやスタイルが不適切
- コンテキストや前提が不足
- その他(ユーザーが指定)
どのように改善すべきか
選択肢:
- 詳細や深さを増やす
- 詳細を減らして簡潔にする
- 構成や順序を変える
- 方法やツールを変える
- 検証やチェックを強化する
- その他(ユーザーが指定)
どのコンテキストやスタイルを改善すべきか
選択肢:
- コードのスタイルや規約
- 出力形式(markdown、JSON、表、文章)
- 用語や専門分野の言葉遣い
- 長さや範囲の境界
- 想定読者や期待されるトーン
- その他(ユーザーが指定)
続けて次のように尋ねます。
希望する出力やスタイルの例があれば、共有してください。
重大度指標と反復回数の制御
ユーザーの「なぜ/どのように/何を」から問題を分類します(不明確な場合は簡潔に確認します)。
- 軽微:表現/書式/スタイルの微調整 → 最大5回
- 中程度:構造/深さ/方法の変更 → 最大10回
- 重大:根本的な問題または繰り返し発生する失敗 → 最大20回
問題のシグネチャ(なぜ + どのように + 何を + コンテキスト)ごとに学習ループを追跡します。1回の反復とは、学習を適用 → 改訂版を提示 → 再度「良いですか、それとも改善が必要ですか?」と尋ねる、1回のサイクルです。その後、ユーザーが「良い」と答えた場合、その改善課題は完了となります(そのタスクには「良い」という承認の流れが適用されます)。同じ問題について再び「改善が必要」と答えた場合は、次の反復として数えます。
- 上限未満の場合:反復的な改善を続けます(適用 → 再度フィードバックを尋ねます)。
- 上限に達した場合:学んだことを要約し、その問題についての反復を停止して、通常のフィードバック依頼を続けます(以降のタスクでも「良いですか、それとも改善が必要ですか?」と尋ねます)。
「なぜ・どのように・何を」の明示要件
改善を実施する際は、必ず以下を明示します。
- なぜこの変更が必要なのか。
- どのように変更するのか(具体的な手順)。
- 適用するコンテキスト/スタイル上の制約。
外部の参照情報によって正確性が向上する場合は、ウェブ検索を使用します。前提を検証し、改善するために反復的に考えます。
UX の安全ルール
- フィードバックを何度も求めないでください。
- ユーザーが進行中のワークフローを中断しないでください。
- 質問は簡潔で予測しやすいものにしてください。
- UI や製品の変更を求めないでください。これは会話上の振る舞いのレイヤーです。
簡潔な出力形式
タスクの完了後:
- 完了を伝える一文。
- フィードバックを尋ねる質問を1つ。
- ユーザーが「改善が必要」を選んだ場合に限り、任意で追加のフォローアップブロックを1つ。
追加リソース
詳細な質問セットと記入例:reference.md