AI 编程规则文件怎么管理？
一堆 AGENTS.md、CLAUDE.md 怎么收拾清楚

为什么你会攒出一堆规则文件

不是你乱放，是这套约定天然会长出很多文件。三个原因叠在一起：

• 工具各认各的文件名：Claude Code 习惯读 CLAUDE.md，Cursor 读 .cursorrules，Copilot 读 .github/copilot-instructions.md。换个工具，就多一份。
• 一个项目一套：规则跟着项目走，你手上几个项目，就有几套。
• 临时文件混进来：AI 一次性生成的 plan.md、spec.md 也是 md，堆在一起就和常驻规则分不清了。

所以「文件多」是正常的，目标不是把它们合成一个，而是让每一份都待在该待的地方、短到读得动、不互相重复。

先认清：你手里都有哪些，各归谁管

整理之前先把账理清。下面是常见的几个，具体以你在用的那个工具的官方文档为准，这块更新很快。想细看每个文件是什么，见 AGENTS.md / CLAUDE.md 是什么。

看完这张表，你就能给自己电脑里那一堆 .md 对号入座：哪份是给哪个工具的、本该放在哪。对不上号、放错地方的，就是接下来要收拾的。

怎么把它们收拾清楚：五条够用的规矩

不用搞复杂的目录体系。守住下面五条，一堆规则文件就不会越长越乱。

核心就一句：规则文件跟着项目走、一份不重复、短到读得完。如果你想要的是「散落的 .md 笔记怎么收拾」这种更通用的整理，看 md 文件怎么整理；这篇只盯 dev 场景的规则文件。

怎么确认 AI 真读到了，别让规则文件形同虚设

很多人写了一堆规则，却不确定工具到底有没有照做。几个实在的检查点：

• 放对位置、用对文件名：工具只在特定路径、特定文件名下才会读。以官方文档为准，别凭感觉放。
• 内容要短：一两屏能读完的规则，工具更可能真用上；几百行的，容易被略过。
• 写具体、能验证的约定：「提交信息用中文」「别动那个配置文件」比泛泛的「代码要规范」有用得多，也方便你回头检查它有没有照做。
• 它是建议不是锁：规则文件是强烈建议，工具大体会参考但不保证每条都执行。关键改动自己复查一遍最稳。

说到底，「读得动」是前提——你自己都懒得读完的规则，工具也照顾不过来。所以先得有个能把这些文件快速打开、读清楚的办法。

用 NoteLoom 跨项目打开这些规则文件

不管这些文件是 AI 生成的、还是你自己写的，落到硬盘上都只是一个个本地 .md。NoteLoom 就是个在浏览器里读写本地 md 文件的编辑器，拿来打开、读清、改好这些规则文件正合适。

先说清楚边界：NoteLoom 没有任何 AI，也不和 Claude Code、Codex、Cursor 或 git 集成。它不替你整理、不生成、不总结，也不会去执行规则文件里的话，更不能让 AI「更听你的」。它只负责让你把这些文件打开、看清、改好、存回本地。

对「一堆规则文件」这件事，它有两点正好用得上：

• 多文件夹挂载：把你几个项目的文件夹都挂进来，在一个界面里逐个打开各自的 CLAUDE.md / AGENTS.md，不用在系统里来回翻目录。
• 三视图读同一个文件：

用起来大致是这样：

1. 用 Chrome、Edge 或 Arc 打开 app.noteloom.cc。
2. 把放着规则文件的本地项目文件夹挂进来（NoteLoom 必须先挂载文件夹才能读写），多个项目就挂多个。
3. 在文件树里点开某个项目的 CLAUDE.md / AGENTS.md / copilot-instructions.md。
4. 先用 reading 视图把它读清楚，要删要补就切 live 或 source。
5. 改完直接写回本地原文件，不经过账号，也不上云。

一份够用的规则文件长什么样

整理的另一半是「别写太长」。第一版能交代清楚「项目是什么、怎么跑、别碰什么」就够用了，一个够用的样子：

# CLAUDE.md

## 项目是什么
一个用 Astro 写的营销站，部署在 Cloudflare Pages。

## 怎么跑起来
- 装依赖：npm install
- 本地预览：npm run dev
- 构建：npm run build

## 写代码要守的规矩
- 用 TypeScript，不要用 any
- 组件放 src/components/，一个组件一个文件
- 提交信息用中文，一句话说清改了什么

## 不要做的事
- 不要改 src/config.ts 里的部署配置
- 不要把密钥写进代码

几个要点：

• 用大白话，别堆术语。它是说给人和 AI 都能看懂的话。
• 写具体的、容易出错的约定，这些比泛泛的原则有用得多。
• 短就行，一两屏内读完最好；太长 AI 和你自己都容易跳过。
• 想把 #、-、代码块这些符号敲对，看 Markdown 怎么写。

写的时候在 live 视图边敲边看排版就好，要写什么规矩还是你自己说了算——NoteLoom 不会替你生成，它没有 AI。

常见的坑

• 把几个项目的规则搬到一个文件夹集中放：工具就在各自项目根目录找文件，搬走了反而读不到。要集中「看」，把项目文件夹都挂进编辑器即可，别搬文件。
• 同样的话在好几份文件里各写一遍：改一处忘改另一处，规则互相打架。一个工具留一份，其余指过去。
• 常驻规则和一次性计划混在一起：把 plan.md 这种一次性的挪出去，规则文件只留长期生效的。怎么读 plan 见 Codex plan.md 怎么读。
• 越写越长直到没人读：几百行的规则等于没有。挑最关键的几条，定期回读删旧。
• 指望 NoteLoom 帮你理解或执行它：不会。NoteLoom 只打开、读、改、存这些本地文件，不连任何 AI 工具，也不跑里面的规则。