claude-reflect (Claude Skill) — インストール & ライブデモ

なぜ使うのか

主な機能

暗黙の修正（「実はこうやって」）とポジティブなシグナルを検出
ルール追加の下書きを作成。CLAUDE.md に反映する前に承認が必要
同じルールを AGENTS.md にも反映。Claude 以外のツールでも利用可能
定期的な統合処理で矛盾した・古いルールを除去
差分ベースの更新で git 履歴が読みやすい

ライブデモ

実際の動作

準備完了

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： claude-reflect

手動のキュレーションなしに CLAUDE.md を進化させる

👤 ドキュメントファイルの管理が苦手なソロ開発者 ⏱ ~5 min beginner

使うタイミング： CLAUDE.md を自分の好みに合わせ続けたいが、それを書く手間をかけたくないとき。

フロー

普通にコーディングする

Just code with Claude as usual. Correct it when wrong, praise it when right.✓ コピーしました

→ スキルがサイレントにキャプチャしている。気づかない
1 日の終わりにレビューする

Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ コピーしました

→ プロンプトの出所付きで 5〜10 件の候補ルールが表示される
差分をコミットする

Apply approved rules and commit CLAUDE.md.✓ コピーしました

→ きれいな git 差分。ルールが有効になる

結果： 手動メンテナンスのコストなしに、自分と共に成長する CLAUDE.md が完成する。

注意点

スキルが一度限りのコンテキストを永続ルールとしてキャプチャしてしまう — 毎日の候補を必ずレビューする。状況固有のものは全て却下する

組み合わせ： filesystem

集合的な修正からチーム全体の AI 規約を構築する

👤 AI ワークフローを標準化するテックリード ⏱ ~60 min intermediate

使うタイミング： 複数の開発者が似たようなことで Claude を修正している。共有のルールセットが欲しいとき。

フロー

開発者ごとの下書きを収集する

Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ コピーしました

→ N 件の候補が保留中のブランチが作成される
セッションをマージする

Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ コピーしました

→ 共通基盤のルールセットが作成される
ロールアウトする

Merge to main. New AGENTS.md applies to everyone.✓ コピーしました

→ チームが同じベースラインを使う。個人のローカルルールはそのまま

結果： プロセス委員会なしのボトムアップな標準化が実現する。

注意点

声の大きい開発者が主導し、控えめな人のパターンが見落とされる — 全員がスキルを実行することを確認する。ファイル編集数ではなくリフレクションイベント数で重み付けする

組み合わせ： github

CLAUDE.md の古いルールを監査して削除する

👤 長期間 CLAUDE.md を使っているユーザー ⏱ ~25 min intermediate

使うタイミング： CLAUDE.md が 600 行になり、Claude のコンテキストが肥大化しているとき。

フロー

関連度をスコアリングする

Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ コピーしました

→ ルールごとのスコアが表示される
削除を提案する

Suggest 30 rules to remove (stale or obsolete).✓ コピーしました

→ 根拠付きの削除リストが表示される
差分を作成してコミットする

Apply approved removals; commit with message 'reflect: prune stale rules'.✓ コピーしました

→ スリムになった CLAUDE.md が完成する

結果： 流し読みではなく、実際に読まれる CLAUDE.md になる。

注意点

適用されなかったのは Claude がルールを尊重していたからかもしれない — 迷ったら残す。ただし「最後に確認済み」とマークして翌四半期に再確認する

組み合わせ

他のMCPと組み合わせて10倍の力を

claude-reflect-skill + pro-workflow-skill

pro-workflow で明示的なキャプチャ、claude-reflect でパッシブなキャプチャ。2 チャンネルの学習

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ コピーしました

claude-reflect-skill + github

PR 経由でルール変更をレビュー可能にする

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング
watch_session	—	常時起動のバックグラウンドプロセス
review_candidates	since?	日次・週次の承認ループ
consolidate	scope?	定期的な重複排除・矛盾解消
score_rules	—	削除前の監査
apply_to_files	approved_ids[], files[]	承認済み候補を CLAUDE.md / AGENTS.md に反映する

コストと制限

運用コスト

APIクォータ: なし — ローカル
呼び出しあたりのトークン: バックグラウンドキャプチャは無料。レビュー・統合はローカル LLM を設定した場合に発生
金額: 無料
ヒント: 候補を保守的に承認する。量より質

セキュリティ

権限、シークレット、影響範囲

最小スコープ： filesystem-write

認証情報の保管： スキルの状態は .claude/reflect/ に保存。共有したい場合はリポジトリにコミットする

データ送信先： デフォルトはなし

リフレクションログに機密性の高いコードスニペットが含まれる場合がある。生ログは gitignore に追加し、抽出済みのルールのみをコミットすること

トラブルシューティング

よくあるエラーと対処法

候補がキャプチャされない

スキルが CLAUDE.md の前文で呼び出されているか確認する。.claude/reflect/log にエントリがあるか確認する

候補がノイズだらけ

トリガーの感度を上げる。明示的な修正のみからキャプチャし、一般的なチャットには反応しないようにする

AGENTS.md が CLAUDE.md から乖離する

定期的に consolidate を実行する。ツールは同期を保つ設計だが手動編集で乖離が生じる

承認プロンプトが多すぎて対応できない

--limit 5 で毎日レビューを実行する。50 件をまとめてではなく習慣として積み重ねる

代替案

claude-reflect 他との比較

代替案	代わりに使う場面	トレードオフ
pro-workflow-skill	明示的なキャプチャと作業ツリーオーケストレーションを好む場合	より手動。並列作業には強力
Manual CLAUDE.md curation	自分でルールを書く規律がある場合	しばしば放置される。意志の力に依存する

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る