> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 自动规则生成

> Kody 可以通过分析团队的代码审查历史自动生成自定义规则。让她从您过去的审查中学习以创建个性化的编码标准。

<Warning>
  \*\*需要代码库上至少 3 个月的 Kody 审查历史。\*\*此功能从 Kody 对您 PR 的过往审查中派生规则,因此刚接入的代码库不会产生有用的建议。如果您刚开始使用 Kody,请在积累几个月真实审查后再回来。
</Warning>

## 快速概述

* **自动生成**:Kody 分析您的审查历史以创建新规则
* **数据驱动**:使用 3 个月的审查数据获取智能见解
* **智能建议**:基于实际团队模式生成规则
* **可选审批**:生成的规则默认处于激活状态;开启 **Kody knowledge approval** 可在每条规则生效前先进行审查
* **持续学习**:随着团队发展每周更新规则

<Frame caption="Kody Rules 的 Configuration 面板中的 Generate from past reviews 和 Kody knowledge approval">
  <img src="https://mintcdn.com/kodus/O447Mtyto-OZAUba/images/sync-rules.png?fit=max&auto=format&n=O447Mtyto-OZAUba&q=85&s=3071781ec4f342f6a0bd38bfed9d3798" alt="Kody Rules Configuration sheet" width="1055" height="1148" data-path="images/sync-rules.png" />
</Frame>

## 工作原理

### 1. 开启规则生成

规则生成按代码库设置:

1. 在侧边栏中,通过 **Code review** 分组顶部的范围选择器选择代码库,然后打开 **Kody Rules**
2. 点击 **Configuration** 打开侧边面板
3. 开启 **Generate from past reviews**
4. 可选:使用开关下方的审查者选择器(默认为 **Learning from all reviewers**)排除 Kody 不应从其审查评论中学习的开发者

### 2. 分析过程

当您首次为某个代码库开启 **Generate from past reviews** 时,Kody 将:

* **扫描审查历史**:分析代码库中最近 3 个月已关闭的 PR
* **识别模式**:发现常见的反馈主题和编码偏好
* **提取标准**:将审查模式转换为可操作的规则
* **生成规则**:创建针对团队风格定制的自定义规则

这可能需要几分钟。生成的规则随后会出现在该代码库的 **Kody Rules** 页面上。

### 3. 审查生成的规则

生成的规则以 **Kody-generated** 来源列出(使用 **Filters → Origin → Kody-generated** 仅查看这些规则)。打开其中任意一条,即可像其他规则一样编辑、暂停或删除它。

### 4. 在规则生效前进行审批

<Warning>
  默认情况下,生成的规则**一经创建即处于激活状态**,并会在下一次代码审查中执行。
</Warning>

要在生成的规则生效前对其进行审查,请在同一个 **Configuration** 面板中开启 **Kody knowledge approval**。开启审批后:

* **待审查**:新生成的规则会进入 Kody Rules 页面顶部的 **Pending review** 区域,而不会被执行
* **选择性选择**:对符合团队需求的规则点击 **Approve**,其余的点击 **Discard**
* **激活**:只有已批准的规则才会在代码审查期间执行

## 持续学习

初始设置后,Kody 维护持续的学习循环:

* **每周更新**:Kody 每周生成新的规则建议
* **演变标准**:规则建议随着团队的编码风格演变而调整
* **精确度提高**:建议随着时间的推移变得更加精确
* **定期审查**:每周出现新规则(开启审批时出现在 **Pending review** 中)

## 要求

* **最少数据**:代码库中至少 3 个月的审查历史
* **活跃审查**:定期代码审查活动以更好地检测模式
* **代码库访问**:修改代码库规则的适当权限


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.