AI 规则文件过长？盲目删除致全库断链

AI 规则文档长达 861 行，在 Cursor、Claude Code 中每次对话均需加载——AI 建议直接删除重复内容，结果导致仓库链接全部失效。制定 AI 规则切勿重蹈此覆辙。

内容概要：AI 规则文件过长如何精简

问题核心：盲目删除导致「详见某节」失效

解决方案：先迁移 → 再删除 → 修正链接（AI 编程通用）

全文约 1100 字 · 3 分钟读完 · 文末附可复用提示语

分享一个我亲身踩过的坑：AI 规则文件过长该如何处理？我在为 AI 制定规范时，文件累积至 861 行，试图精简却险些搞乱整个项目。

当你使用 Cursor 或 Claude Code 进行 AI 编程、编写代码时——关于 ai 写代码用什么工具、ai 编程工具怎么选是另一话题——这里仅强调：通常都会有一份「每次新对话必读」的规范。这并非聊天中的临时提示词，而是写入仓库、长期生效的规则。

Cursor 规则（Cursor rules）目前多位于 .cursor/rules 目录——许多人搜索 cursor 规则模板、cursor 项目规则，复制粘贴后堆积成一个大文件；老项目根目录可能还存在 .cursorrules。

Claude Code 方面则查看 CLAUDE.md（claude.md 文件存放位置？项目根目录）和 .claude/rules，即 claude code 规则文件。网上 claude.md 模板众多，搜索 claude.md 怎么写容易全盘照搬——导致文件更长。

项目要求、流程步骤全部塞入其中。文件既长又慢，AI 还常跳过中间段落。

与其他地方重复：后续的小工具、说明文档中已阐述的步骤，这份 AI 规则再次复制一遍。

我忍无可忍，想缩减篇幅。询问 AI，它回答：直接删除重复部分即可，很简单。

我照做了。删除后才发现傻眼——别处到处标注「详见第 4.2 节」「参考第 7.1 节」。章节没了，链接全断。有的直接报错，有的更隐蔽：悄悄跳过，你甚至不知道哪里出了问题。

后来才明白：怕的不是字数多，而是你删除此处，别处仍指向此处。你先删除，中间过渡期整个项目就会对不上号。

许多人搜索「Cursor 规则怎么写」，写到后面其实都撞同一堵墙：规则文件太长怎么办。别一上来就删——这也是 AI 规则制定中最容易被忽视的：

第一步，先迁移。只有这份文件中独有、别处没有的内容，先挪到一份可单独查看的说明文档里——例如「哪种文件改动需触发」「仅记录改动部分」。迁移稳妥后，再动手删除。

第二步，再删除。与别处重复的大段内容删掉，保留两三句摘要，并加一句「详细内容见某某文件」。将 861 行压缩至两百行左右——社区常建议单文件不要堆积过多行数，可按模块拆分为多个规则文件。这份「每次必读」的文件，只负责一件事：告诉 AI 去哪里查看细节。

第三步，修正链接。全文搜索旧的「第几节」，将指向更新。修改完成后重新运行，确认无遗漏。

按此步骤操作，无论进行到哪一步，都不会导致仓库链接全部断裂。Cursor、Claude Code 中的长规则文档，均可如此精简——工具虽异，痛点相同。

如果你已在构建 AI 元规则（修改规则本身也需立规矩），更要谨慎：删除一段 AI 规则，可能连带破坏「修改规则的权限门禁」。系列第 5 篇曾探讨此点，本篇补充的是规则文件精简如何安全执行。

还有一个小疏忽：后来新增了一条「前后端说明需一致」，自检清单仍沿用旧四项，新条目等于未被检查。规则增加了，检查项也需同步更新，否则白写。

我只记住两点：先迁移，再删除；每次必读的那份文档不要写满细节，只负责指引路径。

顺便澄清几个常被混淆的搜索：ai 写代码提示词、提示词模板有哪些——那是单次对话中的表述；AI 规则、claude code 规则文件、cursor 项目规则是写入项目的长期规范，两者不同。本篇仅讨论后者过长如何精简。

为 AI 立规矩，最怕一删导致全库断链。顺序正确，中途停止也不留隐患。

同系列延伸阅读（本篇独立） · 第 5 篇《让 AI 自己维护规则文档，靠谱吗》（AI 元规则） · 第 6 篇《阶段一重建实录》 · 第 8 篇《AI 说修改会话主题，侧边栏却还是英文》 · 第 9 篇《AI 说规则评审通过，七项清单却一项没审》 ·本篇为第 10 篇

💬 你删除 AI 规矩时断过链吗？

Cursor、Claude Code 皆可，欢迎评论区交流，描述最具体的，我将整理进下一篇。

👍 点赞 · ⭐ 收藏 · 🔁 转发 —— 转给仍在撰写 Cursor / Claude Code 长规则的同行

「指挥 AI 干活」系列 · 点关注，踩坑实录一篇不漏

#AI 规则#Cursor 规则#CLAUDE.md #AI 编程#AI 写代码#提示词#AI 规则制定#踩坑