Doc Translate - LLMを活用したコードドキュメント自動翻訳VSCode拡張機能

「開発組織のぷち改善ハッカソン！」の発表資料です。

英語と日本語のコメントが混在する社内コードベースやOSSのドキュメントを読む際の認知負荷を軽減するため、LLMを活用した自動翻訳VSCode拡張機能「Doc Translate」を開発しました。

Transcript

1. Doc Translate LLM を活用したコードドキュメント自動翻訳VSCode 拡張機能 2025 年11 月8 日 開発組織のぷち改善ハッカソン！ pythonista
2. 自己紹介 益居、光田、武藤 株式会社ブレインパッド （OB 含む） 　最近富士通に買収されることが 発表されました # 指南書本 技術評論社（共著：武藤） 2 / 18
3. 目次 1. タイトル/ 課題 2. 洞察/ 発見 3. Demo （アーキテクチャ/ 技術選定） 4. 結果 3 / 18
4. タイトル/ 課題 4 / 18
5. Doc Translate LLM を活用したコードドキュメント自動翻訳VSCode 拡張機能 5 / 18
6. 課題認識 社内のコードベースにおける認知負荷 社内で、英語と日本語のコメントが混在していたり、英語の みだったりするため、認知負荷が高いことが問題でした。 また、OSS のドキュメントやコメントも英語で書かれているため、 同様の課題がありました。 コードを読む際に言語切り替えが発生 理解速度が低下 レビュー効率の悪化 6 / 18
7. 洞察/ 発見 7 / 18
8. 開発過程で得られた洞察 1. Overlay での表示 + カーソル時のみ原文表示 ホバーではなく、overlay で翻訳を表示し、カーソルがある 時だけ原文を表示することで読みやすさが劇的に向上しました。 2. LSP を使うと言語ごとのパーサーが不要 Language Server Protocol を活用することで、 各プログラミング言語のパーサーを自作する必要がなくなり、開発が 大幅に効率化されました。 3. Vibe コーディングは楽しい AI に開発させて、お菓子食べながら楽しくできる。 8 / 18
9. Demo （アーキテクチャ/ 技術選定） 9 / 18
10. Doc Translate デモ 10 / 18
11. システムアーキテクチャ 11 / 18
12. 技術選定とその理由 LLM プロバイダー Anthropic Claude ( デフォルト: Haiku 4.5): 高速・低コスト・高品質 OpenAI ( デフォルト: GPT-4o-mini): 広く使われている標準的な選択肢 Google Gemini ( デフォルト: 2.0 Flash): 新興プロバイダー、高速レスポンス 12 / 18
13. 主要機能の実装 1. インライン翻訳表示（2 種類） コメント: after decoration で行末に表示 # Original comment → # 翻訳されたコメント Docstring: opacity: 0 で原文を隠し、before で翻訳を表示 """Original docstring""" → 翻訳されたdocstring カーソル時原文表示: 選択範囲と重なるdecoration を自動除外 13 / 18
14. 主要機能の実装 2. バックグラウンド事前翻訳 ファイルオープン/ 保存/ タブ切り替え時に自動実行 キャッシュベース（なければ翻訳、あればスキップ） 並列翻訳（最大5 並列）でパフォーマンス最適化 Progressive translation （完了したブロックから順次表示） 3. 永続化キャッシュ SHA-256 ハッシュベース VSCode globalState に自動保存 拡張機能再起動後も保持 14 / 18
15. 結果 15 / 18
16. Doc Translate で検索してください！ ※ docTranslate.provider 、 docTranslate.<provider>ApiKey の設定が 必要です。 16 / 18
17. お菓子おいしかった （ありがとうございます） 17 / 18
18. Thank you! 18 / 18