波仔
🧡 第五章 CLAUDE.md：给AI一张地图
📄 一句话概括

一份够用的规则文件只有四块：技术栈、验证方式、红线、风格——它短，但它写的全是它猜不到的。

📝 本节和前面几节的关系

这一节给一个可以直接抄的样本。上一节讲了怎么分层，这一节看单份文件该长什么样。

一、看这份示例的结构

技术栈：用哪门语言、脚本放哪、输出什么风格——三行就够。 验证方式：改完跑什么、什么算通过——这一块是回报最高的，它直接决定第 2.8 节说的【做完不对】会不会发生。 红线：不许删什么、不许改什么、碰之前先问什么。 风格：一两句你真正在意的排版或写作用的规矩。

二、它的三个特点

短：本节那份示例只有二十来行。 全：每一行都在改变它的行为，没有一行是给它阅读的。 可执行：每一条都能被一次任务验证——它遵守了，或者没遵守。

三、怎么改成你自己那份

别照抄内容，照抄结构：四块标题不变，每一块里替换成你项目的事实。 改完立刻验证：给它一个真实任务，看它有没有自动遵守那几条。 它没遵守哪一条，就把那一条改得更具体——规则是被实测磨出来的。

四、一个容易忽略的细节

规则里写具体的名字：写【临时产物只写脚本目录，交付后删】，不要写【注意清理临时文件】。 前者它知道往哪放，后者它得自己判断放哪——而它判断的正是最不该出错的地方。

五、动手 Demo：一份【短而全】的示例

下面真写一份示例文件，看看够用的规则文件到底多长。

sample = [u"# 项目说明", u"", u"## 技术栈",
          u"- Python 3.13，脚本放在 scripts/", u"", u"## 验证方式",
          u"- 改完必须跑 _demos.py，全绿才算完", u"- 临时产物只写脚本目录，交付后删",
          u"", u"## 红线", u"- 不删任何文件（要删先问）"]
io.open(path, "w", encoding="utf-8").write(u"\n".join(sample) + u"\n")

实跑输出：

--------------------------------------------------------------------
一份【短而全】的示例
--------------------------------------------------------------------

下面真写一份示例文件，看看一份够用的规则文件到底多长：

生成示例：18 行，410 字节

    技术栈
    验证方式
    红线
    风格

四块：技术栈、验证方式、红线、风格——**这就是全部**。
它短，但它写的东西全是【它猜不到】的。这就是护栏型规则的正确尺寸。

输出里那份示例只有二十来行，四个小节：技术栈、验证方式、红线、风格——这就是全部。 注意红线那一条的写法：【临时产物只写脚本目录，交付后删】——具体到位置，它才不会自己判断。

30 秒实验

  1. 照着四块结构，把你项目的事实填进去——先写五条，跑一周再补。
  2. 写完拿一条真实任务去验：它有没有自动遵守？哪条没遵守，就把哪条改具体。

常见误区

  1. 照抄示例的内容。照抄结构，替换事实——内容不同，抄了也没用。
  2. 写【注意清理临时文件】这类模糊话。规则要具体到位置和动作，它才知道怎么做。
自测三问（点开对答案） 1. 一份够用的规则文件有哪四块？ —— 技术栈、验证方式、红线、风格。 2. 回报最高的是哪一块？ —— 验证方式——它直接决定【做完不对】会不会发生。 3. 好规则和模糊规则的区别是什么？ —— 好规则具体到位置和动作（如【临时产物只写脚本目录】），模糊规则要它自己判断。

相关笔记