用途:Desloppify 是命令行代码库健康扫描与清理工具,通过反复的“扫描→计划→执行→重扫”循环识别并修复技术债,目标是诚实地提高 strict 分数。适用多语言、单体仓库及多项目目录,扫描时每个 --path 目标应为单一项目,多程序工作区需分别扫描。
主要能力:扫描代码问题并给出评分;评分由 25% 机械项(重复、死代码、坏味道、未用导入、安全)与 75% 主观项(命名、错误处理、抽象、清晰度)构成。提供 overall、strict、objective、verified 分数,strict 将 wontfix 计为未解决,是核心指标。支持 plan 制定与队列管理、triage 分阶段归纳、cluster 分组、commit 记录与 PR 描述更新、autofix 预览、directives 生命周期指令,以及审查结果的 JSON 导入。
使用方式:常见命令包括: desloppify scan --path . desloppify status desloppify next desloppify review --prepare desloppify plan triage --run-stages --runner codex(或 claude) desloppify plan queue desloppify plan commit-log record 审查可走本地 Codex、Claude 子代理、云端外部运行器或手动导入;批处理输出须命名为 batch-N.raw.txt。建议先建专用分支如 desloppify/code-health,再按 next 队列逐项修复、提交并推送。
适用场景:需要系统性治理技术债、获取健康分、按优先级批量清理代码的项目;支持 Codex、Claude、Cursor、Copilot、Gemini 等运行器环境。
限制:主观分需经审查流程才从 0% 起步,分数可能因级联效应临时下降;导入为 fail-closed,需 --allow-partial 才容错;目标阈值匹配会触发自动重置,须按盲审流程避免分数锚定。安装可参考:uvx --from git+https://github.com/peteromallet/desloppify.git desloppify 或 pip install desloppify[full] && desloppify setup。具体平台支持、收费与价格暂未提供。