mcpField
R
reflect

reflect

github.com/haddock-developmentエージェントワークフロー38482 回インストール41 週間前に更新
リポジトリ

reflect について

reflect は、会話中の訂正や繰り返しのパターンを分析し、関連するスキルの更新案を作成する Claude Code 向けスキルです。手動分析に加え、確認機能と安全対策を備えたセッション終了時の自動実行にも対応します。

主な機能

  1. 01会話シグナルの検出
  2. 02指定または全スキルの分析
  3. 03セッション終了時の自動反映
  4. 04更新案の対話型レビュー
  5. 05バックアップと YAML 検証

活用シーン

  1. 01訂正を再利用可能なスキルの指針にする
  2. 02Claude Code のセッション内で反復するパターンを確認する

インストール

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

$npx skills add https://github.com/haddock-development/claude-reflect-system --skill reflect

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

同梱ファイル

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

README.md
USER_GUIDE.md
.state/
auto-reflection.json
last-reflection.timestamp
commands/
reflect-meta.md
reflect-promote.md
reflect-stats.md
references/
signal-patterns.md
scripts/
extract_signals.py
hook-stop.sh
learning_ledger.py
meta_learning.py
present_review.py
promote_learning.py
reflect.py
scope_analyzer.py
semantic_detector.py
toggle-off.sh
toggle-on.sh
toggle-status.sh
update_skill.py

詳細

Reflect - 自己改善型スキル

概要

このスキルは、会話から修正、承認、パターンを分析し、関連するスキルの更新を提案することで、Claude Code が会話から学習できるようにします。「一度修正すれば、二度と間違えない」学習システムを実現します。

使用モード

1. 手動リフレクション（/reflect）

現在の会話の分析を開始します。

/reflect [skill-name]
  • スキル名を指定しない場合：会話で使用したすべてのスキルを分析します
  • スキル名を指定した場合：特定のスキルに焦点を当てます
2. 自動リフレクション

/reflect-on で有効にすると、セッション終了時に Stop フック経由で自動実行されます。

3. 切り替えコマンド
  • /reflect-on - 自動リフレクションを有効にします
  • /reflect-off - 自動リフレクションを無効にします
  • /reflect-status - 現在の設定を表示します

信頼度レベル

高 - 明示的な修正：

  • ユーザーが具体的な代替案を示して Claude のアプローチに異議を唱える
  • パターン：「X はせず、代わりに Y をしてください」
  • アクション：非推奨の警告を付けて直接更新します

中 - 承認とパターン：

  • ユーザーが特定のアプローチを承認する
  • パターンが複数回成功する
  • アクション：「ベストプラクティス」セクションに追加します

低 - 観察：

  • ユーザーが代替案を質問または提案する
  • パターン：「……を検討しましたか？」または「……を試してみてはどうですか？」
  • アクション：「検討事項」セクションに追加します

ワークフロー

  1. シグナル検出 - 会話記録をスキャンして、修正やパターンを検出します
  2. コンテキスト分析 - シグナルの前後にある5件のメッセージからコンテキストを抽出します
  3. スキルのマッピング - シグナルを関連するスキルに対応付けます
  4. 変更案の作成 - 提案する更新の差分を生成します
  5. ユーザーレビュー - 自然言語での編集に対応した対話形式の承認を行います
  6. 適用 - バックアップを作成し、安全に YAML／Markdown を更新します
  7. Git コミット - 説明的なメッセージを付けて自動コミットします

スクリプト

コアエンジン
  • scripts/reflect.py - 主なオーケストレーションロジック
  • scripts/extract_signals.py - パターン検出エンジン
  • scripts/update_skill.py - スキルファイルを安全に更新します
  • scripts/present_review.py - 対話形式のレビュインターフェース
自動化
  • scripts/hook-stop.sh - Stop フックとの連携
  • scripts/toggle-on.sh - 自動リフレクションを有効にします
  • scripts/toggle-off.sh - 自動リフレクションを無効にします
  • scripts/toggle-status.sh - ステータスを表示します

安全機能

  • すべての編集前にタイムスタンプ付きのバックアップを作成
  • 書き込み前に YAML を検証
  • ロックファイルで同時実行を防止
  • ロールバックに対応した適切なエラー処理
  • コミット前に Git のステータスを確認

参考資料

詳しいパターンライブラリについては、references/signal-patterns.md を参照してください。

コメント

Markdown 対応