Desloppify review实战LLM主观评审如何用命名、抽象与模块边界给代码库打分【免费下载链接】desloppifyAgent harness to make your slop code well-engineered and beautiful.项目地址: https://gitcode.com/gh_mirrors/de/desloppifyDesloppify 是一款面向 AI 编程 Agent 的代码工程化 harness 工具它把机械检测死代码、重复、复杂度与LLM 主观评审结合起来从命名质量、抽象契合度、模块边界等维度给代码库打出 0–100 的健分数并驱动扫描 → 评审 → 分诊 → 修复 → 重扫的闭环。本文将带你完整走一遍它的 review 实战流程。一句话理解评分 25% 机械检测 75% LLM 主观评审Desloppify 的总健康分由两个独立的池子混合而成详见 scoring.md池子权重来源机械池25%自动检测器代码坏味道、重复、安全、测试覆盖等主观池75%desloppify review的 LLM 评审结论也就是说真正拉开差距的是 LLM 主观评审——机械检测能抓到的死导入、重复代码谁都能扫出来但抽象是否还成立、命名是否漂移、模块边界是否清晰这些结构性问题只有问对了问题的 LLM 才能稳定地指出来。主观池内部按维度加权完整目录定义在 subjective_dimension_catalog.py维度权重衡量什么High/Mid elegance2222架构层级的优雅度Contracts、Type safety1212契约与类型正确性Design coherence10设计决策是否自洽Abstraction fit8抽象是否物有所值Structure nav5目录结构与可导航性模块边界Naming quality2命名是否表达意图实战三个核心主观维度在审什么评审提示词按框架默认 语言覆盖两层组织通用定义在 dimensions.json各语言再叠加专属覆盖例如 Python 的 dimensions.override.json。以命名、抽象、模块边界三个维度为例命名质量naming_quality名字是否传达意图LLM 会重点抓这几类名字谎言含糊动词process、handle、do、run、manage—— 看完名字不知道发生了什么名不副实getX()却修改了状态isX()却返回非布尔值词表漂移同一个概念在不同文件里叫法不同脱离代码库既有词汇规范。抽象契合度abstraction_fitness抽象要付得起好的抽象应该带来真实的杠杆。LLM 评审会追问有没有纯透传包装——只是转发参数、没有策略或翻译价值有没有单实现的 Protocol/接口——声明了一族契约却只有一个实现没有扩展压力有没有util/helper 垃圾场——跨模块都往一个通用助手里塞东西导致内聚低下。以 Python 为例语言覆盖层还追加了锚点检查*args/**kwargs透传包装器、单实现 Protocol、隐式 dict 上下文袋、跨包的 helper 层间接调用。模块边界package_organization目录结构要匹配所有权这是最能体现模块边界评审的维度。LLM 会拿客观依赖证据说话导入图的 fan-in/fan-out、目录耦合矩阵检查根目录流浪文件低 fan-in 的根级文件主题上明明属于某个包为什么散落在外导入亲和度错位文件 60% 以上的导入都来自同一个领域却不在那个领域目录里边界方向失败两个目录互相双向依赖或下游反向 import 上游——这是放置位置错了的强信号。跑起来从 review 到修复循环安装并初始化要求 Python 3.11pip install desloppify[full]把.desloppify/加入.gitignore排除噪声用desloppify exclude path排除 vendor、构建产物等扫描 评审desloppify scan --path .先跑机械检测器LLM 主观评审在 review 阶段为命名、抽象、模块边界等维度打分两类维度一起计入总分分诊入队观察发现、聚类成簇、补充实现细节形成有序执行队列修复循环反复执行desloppify next→ 修复 →resolve→next直到达标。命令实现分别在 commands/review/、commands/scan/、commands/next/ 等目录评审编排逻辑在 intelligence/review/。防作弊设计分数为什么值得信双分数制Lenient 分数忽略wontfix项Strict 分数把wontfix、auto_resolved也算作失败——两者差值就是你默认接受的技术债置信度加权低置信度检测只按 30% 权重扣分避免误报拖垮分数样本衰减检查数少于 200 的维度按比例降权防止小样本维度喧宾夺主区域过滤测试、配置、生成代码、vendor 目录不参与评分只有生产与脚本区被打分复查可降分对某维度重新评审若 LLM 发现新问题分数可能不升反降——这就是分数上升 代码真的变好的底气。延伸阅读评分机制详解docs/scoring.md主观维度目录与权重subjective_dimension_catalog.py评审提示词框架层dimensions.json评审编排源码intelligence/review/ 注意分数是自我改进的追踪器而非绝对评级——不同代码库之间的 85 分不可直接比较。把它当作你的 Agent 的北极星指标让分数随每次重扫稳步上升就好。【免费下载链接】desloppifyAgent harness to make your slop code well-engineered and beautiful.项目地址: https://gitcode.com/gh_mirrors/de/desloppify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考