全局规则源

全局规则源让你把 Kodus 指向一个或多个已连接的代码库,并把其中的规则文件导入为全局 Kody Rules。与代码库规则(仅在其所在代码库生效)不同,从全局源导入的规则会在代码审查时应用到所有代码库。 当团队把架构与编码标准放在一个专门的 “standards” 代码库中,并希望这些标准在各处都被执行、又不想把规则文件复制到每个项目时,就用它。

​

工作原理

• 你选择若干已连接的代码库作为源。
• Kodus 使用与规则文件检测相同的模式扫描每个源代码库(CLAUDE.md、AGENTS.md、.cursor/rules/**、.kody/rules/** 等)。
• 每个被发现的规则文件都会导入到全局作用域,并标记它来自哪个源代码库。
• 在任何代码库的审查过程中,这些全局规则会与该代码库自身的规则一起应用(遵循继承规则)。

​

设置

1. 在侧边栏 Code review 分组顶部的范围选择器中选择 Global,然后打开 Kody Rules。
2. 点击 Configuration 打开侧边面板,找到 Global rule sources。
3. 点击代码库选择器,选择一个或多个已连接的代码库。
4. 点击 Import selected。

导入在后台运行。完成后,导入的规则会出现在你的全局 Kody Rules 列表中,每条都标注了其源代码库。

​

保持规则最新

导入的规则会自动更新,也可按需更新:

• 合并时 —— 当源代码库中有 Pull Request 被合并时,其规则文件会被重新扫描,全局规则随之更新。未变更的文件会被跳过,因此开销很小。
• Resync now —— 使用 Resync now 按钮按需重新扫描所有已配置的源。这也涵盖直接推送到源代码库默认分支的改动。

​

移除一个源

把某个代码库从源列表中移除,会删除从它导入的全局规则 —— 这些规则将不再在代码审查中生效。移除生效前会要求你确认。来自其他源的规则,以及你手工编写的规则,都不会受到影响。

​

源代码库不会被审查

仅作为全局规则来源使用的代码库,会被视为配置代码库而非代码本体。Kodus 会跳过在全局规则源中打开的 Pull Request 的代码审查,与集中式配置代码库的处理方式相同。

​

套餐可用性

能否使用全局规则源取决于你的套餐:

​

相关内容

• 代码库规则 —— 纳入版本控制、作用于单个代码库的规则。
• 规则文件检测 —— Kodus 扫描的文件模式。
• 规则继承 —— 全局、代码库和目录规则在审查时如何组合。