review

review skillの概要

reviewが行うこと

review は、Claude Codeの自動メモリを監査するための self-improving-agent skill です。エージェントが MEMORY.md を点検し、昇格候補を見つけ、古くなった項目や重複した項目を特定し、プロジェクトメモリが無秩序に増え続けないようにメンテナンス提案を出せるようにします。review skill は、エージェントが何を学習したのか、何を永続的なプロジェクト指針にすべきか、何を削除すべきかを把握したいときに使います。

このreview skillが向いているケース

この skill は、Claude Code memory を Context Engineering ワークフローの一部として使っているチームに特に有用です。繰り返し得られた知見、ツールの好み、アーキテクチャ上の判断、再発しがちなミスなどが自動的に記録される一方で、定期的な編集レビューが必要なプロジェクトに向いています。逆に、Claude Code memory を使っていないプロジェクト、.claude のプロジェクトメモリディレクトリがないプロジェクト、あるいは単に1つのソースファイルを一度だけ要約したいだけの場合には、あまり適していません。

汎用プロンプトとの違い

一般的な「メモリを要約して」というプロンプトでは、運用上の確認が抜け落ちがちです。review skill は、エージェントに具体的な監査手順を与えます。プロジェクト固有のメモリディレクトリを見つけ、MEMORY.md を読み、起動時の200行制限に対する行数の逼迫を確認し、反復している内容を検出し、古いファイル参照を検証し、昇格候補と価値の低い項目を分けます。この構造があることで、長期運用するエージェントコンテキストの保守に使いやすい、実行可能な出力になりやすくなります。

review skillの使い方

reviewのインストールと最初に確認するファイル

GitHubリポジトリから skill をインストールします。

npx skills add alirezarezvani/claude-skills --skill review

インストール後は、まず SKILL.md を読んでください。このリポジトリパスでは、ワークフロー全体が1つのファイルにまとまっており、追加で確認すべき rules/、resources/、references/、スクリプトはありません。特に重要なセクションは、Usage、What It Does、Step 1: Locate memory directory、Step 2: Read and analyze MEMORY.md です。

reviewの基本的な利用コマンド

上流の skill は、/si:review 形式の呼び出しを前提に設計されています。

• /si:review でメモリ全体を監査
• /si:review --quick で件数と主要な候補を確認
• /si:review --stale で古くなった項目に絞って確認
• /si:review --candidates で昇格の可能性が高い項目だけを表示

実際には、監査したいプロジェクトのルートから review skill を呼び出します。この skill は Claude Code のプロジェクトメモリにアクセスできることを前提としており、通常は現在の作業ディレクトリから導かれる ~/.claude/projects/.../memory 配下のパスを参照します。

reviewの出力を良くする入力

弱いプロンプトの例は、「Review memory.」です。

より良いプロンプトは次のようになります。

「このリポジトリで review skill を実行してください。プロジェクトの自動メモリを確認し、MEMORY.md の行数を起動時の制限と照らし合わせ、永続的な指示に昇格すべき反復的な知見を特定し、削除済みファイルや古いツールを参照している古い項目にフラグを付け、推奨事項を promote、consolidate、prune、keep に分けて整理してください。」

この方がうまくいくのは、監査基準と判断カテゴリが明示されているからです。最近のプロジェクト変更を把握している場合は、それも含めてください。たとえば、リネームされたディレクトリ、削除されたツール、新しいコーディング標準、ポリシー変更などです。こうした情報があると、エージェントはメモリ項目が古いのか、まだ価値があるのかを判断しやすくなります。

おすすめのreviewワークフロー

メモリファイルが大きい場合や、まずはトリアージだけしたい場合は、/si:review --quick から始めます。コンテキストを更新する準備、新しいエージェント設定のオンボーディング、大きな機能開発サイクル前に蓄積したメモリを整理する場合は、フルの review を実行します。大規模なリファクタリング、依存関係の変更、ファイル移動の後には --stale を使います。目的が Context Engineering、つまり反復された学びを CLAUDE.md、プロジェクトドキュメント、チームルールへ昇格させることなら、--candidates が有効です。

review skill FAQ

reviewはClaude Code memory専用ですか？

はい。この skill は、Claude Code の自動メモリ規約、特に ~/.claude/projects/.../memory 配下のプロジェクトメモリと MEMORY.md を前提に設計されています。他のメモリファイルにも review のガイドを応用することはできますが、想定された Claude Code memory のレイアウトに沿ってエージェントが作業できるときに最も価値を発揮します。

メモリディレクトリが存在しない場合はどうなりますか？

この skill は、自動メモリが無効または利用できない可能性があることを報告し、/memory の使用など、メモリ設定の確認を提案するはずです。これはインストール前に確認しておく価値があります。チームで Claude Code memory を有効化していない、またはまだ十分に蓄積されていない場合、review が分析できる対象はほとんどありません。

reviewを使うべきでない場合は？

review をコードレビュー、セキュリティレビュー、ドキュメントQAの代替として使わないでください。監査するのはエージェントメモリの品質であり、ソースコードの正しさではありません。また、反復的なパターンがまだない新規プロジェクト、永続的なエージェントメモリを意図的に避けているチーム、単一ドキュメントの簡単な要約だけが必要なケースにも向いていません。

Context Engineeringにおけるreviewはどう役立ちますか？

Context Engineering において、review は生のメモリをメンテナンスキューに変えます。どの反復的な観察を安定したコンテキストにすべきか、どの項目が重複しているか、どの古いメモを将来のエージェントを誤誘導する前に削除すべきかを判断しやすくします。出力は、エージェントの運用コンテキストに対する編集レビューとして扱うときに最も価値があります。

review skillを改善する方法

reviewにはコマンドだけでなく根拠も渡す

review skill は、エージェントが実際のメモリファイルと現在のリポジトリを確認できると、よりよく機能します。メモリ本文だけに頼るのではなく、参照されているパスをファイルシステム上で検証できるようにしてください。古い指針があると思う場合は、その理由も伝えます。たとえば、「we migrated from Jest to Vitest」、「the api/legacy folder was removed」、「the deployment process changed last week」のように具体的に書きます。

判断に使えるカテゴリで依頼する

実際のアクションにつながるカテゴリを指定してください。良い分類例は次のとおりです。

• Promote to durable project instruction
• Consolidate with similar entries
• Prune because stale or low-value
• Keep as temporary memory
• Investigate because evidence is unclear

こうしておくと、review の出力が曖昧な要約になるのを防ぎ、監査後に CLAUDE.md、チームドキュメント、メモリファイルを更新しやすくなります。

注意したい典型的な失敗パターン

最もよくある失敗は、一度きりの観察を過剰に昇格してしまうことです。メモリ項目は通常、繰り返し発生している、ポリシーに近い、将来のセッション全体で広く役立つ、といった条件を満たす場合にだけ昇格すべきです。もう1つの失敗は、古いという理由だけで項目を削除することです。古さそのものは、内容が陳腐化している証拠ではありません。より確かな陳腐化のサインには、存在しないファイル、置き換えられたツール、現在の慣習と矛盾する内容、完了済みの一時作業への参照などがあります。

最初のreview後に反復する

最初の review が終わったら、推奨事項を最小限のパッチ計画に変換するようエージェントに依頼します。何を追加し、統合し、削除し、再確認するのかを明確にします。その後、quick mode でもう一度 review を実行し、メモリが短くなり、重複が減り、現在のプロジェクトの動きにより合っていることを確認します。これにより、review は一度きりのレポートではなく、継続的なメンテナンスループになります。