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

飞轮就是四步:干活、发现问题、补一条规则、下次不再犯;它不快,但只转不空转——每转一圈,下一圈起点更高。

📝 本节和前面几节的关系

这一节把前六节串成一条线:规则文件不是写出来的,是转出来的。

一、飞轮的四步

干活——照常做事。发现问题——它犯了错,或者你发现它本可以做得更好。 补一条规则——把这件事写成一条。下次不再犯——验证它这一条真的生效。 四步缺一不可。只补不验,等于没补——你不知道那条规则到底有没有用。

二、为什么它叫飞轮

因为轮次之间是叠加的:第二版规则包含第一版全部内容。 本节的演示模拟了五轮:每轮踩一个坑、补一条规则,五轮之后规则从零涨到五条,返工降到零。 这就是飞轮:每一圈结束,起点比上一圈高一点。

三、飞轮不快,这正是它的优点

它不快,因为每一圈都要真实踩一次坑。但它不会空转——每一圈都留下一样东西。 对比一下另一种做法:等攒够了再一次性写一份完美规则文件。那份文件永远写不出来,因为你不知道会犯什么错。 所以正确的次序是:先用着,边用边长。

四、让它转起来的三个提醒

每轮只补一条——一次补十条,你不知道哪条在起作用。 补完就验——下一个任务专门看这一条守没守住。 定期删——三个月没用上的规则说明它已经不重要,删掉,别让文件越长越钝。

五、动手 Demo:迭代飞轮——让它越用越好

下面模拟五轮,每轮踩一个坑并补一条规则。

PITFALLS = [u"改了测试目录", u"提交信息写成英文", u"临时文件留在项目里",
            u"没跑验证就交付", u"标题里用了弯引号"]
rules = []
for i, pit in enumerate(PITFALLS, 1):
    rules.append(pit)
    P(u"    第 %d 轮:踩坑【%s】 -> 补规则,累计 %d 条" % (i, pit, len(rules)))

实跑输出:

--------------------------------------------------------------------
迭代飞轮——让它越用越好
--------------------------------------------------------------------

飞轮就是四步转起来:干活、发现问题、补一条规则、下次不再犯。

下面模拟五轮,每轮踩一个坑并补一条规则:

    第 1 轮:踩坑【改了测试目录】 -> 补规则,累计 1 条
    第 2 轮:踩坑【提交信息写成英文】 -> 补规则,累计 2 条
    第 3 轮:踩坑【临时文件留在项目里】 -> 补规则,累计 3 条
    第 4 轮:踩坑【没跑验证就交付】 -> 补规则,累计 4 条
    第 5 轮:踩坑【标题里用了弯引号】 -> 补规则,累计 5 条

五轮之后,规则从 0 条涨到 5 条。

关键在于**轮次之间是叠加的**——第二版规则里包含第一版全部内容,
所以第 5 轮的返工次数已经降到 0。
飞轮不快,但它**只转不空转**:每转一圈,下一圈起点更高。

看那个累计数字:一到五,它一路往上走。轮次之间是叠加的——这正是飞轮的定义。 五轮之后返工降到零,不是工具变聪明了,是你把踩过的坑写下来了。

30 秒实验

  1. 从今天起记账:一行记【第几轮、踩了什么坑、补了什么规则】。
  2. 这周末回头看:这五行里,有哪一条其实现在规则文件里已经有了?

常见误区

  1. 一次补十条规则。一次补一条,你才知道是哪条在起作用。
  2. 只补不验。没有验证的规则等于没写——你不知道它守没守住。
  3. 只加不删。三个月后的规则文件会长到没人愿意读,也会稀释真正要紧的那几条。
自测三问(点开对答案) 1. 飞轮的四步是什么? —— 干活、发现问题、补一条规则、验证下次不再犯。 2. 为什么叫飞轮? —— 轮次之间叠加:第二版包含第一版全部内容,每一圈起点更高。 3. 为什么要定期删? —— 三个月没用上的规则已不重要,删掉才不会稀释要紧的那几条。

相关笔记