feedback-learning について
feedback-learningは、実装や設計へのユーザーの修正意見を扱うエージェントスキルです。フィードバックをテスト、仕様、指示、学習メモのどこに反映するかを判断し、一度限りの希望を恒久化しないよう支援します。
主な機能
- 01反映先に応じたフィードバック分類
- 02編集前の既存ガイダンス検索
- 03過度な一般化を避けた教訓の整理
- 04学習インボックスの整理と見直し
活用シーン
- 01安定したサブシステムの不変条件を記録
- 02具体的な再発をテストに反映
- 03希望を永続化するか判断
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/feedback-learningを入力して読み込まれたか確認します。
詳細
フィードバックからの学習
ユーザーが実装や設計のアプローチを明示的に修正した場合、あるパターンを却下した場合、またはフィードバックから学ぶようエージェントに求めた場合に、このスキルを使用します。ただし、ユーザーが文字列どおりの learn! トリガーを使用した場合を除きます。
文字列どおりの learn! リクエストは、.github/instructions/learnings.instructions.md のみに従うものとし、このスキルの対象外です。その指示に置き換えたり、別の解釈を加えたりしないでください。
目標
再利用可能な知識を、信頼できる最小限の成果物に保存します。修正内容が自動的に恒久的なルールになるわけではありません。
ワークフロー
-
修正内容を特定する
- 何が誤っていましたか？
- なぜ誤っていましたか？
- ユーザーはどのようなアプローチを望んでいましたか？
- どのパスやサブシステムに影響しますか？
-
書き込む前に検索する
- 該当する指示、スキル、設計ドキュメント、テスト、対象範囲を限定した学習ファイルを確認します。
- 重複したルールを追加するのではなく、既存のルールを更新します。
-
フィードバックを分類する
フィードバックの種類 保存先 タスク固有の好み、または一度限りの調整 保存しない 再発を防ぐべき具体的な動作 回帰テスト サブシステム全体に適用される安定したアーキテクチャ、または製品の不変条件 該当する設計／仕様ドキュメント リポジトリ全体に適用されるルール 該当する指示ファイル 再利用可能だが、まだ十分に確立・実証されていない指針 .github/learnings/<area>.mdツール主導のワークフロー 該当するスキル -
慎重に一般化する
- 経緯ではなく、原則を残します。
- 長期的な契約を定義する場合を除き、一時的なシンボル名、行番号、実装の詳細は含めません。
- 根拠がさらにない限り、単一の却下された実装を普遍的な禁止事項にしないでください。
-
一度だけ記録する
- 設計ドキュメントとテストを信頼できる情報源とします。
- 学習用インボックスの項目は一時的なものです。正式な文書に反映するときは、同じ変更でインボックスの項目を削除します。
- 同じルールをスキル、指示、設計ドキュメントに重複して記載しないでください。
- インボックスに項目を追加する前に、以下のメンテナンスルールに従って対象ファイルを整理します。
-
検証する
- 保存先が対象のパスに適用されることを確認します。
- リンクを確認し、古くなった指針や矛盾する指針を削除します。
学習用インボックスの形式
.github/learnings/<area>.md を作成または更新し、次の形式を使用します。
# Area learning inbox
Last reviewed: YYYY-MM-DD
## Short topic
- **Scope:** `affected/path/**`
- **Learning:** Generalized guidance in one or two sentences.
- **Evidence:** Why this is reusable beyond the current task.
- **Disposition:** Candidate for `<design document, instruction, skill, or test>`.
項目は簡潔に記述してください。分野ごとのインボックスは、トピック数が 10 件以内、サイズが 8 KB 以内である必要があります。新しい項目を追加するといずれかの上限を超える場合は、新しいフィードバックを保存する価値があるか判断する前に、既存の項目を正式な文書に反映するか、統合するか、削除してください。
学習内容を読む
すべてのタスクに学習用インボックスを取り込まないでください。まず関連ファイルの見出しと Scope フィールドを検索し、一致する項目だけを読みます。学習用インボックスはソースコード、テスト、設計ドキュメントを補足するものです。無関係な作業の前提条件ではなく、それらに優先する信頼できる情報源でもありません。
整理と不要項目の削除
書き込みの前に、必ずインボックスを整理してください。また、インボックスがいずれかの上限に達した場合、または読み込んだ時点で Last reviewed の日付から 90 日以上経過している場合は、全体を見直してください。見直しの際は、次の対応を行います。
- 安定したアーキテクチャ上の指針を、所管する仕様書に反映します。
- 具体的な動作をテストに反映します。
- 重複する項目を統合し、より一般的な原則としてまとめます。
- 古くなった項目、矛盾する項目、すでに正式な文書に反映された項目、根拠が弱い項目を削除します。
- 保持する各項目を現在のソースと信頼できるドキュメントに照らして確認した後、
Last reviewedを更新します。
インボックスの項目はゼロ件になってもかまいません。いつか役立つかもしれないという理由だけで、学習内容を残さないでください。