制作背景
長期運用される業務システムでは、コードレビューの観点が担当者の経験や現場ごとの暗黙知に寄りやすくなります。Q-Scoutは、Spring開発で繰り返し確認したい品質観点をツールとして明文化し、レビュー前の共通土台を作るために制作しました。
Purpose
レビュー観点のばらつきを、共有可能な診断結果へ変換する。
解決したい課題
技術負債や設計劣化は、障害や改修遅延として表面化するまで見過ごされることがあります。診断結果をスコアとMarkdownで残すことで、改善対象をチームで確認しやすくし、判断の属人化を減らすことを狙っています。
設計判断
AI APIに依存しなくても診断価値が成立するよう、ルールベース診断と人間向けレポートを中心に置いています。AI相談用のMarkdownは補助入力として扱い、レビュー担当者が判断しやすい粒度で結果を整理します。
Features
主な機能と技術構成
品質診断
Springプロジェクトの構成や実装を確認し、設計健全性、保守性、Springベストプラクティスに関わる観点を診断します。
スコアリング
診断結果を点数化し、状態を比較しやすくします。レビュー前後や改善作業後の変化を追いやすい形にすることを重視しています。
Markdownレポート
人間が確認するレポートとAI相談用の入力をMarkdownで整理し、改善方針の共有や次の作業への接続をしやすくします。
技術スタック
Java / Spring Boot / Maven / Docker / Markdown / Render を中心に、Web UIと分析フローを構成しています。
Roadmap
今後の拡張方針
診断観点の拡張
Controller、Service、Repository、設定、例外処理など、Spring開発で品質差が出やすい領域の診断観点を増やします。
レポート改善
改善優先度、影響範囲、修正方針をより読み取りやすくし、レビュー会話や改善チケットへ転記しやすい形式に整えます。
AI相談連携
診断結果をAI相談へ渡しやすい粒度に整理し、人間のレビュー判断を残したまま実装改善の相談につなげる構成を強化します。