scanaislop/aislop

什麼是 aislop？

aislop は、AIコーディングアシスタント（Claude Code、Cursor、Codexなど）が残す不整なパターンをコード内でスキャンするコマンドラインツールです。プロジェクトに0～100の品質スコアを付与し、問題のあるコードをマークし、機械的な問題を自動で修正できます。

機能

• スキャン：コードベース（または変更されたファイルのみ）を、10言語（TypeScript、Python、Go、Rust、Ruby、PHP、C#、C/C++など）で50以上のルールでスキャン。
• スコアリング：変更ごとに0～100のスケールでスコアを付与。重大な問題はスタイルの細部よりも大きな影響を及ぼすように重み付け。
• 自動修正：未使用のインポート、不要なコード、フォーマットなど、純粋に機械的な問題を自動で修正。判断が必要な部分は、あなたのコーディングエージェントに任せます。
• 統合：CI/CD、Gitフック、人気のあるAIコーディングツールと統合され、編集やプルリクエストごとにチェックが実行されます。

動作方法

aislopは決定論的です。正規表現、AST解析、標準的なリンター/フォーマッタ（Biome、ruff、gofmt、clippyなど）を使用します。LLMもAPI呼び出しも行わないため、同じコードは常に同じスコアになります。6つの並列エンジンで動作します：

• フォーマット – 標準ツールによるスタイルの一貫性
• リンティング – 言語固有の問題
• コード品質 – 複雑さ、不要なコード、未使用ファイル
• AIの雑さ – AIエージェントが残す特定のパターン（物語的なコメント、飲み込まれた例外、as anyキャスト、架空のインポートなど）
• セキュリティ – インジェクションリスク、ハードコードされたシークレット、依存関係の監査
• アーキテクチャ – インポート禁止やレイヤー制限などのオプションカスタムルール

主な機能

• ゼロ設定スタート：npx aislop@latest scan で任意のリポジトリで動作。
• 自動修正：aislop fix で機械的な問題をクリーンアップ；--safeモードでは逆戻し可能な変更のみ適用。
• エージェント統合：aislop agent で既存のコーディングエージェント（Codex、Claude Codeなど）とローカルで修復セッションを実行し、結果を検証。
• フック：編集ごとにフックをインストールし、AIエージェントがコードに反映される前に雑さを修正。
• CIゲート：スコアがしきい値を下回るとaislop ciでビルドを失敗。
• MCPサーバー：Claude Desktop、Cursor、Codexなどのツールとしてaislopを公開。
• パブリックバッジ：READMEにスコアを表示。

なぜ使うべきか？

AI生成コードはテストやリンターを通過するものの、微妙な劣化（冗長なコメント、隠れたフォールバック、重複したヘルパー、不要なコードなど）を含むことがあります。aislopはこれらのパターンを早期に検出し、単一の品質ゲートを提供し、AIツールがワークフローに組み込まれる中でもコードベースを清潔に保つのに役立ちます。