, AI-SLOP Detector 3.1.1 - AIエージェントが作ったスパゲッティコードを見つける分析ツール

AI-SLOP Detectorは、AIエージェントが作成したコードでよく見られる構造的欠陥を静的解析するツールです。

単純なスタイル検査よりも、stub実装、phantom import、大げさなコメントや用語、helperに分割して隠した複雑さのような、
「見た目はきれいだが実際には不安定なコード」を見つけることに重点を置いています。

何ができるか

• 単一のPythonファイル / プロジェクト全体の解析
• JSON出力による自動化パイプライン連携
• CI gateでの利用
• VS Code拡張をサポート
• AIコードの構造的欠陥パターンを検出

なぜ必要か

• すばやく生成されたAIコードの見かけの品質と、実際の実装密度を見分ける助けになる
• lint/styleツールが見落としやすい、もっともらしい空っぽのコードを追加でふるい落とせる
• ローカル解析からCIまでそのままつなげられる

2.9.x ~ 3.1.1 の主な変更点

• phantom import検出を追加・高精度化
  → 存在しないパッケージ、誤ったimport、optional dependency/guarded importをより正確に区別
• history tracking + self-calibrationを追加
  → 実行履歴をもとに、false positiveと実際の問題をより区別しやすくなった
• スコアモデルを加重幾何平均(GQG)ベースに変更
  → 1つか2つの良い指標で全体の問題が覆い隠されにくくなった
• fragmented god function検出を追加
  → 複雑な関数を複数のhelperに分割し、きれいに見せかけて隠すパターンも見つけられる
• placeholder variable naming検出を追加
  → r1, r2 ... r12 や単一文字パラメータの乱用のように、見た目は整理されていても意味が乏しいコードもシグナルとして捉える
• empty-container / constant stub検出を強化
  → return {}, return [], return 42 のような「形だけ関数のコード」もよりうまく見つけられる
• SPAR-Codeベースのadversarial validationを追加
  → 機能が増えたというより、以前は見逃していた回避パターンをよりよく捉える方向で強化
• VS Code / CLI workflowを改善
  → clone signalの可視性、workspace analysis、history trendsなど、実運用での流れがより良くなった。