aislop
捕捉並修復 AI 編碼代理遺留的程式碼品質問題 - 死程式碼、不安全的型別轉換、被吞沒的錯誤、重複、安全風險等。50 多條...
aislop 是什麼？
捕捉並修復 AI 編碼代理遺留的程式碼品質問題 - 死程式碼、不安全的型別轉換、被吞沒的錯誤、重複、安全風險等。針對 10 種語言目標的 50 多條確定性規則，支援 CLI、CI 與 GitHub Actions。執行時無需 LLM。MIT 授權。
aislop 概覽
這是什麼
aislop 是一個確定性的程式碼品質工具，用來抓取 AI 編碼代理（如 Claude Code、Cursor、Codex、OpenCode）遺留的問題。它偵測的模式包括：在自解釋程式碼上方的敘述性註解、被吞掉的例外、隱藏的 fallback、as any 轉型、幻覺匯入、重複的輔助函式、死程式碼、待辦 stub、過大的函式。它套用 50 多條規則，涵蓋 10 種語言目標：TypeScript、JavaScript、Expo / React Native、Python、Go、Rust、Ruby、PHP、C#、C/C++。每次變更都會在次秒內獲得 0–100 的分數。該工具是確定性的——執行時不使用 LLM——並以 MIT 授權釋出，提供免費的 CLI。
主要功能
- 50 多條確定性規則，涵蓋 10 種語言目標 - 次秒內為每次變更評分 0–100，執行路徑中無 LLM - 支援 CLI、CI 模式與 GitHub Actions - 自動修復機械性問題（未使用的匯入、死程式碼、格式化） - 可依規則覆蓋嚴重性，並透過註解內聯抑制 - 支援多種套件管理器：npm、Yarn、Bun、Homebrew、PyPI - 輸出 JSON、SARIF 2.1.0（GitHub 程式碼掃描）及公開徽章 - 可透過
.aislop/config.yml設定，支援繼承與 JSON Schema 驗證
使用情境
- 在 AI 編碼代理引入問題之前，抓出程式碼品質問題 - 整合至 CI 管線，根據分數門檻決定是否通過 - 自動修復機械性問題，如未使用的匯入與死程式碼 - 使用
aislop agent將診斷資訊交給編碼代理進行修復 - 透過分數徽章監控程式碼品質變化
快速開始
無需安裝即可執行一次性掃描： bash npx aislop@latest scan 全域安裝 CLI 並設定每次編輯鉤子： bash npm install -g aislop && aislop hook install 其他安裝方式： bash yarn dlx aislop scan # Yarn（無需安裝） bun add -g aislop # Bun brew install scanaislop/tap/aislop # Homebrew pipx install aislop # Python 自動修復與 CI 模式： bash aislop fix aislop ci
授權與價格
本專案採用 MIT 授權。為開放原始碼且免費使用。CLI 為免費。
內容整理自該專案公開的 README 與儲存庫資訊。
