sloppy

針對AI代理在PHP中留下的技術債進行靜態分析:34條規則、Claude Code鉤子、git-diff審查、Rector和Pint修復流程、Pest期望、CI註解

sloppy 是什麼?

針對AI代理在PHP中留下的技術債進行靜態分析:34條規則、Claude Code鉤子、git-diff審查、Rector和Pint修復流程、Pest期望、CI註解以及一個MCP伺服器。確定性、本地、無LLM。

sloppy 概覽

這是什麼

Sloppy 是一個 PHP 靜態分析工具,專門偵測 AI 代理常引入的程式碼品質問題。它提供 34 條確定性規則、Claude Code 鉤子、git-diff 審查、Rector 與 Pint 修復流程、Pest 斷言、CI 註解以及一個 MCP 伺服器。工具在本機執行,無需 LLM,也不依賴網路。

主要功能

  • 34 條確定性規則,涵蓋複雜度、重複、死碼、錯誤處理、可讀性、Laravel、路由/遷移、效能、依賴、架構與抑制。
  • 代理整合:掛接 Claude Code(以及 Gemini CLI、Codex),在每次編輯後檢查,並防止髒提交。
  • Git-diff 審查:只報告分支新引入的問題,不報告繼承的問題。
  • 基準線支援:接受既有技術債,僅讓新問題導致建置失敗。
  • CI 註解:在 GitHub Pull Request 上註解 diff,並填入 GitLab Code Quality 小工具。
  • 修復流程:將機械性問題交給 Rector 處理,刪除冗餘註解,再用 Pint 格式化。
  • Pest 斷言:內建 Pest 外掛,可在測試中對新技術債進行斷言。

使用情境

  • 在 Claude Code、CI 與 Pest 測試套件中捕捉程式碼品質問題(上帝方法、吞沒例外、N+1 查詢)。
  • 審查分支上的變更,只看新引入的缺陷。
  • 在已有歷史的程式碼庫中採用靜態分析,並使用基準線管理。
  • 以最少設定在 CI 中阻擋新技術債。
  • 自動修復機械性問題(Rector 與 Pint)。

快速開始

bashcomposer require --dev heyosseus/sloppyvendor/bin/sloppy # 掃描專案(Laravel 中為 php artisan sloppy)vendor/bin/sloppy agents install # 讓 Claude Code 檢查自己的成果(--host=gemini, --host=codex)無需設定檔或帳號。可在任何 PHP 8.3+ 專案上執行。若使用 Laravel 12 或 13,會自動加入十條 Eloquent 感知規則。

授權與價格

MIT 授權。開放原始碼。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/heyosseussloppy.svg)](https://yunodb.com/tools/heyosseussloppy?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/heyosseussloppy?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/heyosseussloppy.svg" alt="Featured on YunoDB" height="20"></a>