reflect について
reflect は、セッションを振り返り、修正や成功例、例外、繰り返し現れる好みに基づいてスキルの改善案を出す Claude スキルです。スキルの管理者向けで、編集には明示的な承認が必要です。
主な機能
- 01セッションのシグナル分析
- 02スキル更新案の提示
- 03手動・自動の振り返り制御
- 04編集前の承認確認
活用シーン
- 01セッション後のスキル振り返り
- 02繰り返される修正や好みの特定
- 03承認された所見のスキル更新への反映
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/reflectを入力して読み込まれたか確認します。
詳細
Reflect Skill
現在のセッションを分析し、うまくいったこと、うまくいかなかったこと、発見されたエッジケースに基づいて、スキルの改善案を提示します。
トリガー
スキルを使用したセッションの後に、/reflect または /reflect [skill-name] を実行します。
追加コマンド：
/reflect on- セッション終了時の自動リフレクションを有効にします/reflect off- セッション終了時の自動リフレクションを無効にします/reflect status- 自動リフレクションが有効かどうかを確認します
ワークフロー
Step 1: スキルを特定する
スキル名が指定されていない場合は、次のように尋ねます。
Which skill should I analyze this session for?
- frontend-design
- code-reviewer
- [other]
Step 2: 会話を分析する
現在の会話から、次のようなシグナルを探します。
修正（信頼度：高）：
- ユーザーが「違います」「そうではなくて」「つまり……」と言った
- ユーザーが出力を明示的に修正した
- 生成直後にユーザーが変更を求めた
成功（信頼度：中）：
- ユーザーが「完璧です」「すばらしいです」「はい」「そのとおりです」と言った
- ユーザーが変更を加えずに出力を受け入れた
- ユーザーが出力をもとに作業を進めた
エッジケース（信頼度：中）：
- スキルが想定していなかった質問
- 回避策が必要なシナリオ
- ユーザーが求めたものの、スキルではカバーされていなかった機能
好み（複数のセッションから蓄積）：
- ユーザーの選択に繰り返し見られるパターン
- 暗黙に示されたスタイルの好み
- ツールやフレームワークの好み
Step 3: 変更案を提示する
コントラスト比 4.5:1 の WCAG AA に準拠した色で、調査結果を提示します。
┌─ Skill Reflection: [skill-name] ───────────────────┐
│ │
│ Signals: X corrections, Y successes │
│ │
│ Proposed changes: │
│ │
│ 🔴 [HIGH] + Add constraint: "[specific constraint]"│
│ 🟡 [MED] + Add preference: "[specific preference]"│
│ 🔵 [LOW] ~ Note for review: "[observation]" │
│ │
│ Commit: "[skill]: [summary of changes]" │
│ │
└────────────────────────────────────────────────────┘
Apply these changes? [Y/n] or describe tweaks
アクセシブルなカラーパレット（ターミナル出力では ANSI コードを使用）：
- 高：
\033[1;31m（太字の赤 #FF6B6B - 暗い背景で 4.5:1） - 中：
\033[1;33m（太字の黄色 #FFE066 - 暗い背景で 4.8:1） - 低：
\033[1;36m（太字のシアン #6BC5FF - 暗い背景で 4.6:1） - リセット：
\033[0m
避ける色：黒に純粋な赤（#FF0000）、赤に緑（色覚多様性のあるユーザーに配慮）
ユーザーの応答オプション：
Y– 変更を適用し、コミットしてプッシュするn– この更新をスキップする- または、変更案への調整内容を記述する
Step 4: 承認された場合
.claude/skills/[skill-name]/SKILL.mdから現在のスキルファイルを読み込みます- Edit ツールを使って変更を適用します
- Git コマンドを実行します：
cd .claude/skills git add [skill-name]/SKILL.md git commit -m "[skill]: [change summary]" git push origin main - 次のように確認します：「スキルを更新し、GitHub にプッシュしました」
Step 5: 承認されなかった場合
「これらの所見を後で確認できるように保存しますか？」と尋ねます。
はいの場合は、.claude/skills/[skill-name]/OBSERVATIONS.md に追記します。
切り替えコマンド
/reflect on
セッション終了時の自動リフレクションを有効にします：
~/.claude/reflect-skill-state.jsonに{"enabled": true, "updatedAt": "[timestamp]"}を作成または更新します- 次のように確認します：「自動リフレクションが有効になりました。終了時にセッションを自動で分析します。」
/reflect off
自動リフレクションを無効にします：
~/.claude/reflect-skill-state.jsonを{"enabled": false, "updatedAt": "[timestamp]"}に更新します- 次のように確認します：「自動リフレクションが無効になりました。セッションを分析するには、手動で /reflect を使用してください。」
/reflect status
現在の状態を確認します：
~/.claude/reflect-skill-state.jsonを読み込みます- 最終更新日時とともに「自動リフレクションは［有効／無効］です」と報告します
注： 状態ファイルはグローバルな Claude ユーザーディレクトリ（~/.claude/）に保存されるため、プラグインをアップグレードしても保持されます。
セッション例
ユーザーが UI セッション後に /reflect frontend-design を実行します。
┌─ Skill Reflection: frontend-design ───────────────┐
│ │
│ Signals: 2 corrections, 3 successes │
│ │
│ Proposed changes: │
│ │
│ 🔴 [HIGH] + Constraints/NEVER: │
│ "Use gradients unless explicitly requested" │
│ │
│ 🔴 [HIGH] + Color & Theme: │
│ "Dark backgrounds: use #000, not #1a1a1a" │
│ │
│ 🟡 [MED] + Layout: │
│ "Prefer CSS Grid for card layouts" │
│ │
│ Commit: "frontend-design: no gradients, #000 dark"│
│ │
└───────────────────────────────────────────────────┘
Apply these changes? [Y/n] or describe tweaks
Git 統合
このスキルには、次の操作が許可されています。
.claude/skills/からスキルファイルを読み込む- ユーザーの承認を得てスキルファイルを編集する
- スキルディレクトリで
git add、git commit、git pushを実行する
スキルリポジトリは .claude/skills に初期化し、リモートの origin を設定してください。
重要な注意事項
- 適用前に、変更内容を必ず正確に提示してください
- ユーザーの明示的な承認なしにスキルを変更しないでください
- コミットメッセージは簡潔で内容が分かるものにしてください
- コミットが成功した後にのみプッシュしてください