Share
Embed
[Kotlin Fest 2026] FIR Checkerで始めるAI時代のガードレール設計
kitakkun
November 17, 2026
Transcript
47 slides
-
自己紹介 • kitakkun(きたっくん) • 株式会社ミラティブ「OSHIPO」事業 • DroidKaigi アプリ メインメンテナ (2025,
2026) • Kotlin Fest 2024 • もっとKotlinを好きになる!K2時代の Kotlin Compiler Plugin開発 X: @kitakkun_pb / GitHub: @kitakkun 2 / 47 -
本セッションについて 課題 AI を使った開発で困ること 基礎 FIR Checker の基礎 発展 高度な
FIR Checker 運用保守 AI を活用した Checker の運用保守 評価 導入の利点と他ツールとの比較 コード例は Kotlin 2.4.21 時点 3 / 47 -
AI の生成コードを制御する手段 • 自然言語で記述した規約ドキュメント • 守られる保証がない • チェックを指示しても、守られたかはあいまい • 機械的な解析による警告・エラー
• コンパイルが通れば、ルールが守られていると判断できる • 本セッションでは FIR Checker を使う 6 / 47 -
FIR とは • FIR = Frontend Intermediate Representation • K2
コンパイラの Frontend で扱う ソースコードを木構造で表した中間表現 • 暗黙型や参照を段階的に解決→曖昧さのないデータ Kotlin Compiler ソースコード Frontend(FIR) Backend(IR) 成果物 8 / 47 -
FIR に「曖昧さがない」とは? print(a) 関数の引数 fun greet(a: String) = print(a) トップレベル変数
val a = "top" fun greet() = print(a) 拡張レシーバーの メンバー class Cfg(val a: String) fun Cfg.greet() = print(a) 9 / 47 -
FIR では参照先が明確になる print(a) 関数の引数 fun greet(a: String) = R|kotlin/io/print|(R|<local>/a|) トップレベル変数
val a = "top" fun greet() = R|kotlin/io/print|(R|/a|) 拡張レシーバーの メンバー class Cfg(val a: String) fun Cfg.greet() = R|kotlin/io/print|(this@R|/greet|.R|/Cfg.a|) 10 / 47 -
FIR Checker とは • 解決済みの FIR を検査 →問題をコンパイルエラーとして報告する仕組み • コンパイラ標準の
Checker と同じ仕組みで 独自の Checker も動かせる Frontend Compiler (K2) ソースコード → Tokenize Tokens Parse AST Resolve FIR Check 11 / 47 -
FIR Checker を追加する拡張ポイント FirAdditionalCheckersExtension を実装して 独自の Checker を追加できる CompilerPluginRegistrar declarationCheckers
関数・クラスなどの宣言 expressionCheckers 関数呼び出しなどの式 typeCheckers 型参照 登録 FirExtensionRegistrar 登録 FirAdditional CheckersExtension 12 / 47 -
FIR Checker のインタフェース 実装するのは check 関数のみ • 入力: 検査対象の FIR
要素(宣言・式・型参照) • 検査: CheckerContext で型やシンボルを調べて判定する • 報告: DiagnosticReporter で診断情報(エラーや警告)を出す 13 / 47 -
簡単な例:特定の API の使用を禁止する runBlocking を呼んだらコンパイルエラーにする fun loadUser(): User = runBlocking
{ !Compile error! api.fetchUser() } 14 / 47 -
runBlocking の呼び出しの検出方法 • 検査対象 関数の呼び出し → FirFunctionCallChecker を使える • 判定方法
関数の ID が kotlinx.coroutines.runBlocking か比較 package kotlinx.coroutines fun <T> runBlocking( context: CoroutineContext = EmptyCoroutineContext, block: suspend CoroutineScope.() -> T ): T 15 / 47 -
runBlocking をエラーにするロジック object NoRunBlockingChecker : FirFunctionCallChecker(MppCheckerKind.Common) { } context(context: CheckerContext,
reporter: DiagnosticReporter) override fun check(expression: FirFunctionCall) { val callee = expression.toResolvedCallableSymbol() ?: return if (callee.callableId != RUN_BLOCKING) return reporter.reportOn(expression.source, MyErrors.NO_RUN_BLOCKING) } private val RUN_BLOCKING = CallableId(FqName("kotlinx.coroutines"), Name.identifier("runBlocking")) 16 / 47 -
診断情報のレンダリングフロー Checker が報告するのは診断情報のみ 表示する文言は別経路で決まる FIR Checker 診断情報を報告 報告 診断情報 文言を引く
文言 MyErrors.NO_RUN_BLOCKING 「runBlocking は禁止です」 MyErrors : KtDiagnosticsContainer BaseDiagnosticRendererFactory 17 / 47 -
診断情報を定義する object MyErrors : KtDiagnosticsContainer() { val NO_RUN_BLOCKING by error0<PsiElement>()
} override fun getRendererFactory() = MyErrorMessages 18 / 47 -
診断情報の文言を定義する object MyErrorMessages : BaseDiagnosticRendererFactory() { override val MAP by
KtDiagnosticFactoryToRendererMap("MyErrors") { map -> map.put( MyErrors.NO_RUN_BLOCKING, "runBlocking ", ) } } 19 / 47 -
Live Demo: runBlocking の使用をエラーにして AI に自動修正させる Live demo: Android Studio
· runblocking 20 / 47 -
ここまでのまとめ • FIR 参照や型が解決済みの、曖昧さのないコードの木 • Checker check で FIR を調べて、診断情報を報告する
• 診断情報 KtDiagnosticsContainer にエラーの種類を定義する • 文言 BaseDiagnosticRendererFactory で表示するメッセージを決める • 登録 FirAdditionalCheckersExtension で Checker をコンパイラに組み込む 21 / 47 -
モジュールをまたいで判定する モジュール B の宣言の中身を知らないと、 モジュール A を判定できないルールがある モジュール A コンパイル中
B の宣言の中身を 知って条件を判定したい 依存 モジュール B コンパイル済み outlined/vis bility 24 / 47 -
例:再帰的に判定したいパターン 名前が Screen で終わる Composable では、 中で使用される CompositionLocal をすべて提供する モジュール
B(依存先) @Composable fun TopBar() { val nav = LocalNavController.current } モジュール A(コンパイル中) @Composable fun HomeScreen() { TopBar() } ! 25 / 47 -
モジュールをまたいで情報を渡す 2 つの方法 A: アノテーションで書く B: 別ファイルに書く 書き込み IR で宣言に付ける
コンパイル時に出力 ビルドの配線 不要 ファイルを渡す配線が必要 成果物への影響 アノテーションクラスへの なし 参照が残る 26 / 47 -
IR でメタデータに書き、FIR で読む モジュール B で IR 拡張が TopBar を解析
アノテーションとして メタデータに書く モジュール A で FIR Checker が読んで判定 モジュール B の成果物 @InferredCompositionLocals( reads = ["LocalNavController"], ) @Composable fun TopBar() IR で生成したアノテーションが宣言部から読み取れる 27 / 47 -
IR でメタデータに書き、FIR で読む(実装) IR 拡張(モジュール B で動く) for (fn in
marked) { val mark = IrAnnotationImpl.fromSymbolOwner(type, ctor) pluginContext.metadataDeclarationRegistrar .addMetadataVisibleAnnotationsToElement(fn, listOf(mark)) } FIR Checker(モジュール A で動く) if (callee.hasAnnotation(INFERRED_COMPOSITION_LOCALS, session)) { // TopBar LocalNavController } 28 / 47 -
すべての実行経路を辿って判定する 開いたリソースがどの経路でも close() されることを保証したい fun importCsv(path: String) { val reader
= File(path).bufferedReader() ! close() } val header = reader.readLine() if (header == null) return process(reader) reader.close() 経路 close 最後まで実行 header が null 「close() があるか」だけの単純な判定では漏れが発生する 29 / 47 -
制御フローグラフ(CFG)で経路を辿る enter bufferedReader() FIR は関数の処理の流れを グラフとして持っている header == null true
false return process close enter から exit までの 経路を 1 本ずつ辿れる close を通らずに exit に着く経路 → 違反 exit 30 / 47 -
FirControlFlowChecker enter object MustCloseChecker : FirControlFlowChecker(...) { } override fun
analyze( graph: ControlFlowGraph ) { // … } if return enterNode followingNodes process exit exitNode 31 / 47 -
close 漏れを検出する方針 探す CFG 上の宣言をスキャンして AutoCloseable 型を拾う 辿る そこから followingNodes
で後続ノードへ進む 判定 close / use を通らずに exitNode に着いたら違反を報告 32 / 47 -
1. AutoCloseable 型の宣言をした CFGNode を拾う fun ControlFlowGraph.resourceDeclarations() = nodes .filterIsInstance<VariableDeclarationExitNode>()
.filter { it.fir.returnTypeRef.coneType .isSubtypeOf(AUTO_CLOSEABLE, session) } 33 / 47 -
2. followingNodes で後続ノードへ進む val reader = File(path).bufferedReader() val header =
reader.readLine() header == null return val queue = ArrayDeque(listOf(resource)) while (queue.isNotEmpty()) { val node = queue.removeFirst() if (node.closes(resource)) continue if (node == exit) return true queue += node.followingNodes } process(reader) reader.close() • node • followingNodes exit • queue 34 / 47 -
3. close / use を通らずに exitNode に着いたら違反 val reader =
File(path).bufferedReader() val queue = ArrayDeque(listOf(resource)) while (queue.isNotEmpty()) { val node = queue.removeFirst() if (node.closes(resource)) continue if (node == exit) return true queue += node.followingNodes } val header = reader.readLine() header == null return process(reader) reader.close() exit ✓ • node • followingNodes • queue 35 / 47 -
close 漏れを検出する Checker override fun analyze(graph: ControlFlowGraph) { for (resource
in graph.resourceDeclarations()) { if (leaks(resource, graph.exitNode)) reporter.reportOn(resource.fir.source, UNCLOSED_RESOURCE) } } 36 / 47 -
課題 STEP 4 · 運用保守 AI を活用した Checker の運用保守 基礎
発展 運用保守 評価 -
Compiler Plugin(FIR Checker)を 保守し続ける難しさ • コンパイラの API は Kotlin の更新で変わる
• まとまった公式ドキュメントが不足気味 • Compiler Plugin の実装自体がまだ一般的ではない 39 / 47 -
Claude 用の Compiler Plugin Skill トピック単位で階層化 Compiler 実装準拠 複数の言語バージョンに対応 FIR,
IR, Testing, ... 根拠となる情報源を記載 Kotlin のバージョン差分を記録 github.com/kitakkun/ kotlin-compiler-plugin-skills 40 / 47 -
スキルあり / なしの簡易計測 課題: AI に保守させるのに欠かせない、Checker のテストを公式のテスト基盤で書かせる モデル スキル 所要時間
ターン数 トークン 合格 Sonnet 5.5 あり 約 1.3 分 18〜23 約 5.1 万 5/5 Sonnet 5.5 なし 約 3.5 分 48〜65 約 6.6 万 5/5 Opus 5.5 あり 約 2.2 分 21〜25 約 6.1 万 3/3 Opus 5.5 なし 約 4.8 分 53〜67 約 8.4 万 3/3 中央値 / Kotlin 2.4.20 / スキル 0.3.2 / 課題とスキルは発表者側で作成 41 / 47 -
Kotlin の静的解析ツール • ktlint • detekt • Analysis API •
Compiler Plugin(特に FIR Checker) 43 / 47 -
静的解析ツールの比較 ktlint detekt 2.x Analysis API FIR Checker 構文のみ K2
/ Analysis API K2 / FIR K2 / FIR 型・参照の解決 ◦(full モード) ◦ ◦ 依存の解決 要クラスパス設定 要クラスパス設定 ビルドのまま 解析基盤 実行タイミング ビルドとは別 ビルドとは別 ビルドとは別 ビルドと同時 検査時間 約 1.6 秒 約 3〜19 秒 約 13 秒 +1〜2 秒 API の安定性 安定 アルファ版 安定化が進行中 破壊的変更あり 検査時間: 個人開発の JetWhale(749 ファイル・約 6.5 万行)での中央値。FIR Checker はクリーンビルドへの上乗せ。M2 Pro / JDK 21 / hyperfine 7 回 44 / 47 -
FIR Checker を導入する利点 • 規約違反 ビルドで止まるので、レビューでの指摘が不要 • 同じ指摘 エラーメッセージを読んで、AI が自分で直すので不要
• 指示も設定も不要 ビルドの一部として動き、上乗せ 1〜2 秒 程度 • 正確さ 解決済みの型や参照で、依存ライブラリまで正確に追える → 作業完了時に規約が守られている 45 / 47 -
まとめ 本日お話ししたこと • AI が書くコードのレビューの課題と、機械的な解析による制御 • FIR とは何か、FIR Checker の作り方
• モジュールをまたぐ判定、実行経路を辿る判定 • スキルを使った Checker の保守と、その効果 • ほかの静的解析ツールとの比較と、導入の利点 46 / 47