mcpField
C
claude-reflect

claude-reflect

github.com/bayramannakovエージェントワークフロー1.9k423 回インストール4 週間前に更新
リポジトリ

claude-reflect について

claude-reflect は Claude Code 向けのスキルです。ユーザーの修正を記録し、指示ファイルへ反映する前に確認できます。

主な機能

  1. 01修正内容の自動記録
  2. 02人が確認する学習キュー
  3. 03過去のセッションをスキャン
  4. 04ドライランで変更を確認
  5. 05繰り返しからスキル候補を発見

活用シーン

  1. 01修正内容を次回以降のセッションに反映
  2. 02グローバルとプロジェクトの指針を分離
  3. 03セッション履歴から見落とした学びを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bayramannakov/claude-reflect --skill claude-reflect

インストール後、Claude Code で/claude-reflectを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
BACKLOG.md
LICENSE
CHANGELOG.md
RELEASING.md
CLAUDE.md
DISTRIBUTION.md
README.md
.claude-plugin/
marketplace.json
plugin.json
.github/
FUNDING.yml
.github/workflows/
test.yml
commands/
skip-reflect.md
view-queue.md
reflect-skills.md
reflect.md
hooks/
hooks.json
mod/
README.md
mod/.claude-plugin/
plugin.json
mod/hooks/
hooks.json
reflect.test.tsx
register.tsx
mod/types/
index.d.ts
scripts/
check_learnings.py
clear_queue.py
compare_detection.py
capture_learning.py
extract_session_learnings.py
extract_tool_errors.py
scripts/legacy/
capture-learning.sh

詳細

Claude Reflect - 自己学習システム

Claude Code がユーザーからの訂正を学習できるようにする、2 段階のシステムです。

仕組み

ステージ 1：記録（自動） フックが訂正パターン（「いや、X を使って」「実は……」「Y ではなく X を使って」）を検出し、~/.claude/learnings-queue.json にキューイングします。

ステージ 2：処理（手動） ユーザーが /reflect を実行して、キューに登録された学習内容を確認し、CLAUDE.md ファイルに適用します。

使用可能なコマンド

コマンド目的
/reflect人による確認を行いながら、キューに登録された学習内容を処理します
/reflect --scan-history過去のセッションをスキャンし、見逃した学習内容を探します
/reflect --dry-run適用せずに変更をプレビューします
/reflect-skills繰り返しのパターンからスキル候補を見つけます
/skip-reflectキューに登録された学習内容をすべて破棄します
/view-queue処理せずに保留中の学習内容を確認します

ユーザーにリマインドするタイミング

次の場合は、ユーザーに /reflect をリマインドしてください。

  • 機能または意味のある作業単位を完了したとき
  • 今後のセッションのために覚えておくべき訂正をしたとき
  • 「これを覚えておいて」などと明示的に伝えたとき
  • コンテキストが圧縮されようとしていて、キューに項目があるとき

訂正の検出パターン

信頼度の高い訂正：

  • ツールの拒否（ユーザーが指示を添えて操作を中止する）
  • 「いや、X を使って」／「Y は使わないで」
  • 「実は……」／「つまり……」
  • 「Y ではなく X を使って」／「Y の代わりに X」
  • 「覚えておいて：」（明示的なマーカー）

学習内容の保存先

  • ~/.claude/CLAUDE.md - グローバルな学習内容（モデル名、一般的なパターン）
  • ./CLAUDE.md - プロジェクト固有の学習内容（規約、ツール、構成）
  • ./CLAUDE.local.md - 個人用の学習内容（マシン固有、gitignore 対象）
  • ./.claude/rules/*.md - パスによる任意のスコープ指定が可能なモジュール式ルール
  • ~/.claude/rules/*.md - グローバルなモジュール式ルール
  • ~/.claude/projects/<project>/memory/*.md - 自動メモリ（信頼度が低く、探索的）
  • commands/*.md - スキル実行中の訂正に基づくスキルの改善

やり取りの例

User: no, use gpt-5.1 not gpt-5 for reasoning tasks
Claude: Got it, I'll use gpt-5.1 for reasoning tasks.

[Hook captures this correction to queue]

User: /reflect
Claude: Found 1 learning queued. "Use gpt-5.1 for reasoning tasks"
        Scope: global
        Apply to ~/.claude/CLAUDE.md? [y/n]

コメント

Markdown 対応