代码规范
禁用引用、危险 API、固定写法。
正则 / 代码模式匹配把团队经验变成可执行、可证明、可迭代的审查标准。
规范、结构与业务语义,为什么不能只依赖人工记忆或模型猜测?
团队规范很明确:不能使用阿里云 StringUtils。真正的问题是,它能否稳定、自动、逐行地落到开发现场?


检测器沿 代码结构追踪“循环体 → IO 调用”的关系,在规则层直接确认风险,保证同样的代码得到同样的结论。
bdc_xm.qlr / qlrzjh 是项目上多名权利人的拼接摘要,用于列表展示和候选筛选;真正可定位到人员的记录在 bdc_qlr 明细表中。
// qlr / qlrzjh 是多值拼接摘要,不是人员唯一标识
BdcQlrDO bdcQlrDO = new BdcQlrDO();
bdcQlrDO.setQlrmc(bdcXmDO.getQlr());
bdcQlrDO.setZjh(bdcXmDO.getQlrzjh());
entityMapper.selectByObj(bdcQlrDO);// xmid 关联明细,结果可准确对应项目下的每位权利人
BdcQlrDO bdcQlrDO = new BdcQlrDO();
bdcQlrDO.setXmid(xmid);
List<BdcQlrDO> qlrList =
entityMapper.selectByObj(bdcQlrDO);禁用引用、危险 API、固定写法。
正则 / 代码模式匹配循环体与 IO、调用链与资源释放。
代码结构与数据流分析摘要字段、状态边界、服务职责。
知识库与智能体分析平台的关键,不是让一个模型回答所有问题,而是让每类问题进入最适合的判断路径。
接入模型可以很快,但没有确定性规则、正式知识与证据链,就难以成为稳定门禁。
大部分团队的代码审查停留在文档纸面上,成员之间口口相传。
疲劳、无时间、主观偏见、认知局限,让审查质量随人和时段波动。
只看代码表面,难以识别业务背景、状态边界和服务职责。
评论停在当前 MR(合并请求),误报、漏报和修复经验没有回到下一次审查。

它能快速生成意见,但判断路径通常是自由的:规则、业务知识与证据没有被拆开管理。

同一个问题可能因上下文、提示词和模型状态不同而给出不同结论。
评论里有观点,却缺少规则版本、知识来源和可复核的检测证据。
一次 MR(合并请求)解决了一个问题,但下一次仍要重新提问、重新解释。
把确定性规则、业务知识与 Agent 方法组织成一条可追踪的审查链路。



GitLab MR(合并请求)、Webhook、状态与评论。
规则检测器、项目模型与智能体。
规则、知识库、Skill 与版本证据。
仪表盘、模型配置与审查详情。
线上意见回流为质量资产。
结论能回到代码、知识与过程。
规则检测始终先行;需要时,再增加模型或智能体审查,结论给回到开发人员。


只运行规则卡片检测器,无需配置 LLM。适合禁用 API、引用方式、结构性约束,稳定、快速、可门禁。
无需 LLM / 正则 / 代码模式 / 结构分析先做规则检测;已有知识库作为上下文,又希望以较低延迟得到评审结果时使用。
规则检测 + 知识库 + LLM先做规则检测;有业务知识库、业务语义复杂,并需要配合审查 Skill 推理时使用。
规则检测 + 知识库 + Skill + 智能体代码规则定义什么不能做,知识库辅助代码修改方向,审查 Skill 规定 Agent 如何分析。
RuleCard 包含规则定义、检测器、适用范围、严重级别和正反例;它只做确定性判断。



能用正则表达式解决的,不用猜;能用代码模式匹配解决的,不交给生成式判断;需要关系分析时,用代码结构与数据流分析。
精确捕捉禁用类、包名与固定模式。
匹配调用、条件、返回值等代码形状。
识别循环体与 IO 调用关系。
直接产出可定位、可复核的代码证据。


规则卡片解决“代码怎么写才合规”;知识库沉淀业务知识、边界和背景,帮助审查判断 MR(合并请求)的修改方向有没有走偏。
禁用 API、引用方式、结构约束
→ 抽离为规则卡片
业务边界、背景与正式事实
→ 结构化、向量化后使用
设计、需求文档未经整理
→ 噪声增加,审查更差
它规定上下文读取顺序、关注的风险维度、证据引用方式、结论格式与停止条件,让 Codex / Qoder Agent 的深度审查可复用。

每条审查结论都有规则版本、检测位置、知识证据与审查过程,才值得进入团队质量闭环。
从规则加载、命中结果、知识引用,到完整审查详情,每个结论都有对应的过程记录。
知道哪一版规则卡片触发了结论。

知道哪一行、哪一种规则检测器发现了问题。

业务判断能回到正式知识与快照。

审查详情保留模式、模型、Skill 与结果。

下一次代码审查,不从“谁记得这条规范”开始,
而从平台已经沉淀的质量资产开始。