AI時代のPHP開発にASTクエリツール で コードベースの地図を作る / ast-query-tool-php-codebase-map
by
コドモン開発チーム
×
Copy
Open
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
Slide 1
Slide 1 text
PHPカンファレンス2026 リジェクトコン&アフターイベント AI時代のPHP開発にASTクエリツール で コードベースの地図を作る 株式会社コドモン プロダクト開発部 權田 直輝 2026年08月06日
Slide 2
Slide 2 text
自己紹介 權田 直輝 ごんだ なおき 経歴など 3児の父。子どもを取り巻く環境をテクノロジーの力でよりよいもの にしたいに共感し、2025年12月にコドモンへジョインしました。 日々、学童向けの機能開発を中心にプロダクト開発に関わっていま す。 2025.12 コドモンに開発エンジニアとして入社 2
Slide 3
Slide 3 text
突然ですが、AI によって コードを書くスピードは上がりましたよね? 3
Slide 4
Slide 4 text
でも 4
Slide 5
Slide 5 text
AIはちゃんと影響範囲を 把握できていそうですか? 5
Slide 6
Slide 6 text
トークンってどれくらい使っているか 意識していますか? 6
Slide 7
Slide 7 text
推論時間長くないですか? 7
Slide 8
Slide 8 text
この辺のモヤモヤを解決するために AIが使用するツールを開発しました! 8
Slide 9
Slide 9 text
PHP関係ある? 9
Slide 10
Slide 10 text
あんまりないので、 リジェクトなのです! 10
Slide 11
Slide 11 text
では、いきましょう! 11
Slide 12
Slide 12 text
AIは必要な関係を探索しながら集めている AIがコードベースを調査サイクルは grep → read → 推論 であり、情報の不足があればさらに調査サイクルを回す 12
Slide 13
Slide 13 text
AIは必要な関係を探索しながら集めている 必要な関係が揃うまで、探索を繰り返す。 無駄な繰り返しによるコスト ● トークン消費 ● 調査時間 ● 調査精度 現状の課題 安定しない そもそも往復を減らすことができれば安定する? 13
Slide 14
Slide 14 text
コードの構造を先に渡せないか? 単純な仮説 コードの関係を先に構造化して渡せば 往復を減らせる? 14
Slide 15
Slide 15 text
コードの構造を先に渡せないか? コードの関係をグラフとして構築する ● 定義 ● 継承 ● 依存 ● 呼び出し 15
Slide 16
Slide 16 text
コードの構造を先に渡せないか? AIにはグラフから必要な構造だけを渡せるようにする 構造の把握に使う探索を減らし、 影響範囲や実装方針の判断に推論を使ってもらいます。 16
Slide 17
Slide 17 text
このグラフを作成するために使用したのが AST(抽象構文木) です 17
Slide 18
Slide 18 text
AST(抽象構文木)とは? コードをクラス、メソッド、変数、呼び出しなど、 意味を持つ構文としてツリーで表現したもの ←AST (めちゃ長いので割愛) 18
Slide 19
Slide 19 text
ASTから、PHPのコード関係を構築する ASTだけではPHPのコードを表現しきれない ● namespace / use など ● PHPDoc、コンストラクタ代入など ● DIコンテナ、Factory、Facadeなど ASTを起点にPHPの意味を補い、コードの関係を再構築する必要が ある 19
Slide 20
Slide 20 text
再構築した結果をIndexに保存し、 必要な構造をQueryできるツールを作りました。 PHPのコードベースに、地図を与える。 PHP + Atlas(地図) = Phatlas 20
Slide 21
Slide 21 text
grepから構造へクエリ 従来 Phatlas grep query ▼ ▼ read read ▼ ▼ 推論 推論 Phatlasでは要素と関係をIndex化してあるため 最初のコードグラフへ問い合わせ、必要な関係を一気に取得できる 21
Slide 22
Slide 22 text
エージェント10体ずつで効果検証 grepのみ 自由 phatlas + grep phatlasのみ 数千ファイルあるモノリスからinterfaceメソッド1つを起点に 6エンドポイントx4層の26ファイルをもれなく検出できるか検証 22
Slide 23
Slide 23 text
トークンコストと推論時間が変わった 指標 grepのみ 自由 phatlas + grep phatlasのみ 総トークン 190万トークン 120万トークン 17万トークン 実トークン 36万トークン 26万トークン 9万トークン 所要時間 392秒 377秒 127秒 ターン数 29 23 5 ツール呼び出し 42 30 7 phatlasのみにしてgrepで裏どりさせなければ 高い効果が発揮できることがわかった 23
Slide 24
Slide 24 text
精度に差はでなかった 全ての条件で精度の差はでなかった。 grepでも十分に探索できれば、正解へ到達できるし 各条件10体の調査により再現性もあることが確認できました。 Opus 4.8の頃は見落としがありましたが、 Opus 5では完璧に発見しました。 24
Slide 25
Slide 25 text
結果 仮説 →コードの構造を先に渡せば、トークン、時間、精度を安定する? 結果 →トークンと時間は大幅に改善し、安定するが精度については差がなし 25
Slide 26
Slide 26 text
まとめ AIは、grepだけでも正解にたどり着ける ただし、 コードの構造を先に渡すことで、 正解までの探索を減らせる そして、 地図を作るだけでなく、 いつ探索を止めるかまで設計する 26
Slide 27
Slide 27 text
人が目的に応じて道具を使い分けるように AIにも適切な道具を使わせる AIの能力を引き出すための 道具やプロセス設計が今後はますます重要になる ご清聴ありがとうございました👏 27