mcpField
R
reflection

reflection

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

reflection について

セッションを振り返り、リポジトリの CLAUDE.md の改善を提案または実施する Claude Code スキルです。分析範囲の異なるクイックモードとディープモードを備えています。

主な機能

  1. 01クイックとディープの分析モード
  2. 02会話履歴と CLAUDE.md の確認
  3. 03変更案の提示とフィードバック
  4. 04承認後の指示更新
  5. 05セッションで得た知見の要約

活用シーン

  1. 01コーディング後の CLAUDE.md 改善
  2. 02ユーザーの好みやコードパターンの記録
  3. 03指示の不足や誤解の特定

インストール

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

$npx skills add https://github.com/feiskyer/claude-code-settings --skill reflection

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

詳細

リフレクション

現在のセッションを分析し、Claude Code の指示を改善します。ユーザーの入力に応じて、2 つのモードで動作します。

モードの選択

  • クイックモード（デフォルト）：/reflection または /reflection quick で起動します。チャット履歴を分析し、CLAUDE.md の指示の改善点を特定して実装することに重点を置きます。
  • ディープモード：/reflection deep または /reflection comprehensive で起動します。解決した問題、確立したパターン、ユーザーの好み、システムへの理解、知識の不足を含む、セッション全体の分析を実行し、それに応じて CLAUDE.md を更新します。

ユーザーの入力からモードを判断してください。モードが指定されていない場合は、クイックモードを使用します。ユーザーが「deep」、「comprehensive」、または「harder」と言った場合は、ディープモードを使用します。

クイックモード：CLAUDE.md の改善

1. 分析フェーズ

コンテキストウィンドウ内のチャット履歴を確認し、次にリポジトリのルートにある現在の CLAUDE.md ファイルを読みます。

両方を分析し、改善すべき点を特定します。

  • Claude の回答に一貫性がない点
  • ユーザーの依頼を誤解した点
  • Claude がより詳細で正確な情報を提供できる領域
  • 特定の質問やタスクへの対応を改善できる機会
  • セッション中に起きた誤りを防げたはずの、欠けている指示
2. 分析内容の記録

TodoWrite を使って、特定した改善点を記録し、変更に向けた構造的な手順を作成します。

3. 対話フェーズ

調査結果と改善案をユーザーに提示します。提案ごとに、次の内容を説明します。

  1. 特定した現在の問題
  2. 指示に対する具体的な変更または追加案
  3. その変更によって Claude のパフォーマンスがどのように向上するか

各提案について、先に進む前にフィードバックを待ちます。ユーザーが変更を承認した場合は、実装に進みます。承認しない場合は、提案を練り直すか、次の提案に進みます。

4. 実装フェーズ

承認された変更ごとに、次の手順を実行します。

  1. Edit ツールを使って CLAUDE.md ファイルを変更します。
  2. 変更するセクションを明示します。
  3. 新規または変更後のテキストを提示します。
  4. この変更が、特定した問題にどう対処するかを説明します。
5. 出力形式

最終的な出力を、次の形式で提示します。

<analysis>
[Issues identified and potential improvements]
</analysis>

<improvements>
[For each approved improvement:
1. Section being modified
2. New or modified instruction text
3. Explanation of how this addresses the identified issue]
</improvements>

<final_instructions>
[Complete updated set of instructions incorporating all approved changes]
</final_instructions>

実装が成功したら、git を使って変更をコミットします。

ディープモード：セッション全体の分析

1. セッション分析フェーズ

会話履歴全体を確認し、次の項目を特定します。

問題と解決策
  • どのような問題が発生しましたか？
  • ユーザーが最初に報告した症状
  • 判明した根本原因
  • 実装した解決策
  • 得られた重要な知見
コードパターンとアーキテクチャ
  • 下した設計上の判断
  • アーキテクチャの選択
  • 発見したコード間の関係
  • 特定した統合ポイント
ユーザーの好みとワークフロー
  • コミュニケーションのスタイル
  • 意思決定の傾向
  • 品質基準
  • ワークフローの好み
  • 好みが表れている直接の引用
システムへの理解
  • コンポーネント間の連携
  • 重要な処理経路と依存関係
  • 障害の発生パターンと復旧方法
  • パフォーマンスに関する考慮事項
知識の不足と改善点
  • 発生した誤解
  • 不足していた情報
  • 判明したより良いアプローチ
  • 今後の検討事項
2. リフレクションの出力フェーズ

次の項目を含む、構造化された要約を提示します。

  • セッションの概要：達成した内容の概要
  • 解決した問題：各問題の根本原因と解決策
  • 確立したパターン：記憶しておく価値のある設計・コードパターン
  • ユーザーの好み：確認できたワークフローとコミュニケーションの好み
  • システム間の関係：把握したコンポーネント間の連携と依存関係
  • 知識の更新：コードベースや対象分野について新たに得た理解
  • コマンドとツール：特に有用だった、または問題があったツールやコマンド
  • 今後の改善点：次のステップや最適化の提案
  • 協働に関する洞察：AI と人間のやり取りでうまくいったこと、改善できること
3. アクション項目

分析を提示した後、具体的なアクションを提案します。

  1. 学んだ内容を反映した特定のセクションを追加して、CLAUDE.md を更新する
  2. 理解が深まった特定のファイルにコメントを追加する
  3. 必要に応じて、特定のトピックに関するドキュメントを作成する
  4. 検証が必要な項目をテストする

TodoWrite を使用して、これらのアクション項目を追跡します。変更を実装する前に、ユーザーの承認を待ちます。

4. 実装

承認された各アクションについて、変更を実装し、git を使用してコミットします。

ベストプラクティス

  • 変更を提案する前に、必ず現在の CLAUDE.md ファイルを読みます
  • TodoWrite を使用して、分析の進捗と実装タスクを追跡します
  • エッジケースや一般的なシナリオを考慮して、提案した変更をテストします
  • すべての変更が既存のパターンとの一貫性を保つようにします
  • 分析を徹底し、説明を明確にし、実装を正確に行います
  • 実装が成功した後、git を使用して変更をコミットします

タスク

現在のセッションを振り返ります。ユーザーの入力からモードを判断します。モードが指定されていない場合は、Quick モードをデフォルトとして使用します。

コメント

Markdown 対応