🚀 第 12 篇:建立项目的“宪法”:CLAUDE.md 的威力

🎯 本篇导读(核心大纲)

失控的泥石流:为什么项目越大,AI 越容易写出“屎山”代码或偏离主题?揭秘大模型致命的“上下文腐烂”效应。

极客圈的核武器:什么是 CLAUDE.md?为什么说它是给 AI 专属的“入职培训手册”与“项目宪法”?

宪法的核心要素:从架构定义、代码规范到“绝对禁止”的红线,手把手教你如何为数字员工立规矩。

降维打击的工作流:如何通过“外部记忆”和“渐进式加载”,让 AI 永远保持清醒,彻底告别反复调教的死循环。

实战落地模板:一份拿来即用的“业务宪法”模板,哪怕你不懂代码,也能用它管理复杂的自媒体或商业项目。


📍 一、 灾难重演:为什么你的 AI 总是“写着写着就疯了”?

在用 AI 辅助工作时,无论是写长篇小说、开发一套软件系统,还是做一个复杂的数据分析报告,新手最容易遭遇一种极其绝望的体验:AI 的“精神分裂”与“间歇性失忆”

让我们还原一个真实的灾难现场: 第一天,你让 AI 帮你搭建一个网站。你明确告诉它:“前端要用 React,样式用 Tailwind CSS,所有按钮必须是圆角。”一开始,它表现得像个天才,完美实现了你的需求。 第二天,你继续在同一个对话框里让它增加一个“购物车”功能。突然,它像中了邪一样,开始用 Vue 的语法写代码,引入了一堆你根本没见过的老旧样式库,甚至把你昨天刚建好的主页给覆盖报错了。你愤怒地纠正它,它滑跪道歉,但在下一轮对话中,它又把数据库的连接方式搞错了。

为什么越往后做,AI 越蠢?

这背后隐藏着大模型的一个致命弱点——上下文腐烂(Context Rot)。 当你在一个对话窗口中与 AI 进行了几十轮对话,产生了成千上万字的上下文后,大模型的“短期记忆”就会触及上限。为了继续对话,AI 编程工具或底层模型会自动去压缩历史记录,把前面的对话进行“摘要化”处理。

在这个压缩过程中,你最初定下的那些极其重要的**“设计规范、技术选型、特殊要求”**,就会像被水洗过的墨迹一样,变得模糊不清甚至完全丢失。AI 忘记了你的规矩,自然就会凭借它庞大但杂乱的预训练数据开始“自由发挥(幻觉)”。

每一次失忆,你都要回到第一步重新把规矩发一遍,反反复复,无穷无尽。你根本不是在当老板,而是在给一个“只有 7 秒记忆的巨婴”当全职保姆。

如何打破这个死循环?答案是:给你的项目建立一部强制执行的“宪法”。


💡 二、 认知升维:什么是 CLAUDE.md

在高级的 Agentic(智能体化)编程领域(如 Claude Code、Cursor 等),极客们早就找到了降维打击的解法。他们会在项目的根目录下,创建一个名为 CLAUDE.md(或 .cursorrulesagent.md)的纯文本文件。

1. 它是 AI 的“入职培训手册” 你可以把这个文件理解为这个项目的“最高宪法”或“新员工入职手册”。里面不写任何具体的代码,只写最核心的原则、规范和业务上下文

2. 强制触发的“肌肉记忆” 这个文件的神奇之处在于,当你使用 Claude Code 或其他高级工具在这个项目里唤醒 AI 时,系统会在后台强制执行一个动作:在回答你的任何问题之前,AI 必须先一字不落地阅读并加载CLAUDE.md里的内容

这就意味着,不管你们的对话进行了多少轮,不管上下文被压缩了多少次,每一次 AI 准备干活前,它都会被强制“洗脑”一遍: “我是谁?我正在做什么项目?这个项目绝对不能犯的错是什么?”

通过这种方式,AI 拥有了跨越会话的**“全局记忆(Global Context)”**。你的规矩不再是漂浮在聊天框里的口水话,而是变成了沉淀在硬盘里的数字资产。


🧠 三、 宪法里到底该写什么?(四大核心要素)

一份优秀的 CLAUDE.md 并不是把所有的需求一股脑塞进去,而是要像法律条文一样,精炼、准确、没有歧义。它通常包含以下四个核心模块:

要素一:项目全局观 (Project Context)

AI 就像一个空降的蒙眼外星人,它不知道你的商业目的。你必须在开头用 3 句话说明背景。

  • 示例:“本项目是一个面向 50 岁以上老年人的健康食谱小程序。核心理念是‘极简、大字、无广告’。所有的交互设计必须考虑到老年人视力衰退和防误触的需求。”

要素二:技术栈与架构规范 (Tech Stack & Architecture)

不要让 AI 自己去猜你要用什么工具,直接锁死它的技术边界。

  • 示例:“前端严格使用 Next.js 14(App Router)和 Tailwind CSS。后端使用 Python FastAPI。数据库使用 PostgreSQL。绝对禁止使用任何已经被废弃的旧版本 React 写法。”

要素三:绝对红线与避坑指南 (Anti-patterns & Constraints)

这是整个宪法中最值钱的部分。 消除 AI 幻觉最好的方法,就是明确告诉它“禁止做什么”。把你或 AI 之前在这个项目里踩过的坑,全部转化为“红线规则”。

  • 示例: - “禁止在处理支付接口时调用第三方 X 插件,因为它会导致内存泄漏。” - “在生成 SQL 查询时,禁止使用明文拼接,必须使用参数化查询以防止注入攻击。” - “在输出用户提示语时,严禁使用浓烈的‘AI味’词汇(如:‘综上所述’、‘值得注意的是’)。”

要素四:自定义指令与工作流 (Custom Workflow)

告诉 AI 这个项目的日常运转流程。比如代码写完后,应该用什么命令去测试和格式化。

  • 示例:“当你完成了一个新功能的开发后,你必须自主在终端运行 npm run lint 检查格式,并运行 npm run test 确保测试全绿。如果报错,请自行修复,直到没有错误为止。”

🌪️ 四、 进阶心法:“渐进式披露”与“动态挂载”

当你的项目变得非常庞大(比如一个包含几十个模块的企业级系统,或者你要写一本 20 万字的长篇小说),如果你把所有的细枝末节都写在 CLAUDE.md 里,文件可能会膨胀到几万字。

这时候,大模型又会面临“注意力被噪音稀释”的问题。高手会怎么做? 他们会使用**“渐进式披露(Progressive Disclosure)”**的哲学。

在这个模式下,根目录的 CLAUDE.md 会变得极其精简,它不再是一本厚重的大全,而变成了一个**“目录”或“路由调度中心”**。

它里面的内容会变成这样:

“你好,数字员工。以下是本项目的知识库索引:

如果你当前的任务涉及【数据库设计】,请先去读取 docs/database_schema.md

如果你的任务涉及【前端 UI 调整】,请先去读取 docs/ui_guidelines.md

如果你的任务是【编写测试】,请先去读取 docs/test_rules.md。”

奇迹发生了。当你在对话框里对 AI 说:“帮我把首页的登录按钮颜色改一下。” AI 会先快速扫一眼 CLAUDE.md,发现这是一个前端任务,然后它会**主动(按需加载)**去读取 ui_guidelines.md 里的详细设计规范,最后再动手改代码。

这种“按需挂载”的机制,保证了 AI 工作台上永远只有与当前任务最相关的干净信息。它不仅为你省下了巨额的 Token 费用,更让 AI 的智商和执行精准度得到了史诗级的提升。


🎁 五、 零基础福音:实战落地与跨界应用

很多人以为 CLAUDE.md 只有程序员才能用。大错特错!“建立系统宪法”的底层逻辑,是所有领域的超级个体都必须掌握的内功。

如果你是一个做小红书代写、公众号矩阵或商业计划书的自媒体人,你完全可以在你的知识库(如 Notion、飞书文档或 Obsidian)里,为你接手的每一个大客户建一个 Customer_Rule.md

👇 附:非代码类项目的“业务宪法”模板(直接复制使用)

# [客户 A:美妆品牌推广] 专属 AI 写作宪法

## 1. 品牌基调 (Brand Voice)
- **品牌人设**:一位 28 岁、在一线城市打拼的独立女性,闺蜜式口吻。
- **核心价值观**:不推销容貌焦虑,强调“悦己”和“松弛感”。

## 2. 绝对红线 (Anti-patterns)
- **禁用词汇**:严禁出现“绝绝子”、“家人们谁懂啊”、“天花板”等过度泛滥的网络烂梗。严禁使用“总而言之”、“首先其次”等 AI 机器味连接词 [6]。
- **排版禁忌**:段落绝不能超过 3 句话。每段之间必须留有呼吸感(空行)。

## 3. 标准操作流 (Workflow SOP)
当你接收到我的写作主题后,必须严格按照以下步骤执行,每做完一步需向我确认:
- **第一步:提供选题与情绪钩子**。先给我 3 个吸引眼球但绝不低俗的标题候选。
- **第二步:大纲设计**。列出“痛点引入 -> 场景共鸣 -> 产品软植入 -> 情绪升华”的四步框架。
- **第三步:初稿与降味**。生成初稿后,请务必启动“自我反思(Self-Reflection)”机制,检查是否违背了上述的【绝对红线】,如果违背,请自行修改后再输出终稿。

每一次帮这个客户写新文章前,先把这段“宪法”喂给你的大模型(如 Kimi、DeepSeek 或 Claude)。你会发现,那个总是抓不住调性的“人工智障”,瞬间变成了最懂客户心智的金牌文案。


🏁 结语:从“监工”到“定规矩的老板”

传统的打工者思维,是把 AI 当作一个需要你用鞭子在后面抽着、一步步教它怎么走的“苦力”。而当你学会了使用 CLAUDE.md,你就真正完成了一次身份的蜕变。

真正的 Agent Boss(智能体老板)是不干涉微观执行的。 他们把毕生的行业经验、踩过的血泪巨坑、对审美的极致追求,全部凝练成了一部不容侵犯的“项目宪法”。

规矩定下了,剩下的,就是放权给无尽的算力。让数字员工在法律的框架内去狂飙、去试错、去建设属于你的商业帝国。这就是规范驱动开发(SDD)的终极魅力。