用途:Desloppify 是代码库健康扫描器与技术债跟踪工具。当用户关注代码质量、技术债、死代码、大文件、上帝类或重复代码时,可用它发现并跟进问题,通过“扫描→计划→执行→重扫”的循环提升健康度。
主要能力:执行 desloppify scan --path . 分析代码库,desloppify status 查看分数。综合评分中机械项占 25%(重复、死代码、异味、未用导入、安全问题),主观维度占 75%(命名、错误处理、抽象、清晰度),未评审时主观分从 0 开始。分数类型包括 overall、strict、objective、verified;strict 会把 wontfix 视为未解决。问题按层级划分:T1 自动修复、T2 快速手工、T3 判断性、T4 大型重构,并有自动聚类与执行队列 next。
使用方式:用 desloppify next 获取下一步执行项,desloppify plan、plan queue、plan triage(observe/reflect/organize/complete)用于计划与分诊;支持 --run-stages --runner codex 或 claude 自动分诊。修复后可 desloppify plan commit-log record 记录提交并更新关联 PR,建议在独立分支 desloppify/code-health 上作业。评审可用本地 runner(如 review --run-batches --runner codex --parallel --scan-after-import)、云/外部会话或手工流程,评审结果以 JSON 导入,findings 需与查询提示一致,导入默认 fail-closed,可用 --allow-partial。
限制与注意:文本要求智能体遵循扫描输出的 INSTRUCTIONS FOR AGENTS,不要用自有分析替代;执行队列未清空前不要中途重扫;修复后分数可能暂时下降属正常级联效应。评分须仅依据证据,不锚定目标阈值或历史分数,证据混合时给较低分并说明不确定性。反作弊机制会在分数匹配目标时触发自动重置。安装可用 uvx --from git+https://github.com/peteromallet/desloppify.git desloppify,或 pip install desloppify[full]。工具自身的问题建议修复并向上游提 PR,或到 https://github.com/peteromallet/desloppify/issues 提交最小复现。其他收费、平台与效果信息暂未提供。