AI 评代码口径飘忽?brooks-lint 把十二本工程经典做成统一标尺

让 AI 帮忙评审代码的人,多半遇到过同一件尴尬事:同一处代码,今天说有隐患,明天又说没问题——模型的评判口径会漂。开发者 hyhmrright 的 brooks-lint 就是冲着这件事来的:它把《人月神话》《代码大全》《重构》《整洁架构》等十二本工程经典提炼成一套固定的评审标尺,AI 每次都按同一把尺说话。它既是 DeepSeek Harness(DSH)插件广场上的工作流插件,也能以技能包形态装进 Cursor、Codex 等十余个编程助手,MIT 协议开源。

评什么有章法。 它把生产代码的衰变风险归成六个维度:认知负担(读懂这段要费多大劲)、改动传播(改一处会牵连多少无关模块)、知识重复(同一个决定写在几个地方)、偶然复杂度(代码比问题本身还绕)、依赖方向(依赖关系是否顺着一个方向走)、领域模型走样(代码是否忠实反映业务)。另有一套六维标尺专看测试代码:断言是否有效、测试之间是否互相牵连、哪些测试形同摆设。

怎么报告有格式。 每条发现都按四段给出:症状是什么、根源在哪本书说的哪个道理、放任下去会怎样、具体怎么改,并注明出处书名。整个项目还会给出一个 0 到 100 的健康分,前后两次体检的分数可以直接对比。

用起来是六条命令。 brooks-review 做常规评审,brooks-audit 做架构审计,brooks-debt 盘技术债,brooks-test 专审测试,brooks-health 出整体体检报告,brooks-sweep 做清扫。不记命令也行,装好之后直接说「审查这个提交」,它按场景自动接活。

标尺本身也讲道理。 每个维度对应哪些书的哪些观点,项目里有一份公开的出处对照表,连例外情况和防误报的判定都写在明处——发现不合理时,可以顺着表格查到这条判据来自哪本书的哪个主张,服不服气都有据可查。文档备了简繁中文、英文、日文等多个语种,网页版示例从一份代码直接演示到带出处的评审报告。

便携是它的另一个卖点。 在支持插件市场的编程助手里一条命令安装;其余平台走官方安装脚本,按平台名选一下就好;还能接进持续集成,让每次合并前自动跑一遍评审,健康分掉了就地拦下。

适合谁用。 小团队没有资深工程师把关评审,个人开发者想要一套不漂的口径,接手老项目想先摸清病灶再动手——都可以让它先跑一轮体检,把报告当成整改清单来用。企业在给 AI 编程立规矩时,这种带出处的评审比口头约定好落地:新人照着报告读几轮,顺带就把经典著作里的要紧章节过了一遍。贵阳 软件开发 的团队想把 AI 评审纳入研发流程,欢迎搜索了解贵州诚鑫致达科技。

企业存储选型参考|贵州诚鑫致达

做全闪高性能数据库与虚拟化,群晖机型参考:FS6400 · FS3410 · FS2500。需要选型建议或上门评估,搜「诚鑫致达」即可找到我们。

服务区域|贵州诚鑫致达

贵州群晖NAS、贵阳存储、数据备份、信创云盘或 IT 集成服务,可联系贵州诚鑫致达科技,服务范围覆盖贵州全省各市州。重庆企业 NAS 存储、服务器运维与容灾备份方案。