scanaislop/aislop

Catch and fix the code-quality issues AI coding agents leave behind - dead code, unsafe casts, swallowed errors, duplication, security risks, and more. 50+ deterministic rules across 10 language targets, with CLI, CI, and GitHub Actions. No LLM at runtime. MIT.

什么是 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 解析以及标准的 linter/formatter（如 Biome、ruff、gofmt、clippy）。不使用 LLM，也不调用 API，因此相同代码总是获得相同分数。它运行六个并行引擎：

格式化 – 通过标准工具实现风格一致性
Linting – 语言特定的问题
代码质量 – 复杂度、死代码、未使用文件
AI 杂乱 – AI 代理留下的特定模式（叙事性注释、被吞没的异常、as any 类型断言、虚构的导入等）
安全 – 注入风险、硬编码密钥、依赖项审计
架构 – 可选的自定义规则，用于禁止导入或分层限制

主要功能

零配置启动：npx aislop@latest scan 可在任何仓库中直接运行。
自动修复：aislop fix 清理机械性问题；--safe 模式仅应用可逆的更改。
代理集成：aislop agent 与你现有的编码代理（Codex、Claude Code 等）运行本地修复会话，并验证结果。
钩子：安装每编辑一次的钩子，让 AI 代理在代码落地前修复杂乱。
CI 门禁：aislop ci 在分数低于阈值时使构建失败。
MCP 服务器：将 aislop 作为工具暴露给 Claude Desktop、Cursor 或 Codex 使用。
公开徽章：在 README 中展示你的评分。

为何要使用它？

AI 生成的代码虽然通过测试和 linter，但常包含细微的退化问题——如注释过于冗长、隐藏的回退逻辑、重复的辅助函数或死代码。aislop 能早期捕捉这些模式，提供单一质量门禁，并帮助你在 AI 工具融入工作流的同时，保持代码库的整洁。