AI 编程 · 规则文件

.clinerules 是什么?
Cline 的项目规则文件和文件夹

你在用 Cline 这个开源 AI 编程 agent,或者在仓库里瞄到一个 .clinerules。它是你给 Cline 项目规则的方式:关于技术栈、约定、命令的指令,让它照你想的方式在你项目上干活。

让人绕的是它有两种形态:一个 .clinerules 文件,或一个装满 Markdown 文件的 .clinerules/ 文件夹。这就是每种是什么、里面写什么。

两种形态:单文件,或 .clinerules/ 文件夹

  • 仓库根一个 .clinerules 文件——把所有规则放一处,适合小而简单的一套。
  • 一个 .clinerules/ 文件夹——装几个 Markdown 文件,一个主题一个(比如 style.mdtesting.mdarchitecture.md),Cline 一起加载。规则一多,这样更整齐。想让这样一个文件夹保持好读,看 md 文件怎么整理

不管哪种,内容一样,而且全是 Markdown。

里面写什么

.clinerules 装的和每个 AI 规则文件一样:你的技术栈和架构、代码约定和风格、要跑的命令、以及 agent 该碰和不该碰的边界。它是纯 Markdown,就是用标题和列表描述你的项目。要写一个,语法看 Markdown 怎么写

.clinerules 和其他规则文件

几乎每个 AI 编程工具都有自己这么一个文件。.clinerules 是 Cline 的:

工具 它的规则文件 出自
Cline .clinerules(文件或文件夹) 开源 VS Code 编程 agent
Cursor .cursorrules 或 .cursor/rules/*.mdc Cursor 编辑器
Claude Code CLAUDE.md Anthropic
跨工具 AGENTS.md 通用开放标准

按工具的完整地图看 我的 AI 工具读哪个规则文件;跨工具标准看 AGENTS.md、CLAUDE.md 是什么;Cursor 那个近亲看 .cursorrules 是什么

用 NoteLoom 读、改 .clinerules

.clinerules/ 文件夹很合 NoteLoom,因为一个装 Markdown 文件的文件夹正是它擅长打开的。在浏览器里挂载那个文件夹,NoteLoom 把每个 .md 渲染成干净的 reading 视图,用文件树在它们之间切换,用 source 视图改、存回本地。规则文件一多,这样很好读、也好收拾。

先说清边界:NoteLoom 没有任何 AI,也不连接 Cline 或任何编程工具。它只打开、渲染、存回本地的 Markdown 文件;Cline 听不听规则,在你和 agent 之间。

用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc,挂载你的 .clinerules/ 文件夹本身(直接选这个文件夹、别选它的父目录),读或改里面的 .md 文件。直接存回本地,不上云、不用账号。

FAQ

.clinerules 文件是什么?
给 Cline(AI 编程 agent)你项目规则的方式:关于技术栈、约定、命令的指令,让 Cline 照你想的方式干活。可以是仓库根一个 .clinerules 文件,或一个装着几个 Markdown 文件的 .clinerules/ 文件夹。
.clinerules 文件和 .clinerules/ 文件夹有什么区别?
一个目的、两种形态。单文件把所有规则放一处;.clinerules/ 文件夹让你把规则拆到几个 Markdown 文件(一个主题一个),Cline 一起加载。规则多到一个文件放不下时,文件夹更顺手。
.clinerules 该写什么?
常见的规则文件内容:技术栈和架构、代码约定、要跑的命令、以及 agent 该碰和不该碰的边界。它是 Markdown,就是用标题和列表描述你的项目。
.clinerules 和 .cursorrules、AGENTS.md 一样吗?
一个思路、不同工具。.clinerules 是 Cline 的,.cursorrules 是 Cursor 的,AGENTS.md 是很多 agent 都读的跨工具开放格式。想要一个多数工具都认的文件,AGENTS.md 更保险。
NoteLoom 能打开 .clinerules 文件夹吗?
能。.clinerules/ 文件夹装的是 Markdown 文件,而 NoteLoom 本就是挂载本地文件夹、读写里面 .md 文件的。它把每个渲染成干净视图,让你在 source 视图里改。它没有任何 AI:不会让 Cline 听规则,只帮你读写文件。
手机或 Safari 能用 NoteLoom 弄吗?
目前不行。NoteLoom 依赖浏览器的 File System Access API,当前支持 Chrome、Edge、Arc 这类 Chromium 系桌面浏览器;Firefox、Safari 和手机端暂不支持。

打开你的 .clinerules 文件夹读一遍

用 Chrome / Edge / Arc 打开 NoteLoom,挂载你的 .clinerules/ 文件夹,在干净视图里读或改里面的 Markdown 规则文件。直接存回本地,不用装软件,也不用注册账号。

打开 NoteLoom 试试