【ユニコ🦄】ClaudeCodeセミナー実況の匿名裏掲示板 in #ユニコスクール

ベテランの暗黙知を組織の資産に変える「レビューエージェント」は、Claude Codeで十分実現可能です。

それぞれのご質問にお答えします。

① AIに与えると有効な情報

• 過去のレビュー指摘のログ（「なぜそう指摘したか」の理由付きが特に効く）
• 設計標準・コーディング規約・障害事例（原因と対策がセットになったもの）
• レビュー観点チェックリスト＋それぞれの「判断の根拠」

　→ 単なる「NG例の羅列」より、「なぜそれがダメなのか」という判断理由ごと蓄積するのが、ベテラン知識を再現するうえで最も重要なポイントです。

② 蓄積・更新の仕組み

• `.claude` フォルダ内のルールファイル（CLAUDE.md）にレビュー観点を書いておき、新しい指摘が出るたびに Skills として追記していく 運用がおすすめです
• 「この指摘は今後も再発防止ルールに追加して」とClaude Codeに伝えるだけで、自動的にナレッジが育っていきます
• 障害事例は発生のたびに「事例→原因→今後見るべき観点」の形式で追記するサイクルが効果的です

③ AIに任せやすい領域 vs 人が判断すべき領域

• AIに任せやすい＝規約違反の検出・命名規則・コメント不足・既知のアンチパターン・セキュリティの定形チェック
• 人が判断すべき＝「このビジネス要件だとこの設計でいいのか」「チームの今後の方向性と合うか」といった、文脈や意図が絡む判断

　つまり「何が正しいかが明文化できるもの」はAI、「正しさの基準自体が状況依存のもの」は人間、という切り分けが基本です。

④ 誤指摘・見逃しの評価と改善

• AIの指摘に対してレビュアーが「正しい／誤り／見逃し」を簡単にフィードバックできる仕組みを作り、フィードバックをそのままルールに反映するループを設計するのがポイントです
• 「この指摘は誤りだった。理由はこうだから再発防止ルールに追加して」とClaude Codeに投げるだけで、ナレッジが自己改善していきます

⑤ Subagent・Skillsでの継続運用は現実的か

• 十分現実的です。Claude CodeのSkillsにレビュー観点を登録しておき、コードを渡すだけでワンクリックでレビューが走る構成は、今日から作れます
• さらに進めると、「事前チェックエージェント→深堀りエージェント→最終判断まとめエージェント」のような Subagent構成（役割を分けた複数のエージェントが連携する仕組み）にすることで、より高精度なレビューが実現できます

まず小さく始めるなら、過去の重要レビュー指摘10〜20件を理由付きでCLAUDE.mdに書き込み、ワンクリックでレビューが走るSkillsを作るところからスタートするのが最も現実的です。ベテランの知恵が組織の資産になる瞬間、ぜひ体感してみてください。