AI coding agent harness,自动扫描、评分并系统性改进代码库质量,将快速原型产出提升至工程级标准。
Desloppify 是一个面向代码库质量治理的 AI coding agent harness,通过机械检测与 LLM 主观评审双轨体系,对代码库进行多维度量化评估。核心工作流为 scan → score → review → triage → execute → rescan,通过 next 命令逐步推进修复任务,配合 Claude、Cursor、Copilot 等 AI 编码代理完成实际代码改进。
支持死代码、重复代码、复杂度、测试覆盖缺口等客观指标检测,以及命名质量、抽象层次、错误处理模式等主观维度评审。评分系统采用 strict/lenient 双分数机制,并内置防作弊设计——wontfix 项会拉大 strict 与 lenient 分差,重新 review 可能导致降分。状态持久化在 .desloppify/ 目录中,支持跨会话增量推进技术债务偿还。
支持 29 种编程语言,对 TypeScript、Python、C#、C++、Dart、GDScript、Go、Rust 提供完整插件深度支持,其余语言通过通用 linter + tree-sitter 覆盖。C++ 以 compile_commands.json 为主要分析路径。Monorepo 场景下可按 --path 和 --lang 分别扫描子项目。98+ 分可生成 GitHub Scorecard 徽章。
基于 Python 3.11+,通过 PyPI 分发(pip install "desloppify[full]"),采用 OSNL-0.2 许可证(个人/内部使用免费,开源公司可自由商用)。CLI 入口为 desloppify.cli:main,包结构按语言分子包,构建系统为 setuptools,使用 Ruff + mypy 进行代码质量管控,pytest 覆盖所有语言子包测试。
安装与快速开始
pip install --upgrade "desloppify[full]"
desloppify update-skill claude # 可选: claude, cursor, codex, copilot, droid, windsurf, gemini
desloppify scan --path .
desloppify next
Monorepo 场景
desloppify --lang typescript scan --path ./frontend
desloppify --lang python scan --path ./backend
主要命令:scan(扫描评分)、next(执行下一任务,核心循环命令)、backlog(查看全部待处理)、plan(重排序优先级)、exclude(排除目录)、update-skill(安装 AI agent 工作流指南)。
待确认:review 阶段使用的具体 LLM 模型及配置方式未明确;resolve 命令细节待查阅文档;29 种语言的完整列表未逐一列出;Scorecard 徽章格式与托管方式未明确;是否存在独立配置文件机制待确认。