最近、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と一緒に言語化してみてください。

そして自分専用のレビュー資料作成スキルを構築すれば、コードレビューが苦痛ではなく、むしろ楽しい時間に変わるはずです。