最近、agentic AI（ClaudeやCursorなど）を使ってコードをほとんど自分で書かなくなってきました。
コードの全行レビュー・修正はしっかり行っているものの、自分のレビューでさえ理解負債が溜まっていることに気づきました。これまでは「レビュー用の資料作って」「ここわからないからシーケンス図書いて」と個別に指示を出していましたが、今日はOpusが作ってくれた資料が全く頭に入らず、レビューを開始できない事態に陥りました（オワタ…年か？）。
レビューを諦めてCursor + Grok 4.5に悩みを相談したところ、重要な気づきがありました。私は文字だけの説明ではソースコードの動きが頭に入らず、UMLやシーケンス図などの視覚化がないと理解できないタイプだったのです。
この気づきを基に「自分の理解パターンに最適化したレビュー資料作成スキル」をAIに作らせたところ、資料の質が劇的に向上し、レビューがスムーズに進むようになりました。
----'-*-----'-*-----'-*-----'-*-----'-*-----'-*-----'-*-----'-*-
本当のポイント：個人ごとに理解の仕方は違う
今回作ったスキルは 「私が」理解しやすいパターン に最適化されたものです。
別の人には別の理解の仕方があります。同じ資料を渡しても、決して同じように理解されるとは限りません。
幸い、現在のAIは非常に賢いため、 個人別にカスタマイズした資料を作る労力は大きくありません。
ただし、多くの人が「自分の脳はこうすれば理解しやすくできている」と自覚・言語化できていないのが課題です。自覚がなければ、カスタマイズされた資料は作れません。
提案：2ステップで「個人最適化レビュー資料作成スキル」を構築する
ステップ1：初期の問いかけで理解スタイルを診断させる
AIに以下の質問を投げて、自分の認知特性を明確にします。
- 過去に理解しやすかった資料・説明の特徴は何か（図、テキスト、コード、表など）
- 複雑なロジックを説明されるとき、どのような表現だと頭に入りやすいか
- 逆に、どのような説明だと理解が止まるか
- 視覚化（UML/シーケンス図/フローチャート）の必要性
- 好みの情報処理順序（全体像→詳細 or 詳細→全体）
ステップ2：診断結果をもとに専用スキルを作成する
診断結果を基に、AIに以下のような専用指示（カスタムスキル）を作らせます。
具体的なスキル例（私の場合）：「あなたは私の専属コードレビュー家庭教師です。私は『文字だけの説明では動きがイメージしにくい視覚優位型』です。
レビュー資料を作成するとき、以下のルールを厳守してください：必ず最初に全体のシーケンス図（MermaidまたはPlantUML）を出力
各処理の説明は図と対応づけて記述
テキストは最小限にし、重要な流れは太字や箇点で視覚的に強調
複雑な部分は複数パターンの図（通常フロー・例外フロー）を用意
最後に『理解度確認のための3つの質問』を付ける
私の理解が浅い部分は、別の角度からの視覚化を提案する」
このスキルを一度作っておけば、以後すべてのPRやコードに対して「このスキルを使ってレビュー資料を作成して」と指示するだけで、 自分専用に最適化 された資料が自動生成されます。
家庭教師の比喩
このアプローチは「家庭教師をつける」ことと本質的に同じです。
- 普通の授業 → 標準化された資料（全員同じ）
- 家庭教師 → その子の頭の入り方に合わせて資料・説明・ペースを全部カスタマイズ
AI時代は、 各人に専属の「理解最適化家庭教師AI」 を持てる時代です。
初期診断 → カスタムスキル構築 の2ステップで実現できます。
----'-*-----'-*-----'-*-----'-*-----'-*-----'-*-----'-*-----'-*-
おわりに
理解負債（Comprehension Debt）はAI生成コードの隠れたコストとして、2026年現在も注目されています。
速度を重視するあまり理解が追いつかなくなると、後で大きな痛手になります。
皆さんもぜひ一度、自分の「理解しやすいパターン」をAIと一緒に言語化してみてください。
そして自分専用のレビュー資料作成スキルを構築すれば、コードレビューが苦痛ではなく、むしろ楽しい時間に変わるはずです。