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

# Cline 规则

Cline 规则允许你为 Cline 提供系统级指导。可以将它们视为为你的项目或全局的每次对话持续包含上下文和偏好的方式。

## 创建规则

你可以通过点击规则选项卡中的 `+` 按钮来创建规则。这将在你的 IDE 中打开一个新文件，你可以用它来编写规则。

![创建规则](https://storage.googleapis.com/cline_public_images/docs/assets/cline-rules.png)

保存文件后：

* 你的规则将存储在项目的 `.clinerules/` 目录中（如果是工作区规则）
* 或者存储在全局规则目录中（如果是全局规则）：

### 全局规则目录位置

全局规则目录的位置取决于你的操作系统：

| 操作系统 | 默认位置 | 说明 |
| - | - | - |
| **Windows** | `Documents\Cline\Rules` | 使用系统文档文件夹 |
| **macOS** | `~/Documents/Cline/Rules` | 使用用户文档文件夹 |
| **Linux/WSL** | `~/Documents/Cline/Rules` | 在某些系统上可能回退到 `~/Cline/Rules` |

> **Linux/WSL 用户注意**：如果在 `~/Documents/Cline/Rules` 中找不到全局规则，请检查 `~/Cline/Rules`，因为位置可能会因系统配置和文档目录是否存在而有所不同。

你也可以通过在聊天中使用 [`/newrule` 斜杠命令](https://cat.mintlify.site/features/slash-commands/new-rule)让 Cline 为你创建规则。

```markdown Cline 规则结构示例 [可展开]
# 项目指南

## 文档要求

-   修改功能时更新 /docs 中的相关文档
-   保持 README.md 与新功能同步
-   在 CHANGELOG.md 中维护变更记录

## 架构决策记录

在 /docs/adr 中为以下内容创建 ADR：

-   主要依赖项变更
-   架构模式变更
-   新集成模式
-   数据库架构变更
    遵循 /docs/adr/template.md 中的模板

## 代码风格和模式

-   使用 OpenAPI Generator 生成 API 客户端
-   使用 TypeScript axios 模板
-   将生成的代码放在 /src/generated 中
-   优先使用组合而非继承
-   使用仓库模式进行数据访问
-   遵循 /src/utils/errors.ts 中的错误处理模式

## 测试标准

-   业务逻辑需要单元测试
-   API 端点需要集成测试
-   关键用户流程需要 E2E 测试
```

### 主要优势

1. **版本控制**：`.clinerules` 文件成为项目源代码的一部分
2. **团队一致性**：确保所有团队成员的行为一致
3. **项目特定**：针对每个项目需求定制的规则和标准
4. **制度知识**：在代码中维护项目标准和实践

将 `.clinerules` 文件放在项目的根目录中：

```
your-project/
├── .clinerules
├── src/
├── docs/
└── ...
```

另一方面，Cline 的系统提示是不可用户编辑的（[你可以在这里找到它](https://github.com/cline/cline/blob/main/src/core/prompts/system.ts)）。有关提示工程最佳实践的更广泛了解，请查看[这个资源](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/overview)。

### 编写有效 Cline 规则的技巧

* 清晰简洁：使用简单的语言，避免歧义。
* 专注于期望结果：描述你想要的结果，而不是具体步骤。
* 测试和迭代：实验以找到最适合你工作流程的方法。

### .clinerules/ 文件夹系统

```
your-project/
├── .clinerules/              # 包含活动规则的文件夹
│   ├── 01-coding.md          # 核心编码标准
│   ├── 02-documentation.md   # 文档要求
│   └── current-sprint.md     # 当前工作特定的规则
├── src/
└── ...
```

Cline 自动处理 `.clinerules/` 目录内的**所有 Markdown 文件**，将它们组合成统一的规则集。数字前缀（可选）有助于按逻辑顺序组织文件。

#### 使用规则库

对于具有多个上下文或团队的项目，维护一个规则库目录：

```
your-project/
├── .clinerules/              # 活动规则 - 自动应用
│   ├── 01-coding.md
│   └── client-a.md
│
├── clinerules-bank/          # 可用但非活动规则的仓库
│   ├── clients/              # 客户特定的规则集
│   │   ├── client-a.md
│   │   └── client-b.md
│   ├── frameworks/           # 框架特定的规则
│   │   ├── react.md
│   │   └── vue.md
│   └── project-types/        # 项目类型标准
│       ├── api-service.md
│       └── frontend-app.md
└── ...
```

#### 文件夹方法的优势

1. **上下文激活**：仅将相关规则从库复制到活动文件夹
2. **更容易维护**：更新单个规则文件而不影响其他文件
3. **团队灵活性**：不同团队成员可以激活特定于当前任务的规则
4. **减少噪音**：保持活动规则集专注和相关

#### 使用示例

在客户项目之间切换：

```bash
# 切换到客户 B 项目
rm .clinerules/client-a.md
cp clinerules-bank/clients/client-b.md .clinerules/
```

适应不同的技术栈：

```bash
# 前端 React 项目
cp clinerules-bank/frameworks/react.md .clinerules/
```

#### 实施技巧

* 保持单个规则文件专注于特定关注点
* 使用清楚表明规则目的的描述性文件名
* 考虑 git-ignore 活动的 `.clinerules/` 文件夹，同时跟踪 `clinerules-bank/`
* 创建团队脚本以快速激活常见规则组合

文件夹系统将你的 Cline 规则从静态文档转换为适应团队不断变化的上下文和要求的动态知识系统。

### 使用可切换弹出窗口管理规则

为了让管理单个 `.clinerules` 文件和文件夹系统变得更加容易，Cline v3.13 引入了一个专用的弹出窗口 UI，可以直接从聊天界面访问。

这个弹出窗口方便地位于聊天输入字段下方，允许你：

* **即时查看活动规则**：查看当前活动的全局规则（来自用户设置）和工作区规则（`.clinerules` 文件或文件夹内容）。
* **快速切换规则**：一键启用或禁用工作区 `.clinerules/` 文件夹内的特定规则文件。这非常适合仅在需要时激活上下文特定的规则（如 `react-rules.md` 或 `memory-bank.md`）。
* **轻松添加/管理规则**：如果不存在工作区 `.clinerules` 文件或文件夹，快速创建，或向现有文件夹添加新规则文件。

这个 UI 大大简化了切换上下文和管理不同指令集的过程，无需在对话期间手动编辑文件或配置。

![Cline Logo](https://storage.googleapis.com/cline_public_images/docs/assets/image%20\(1\).png)


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