质量门记录#

G1–G4 + V 门的逐项判定,以及三道官方门禁的完整实测数据

一 · 五道质量门是什么#

门

检查什么

属于哪个阶段

不通过怎么办

G1

事实无因果词、数量达标、可追溯

R

返回 R 重写,剥离判断与推断

G2

洞察四元组完整(陈述+证据+反常识+行动)、≥3 条、维度独立

I

返回 I/F 补充

G3

模式可迁移(触发场景+核心步骤+反模式+迁移验证)

E

返回 E 提升抽象层级

G4

交付原子化(单一职责、可独立验证、有验收标准)

C/A

返回 A 重写拆分

V

对抗审查有实质内容(4 视角、≥5 条具体意见、≥2 条被采纳)

V

重新审查,禁止走过场

硬性规则:质量门不通过就不要推进到下一阶段。

理由:事实没厘清就分析原因,会得到基于错误事实的错误洞察;洞察不完整就萃取模式,会沉淀出不可复用的伪模式。


二 · G1:事实门(本次通过情况)#

判定标准#

  • 事实数量达标

  • 无「因为 / 所以 / 导致 / 错误 / 失误」等因果与判断词

  • 所有事实可追溯到来源

  • 关键数据(数字、URL、版本)完整

  • 无过度引申,不包含原文未提及的内容

本次的四道强化判据#

标准 G1 只区分「事实 / 观点」两层。本次加了四级分层,相当于把 G1 拆成四个子门:

子门

检查

本次结果

A 级门

是否有一手权威信源(官方媒体 / 政府 / 学术机构)支撑

25 个 A 级源;关键事实双源交叉

B 级门

百科类信源是否与 A 级交叉

8 个 B 级源;作品年表与获奖均交叉

C 级门

转述类信源是否标注

10 个 C 级源,全部在正文标 C 级

D 级门

推断层是否用显式措辞

全部 D 级内容用「本包推断」「可推导」等措辞

实际拦下的问题#

#

问题

层级

处置

1

「四大精神四层结构」是二手归纳

D

正文声明「该归纳出自搜狐,为该文作者所加」

2

种子计划规模数据(3 万人 / 165.66 万人次)未见官方披露

C

全部标 C 级 + 「未取得官方独立印证」警示

3

陶行知与胡适讨论语法

—

标记 D 级待核,正文不引用

4

游本昌捐图书细节

—

降级 D 级待核,正文不引用

5

「用思想填满」无一手出处

—

降级为「特定处境下的自我对话」

6

育才分组 6 组 / 7 组两种说法

—

并列保留,正文首次出现处标注

7

著述字数 400/500/600 万字三说

—

并列,正文用「400–600 万字」区间

8

欧美行访 26/28 国两说

—

并列标注

9

缝合针数 100 多针 / 120 多针

—

并列,正文取多数说法并登记

10

史家小学起始 2007 / 2008

—

并列,正文标「2007/2008 年起」

复盘结论:G1 通过率与「分歧处理纪律」直接相关。

本次的做法是:分歧不择一,全部并列并在信源表登记。这比「选一个看起来对的」慢,但它是可核查的 —— 读者能自己去信源表看每个说法的出处。


三 · G2:洞察门(本次通过情况)#

判定标准#

  • 洞察数量 ≥ 3 条

  • 每条含完整四元组:陈述 / 证据(F 编号)/ 反常识 / 行动

  • 洞察之间不重叠,维度独立

  • 有反常识性,不是正确的废话

本次各包的洞察质量抽检#

包

洞察

反常识项

判定

陶行知

最可迁移的是自我要求的强度

多数人读陶行知取「生活即教育」口号,忽略四问的对称性才使它可信

✅

陶行知

六大解放不能自授

二手叙述普遍当六个可执行动作;但裹头布是环境给你的

✅

陶行知

不可测量的不给方法论

「道德提升方法论」的 abundance 恰是它最不需要的信号

✅

游本昌

「不能爱艺术中的自己」是护栏

多数人只看到「长期积累」,忽略护栏——没有护栏的长期投入会转成地位维护

✅

游本昌

不划算规则换更值钱的

大多数人理解杠杆为放大收益;这里的杠杆是放大合法性

✅

游本昌

种子计划最可迁移

多数公益设计追求「我亲自去」的效果最大化;这个设计主动牺牲效果换可持续性

✅

胡歌

反馈延迟是能力杀手

真实理由不是「话剧更能磨演技」,是「话剧提供不可重来的反馈」

✅

胡歌

持续在场是护城河

路径 1/4 规模大几十倍,但都依赖别人;路径 2 只依赖你还愿不愿意出现

✅

胡歌

不伪造因果不消费创伤

「游本昌影响胡歌」很有传播力,但时间线不支持

✅

关联

共通的是四条机制

「努力/善良/坚持」不可拆解、不可检验、不可迁移,因此不是发现

✅

关联

只有游-胡有人际关联

「他们是一类榜样」的默认设定掩盖了层级差异

✅

洞察与金句的区分(本次的一条判断标准)#

判据:一条洞察要能回答「这个反常识是怎么来的?」

「他很努力所以他成功」——反常识项是空的,来源是循环论证。

「电视剧可剪辑 vs 环形舞台不可 NG → 反馈延迟数月 vs 当场 → 人对延迟反馈响应衰减 → 延迟是能力杀手」——反常识项有四步可回溯。


四 · G3:模式门(本次通过情况)#

判定标准#

  • 模式名称 4–8 字,好记

  • 触发场景清晰(含「适用于」与「不适用于」边界)

  • 核心做法 3–7 个具体步骤,可直接执行

  • 至少 3 个反模式,且来自实际教训

  • 有明确检验标准

  • 有 ≥1 个跨场景迁移示例

  • 多案例支撑(≥2 → L2)或标注「单案例待验证」(L1)

本次的模式成熟度判定#

模式

来源

案例数

成熟度

判定

前置性度量

三人各一

3

L2

✅ 有跨领域迁移(陶行知→胡歌的「延后结算」变体)

失败成本真实的环境

三人各一

3

L2

✅ 跨领域对应表(写作/演讲/编程/产品)

不可测量的不给方法论

三人各一

3

L2

✅ 有跨领域清单(情商/幸福感/人脉)

资产存于方法

三人各一

3

L2

✅ 有自查动作(三问)

护栏(不爱艺术中的自己)

游本昌 5 场景

5

L2

✅ 有自证链

反馈延迟归零

胡歌

1 主 + 1 对照

L1→L2

✅ 有跨领域对应表

名字授权

胡歌

1

L1

⚠️ 标注「不可复制」,不作为方法推广

三个框架

关联包

—

推断层

⚠️ 明确标注「需读者自行检验」

复盘发现的一个判断(推断):「标注为不可复制」比「勉强算作方法」更诚实。

「名字授权」这一条只有胡歌做过(因为张冕),无法被刻意复制。如果把它算作 L2 方法,会误导读者去寻找「值得用我名字纪念的人」——这是一个虚假的行动方向。

所以本包的处理是:讲清机制,但明确写「这条路径的核心不是慷慨,是你身边有没有一个值得纪念的人,而这个前提不是努力能创造的」。

反模式的提炼情况#

每个模式都配了反模式。举例:

模式

反模式

前置性度量

① 四栏全打勾、从未出现 0(指标绑太松)② 后追问一律答「有」(没理解后追问的作用)③ 只记时长不记产出

失败成本真实

① 在「永不失败」的环境中成长(自动降标准)② 追求好评而非「想改的反馈」③ 没有物质基础却硬选高成本环境

不可测量的不给方法

① 给不可测量的硬设指标(「提升情商」)② 用「量比」自评(规模数据当可持续性证明)③ 把次数当影响力(人数是结果不是行为)


五 · G4:原子化门(本次部分适用)#

判定标准#

  • 单一职责:每个交付只做一件事

  • 可独立验证:完成与否有明确验收标准

  • 可独立交付:不依赖其他未完成项

本次的应用与未应用#

场景

是否适用

说明

四个知识包

✅ 适用

每包独立可交付,独立有 index

61 个文档

✅ 适用

concepts/examples/references 分层清晰

关联包不设 examples

✅ 反向应用

主动避免与主体包冗余

单个文档的原子化

⚠️ 未使用工具

凭感觉控制篇幅(3000–6000 字符),未跑规模检查

复盘发现的可优化点(推断):

本次每个 concepts 篇幅适中,但没有用工具做规模检查。下次应该在写作前先盘点,把超长的拆开 —— 写完再拆会破坏语义完整性(这是原子化的经典反模式之一)。


六 · V 门:对抗审查(本次通过情况)#

判定标准#

  • 4 个视角全部覆盖

  • 审查意见 ≥ 5 条,每条有具体攻击点(非「写得很好」类客套话)

  • 至少采纳 2 条意见对原产出进行修正

  • F 之后 V 不可跳过

  • 修复后进行回归对抗

本次的 V 记录(摘要)#

包

视角数

具体意见数

采纳数

关键采纳项

陶行知

5

8

5

四大精神二手来源标注;每日四问 B 级信源双重声明;教诲 12 出处修正(新安小学非育才)

游本昌

5

9

5

规模数据降级;「不可复制」诚实声明;身后误读风险专章;伪事实剔除;乱码清零

胡歌

6

8

6

幸存者偏差专章 + 前置;「用思想填满」降级;感情类信息全面剔除;家庭隐私不采用;因果表述修正;乱码修复

关联

6

7

5

差异坐标升格独立篇;桥接 6 降级为弱假设;不设 examples 并写明理由;框架配可填写表格;乱码修复

本次 V 阶段的两个真实收获(推断):

收获 1:胡歌包的「幸存者偏差」必须前置。

如果只放在边界篇的第 3 节,读者读完前三篇已经被励志叙事带走了。所以这条警告同时写进了 index.md 的置顶声明和 examples 的警惕项。

收获 2:关联包必须自我审查。

前三个包的 V 是「检查产出是否可信」,关联包的 V 是「检查我的推理是否诚实」。后者更容易被跳过,因为它是自己的判断。

本次的具体做法:主动把自己唯一可能构成伪因果的推断(桥接 6:陶行知对后二者的「隐性在场」)降级为弱假设并写明无证据。

回归对抗#

项

是否执行

说明

编码乱码复验

✅

脚本扫描全目录 → total bad files: 0

门禁重跑

✅

修复 toctree 后复跑三道门禁全绿

事实编号双份集合复验

✅

四包各自核对 facts.md 与 article-source.md 编号一致


七 · 官方门禁完整实测数据#

以下是实际运行的输出,非手动等效替代。

门禁 1:UTF-8#

$ python scripts/check-utf8.py
UTF-8 检查通过: 10797 个文件均为有效 UTF-8。

门禁 2:总索引计数对账#

$ python scripts/check-bundles-index.py
bundles 总索引对账通过: 9 域 / 60 组 / 582 束,
frontmatter、计数行、节标题、分组表、toctree 五面一致。

五面对账的含义(推断):

面

检查什么

本次变更

frontmatter

total_bundles 字段

577 → 582

计数行

正文的「当前共 X 个知识包」

577 → 582

节标题

### 域名 · N 束 · M 组

sheke 48 → 53 束

分组表

每个分组的束数列

personal-growth 3 → 7

toctree

实际列出的条目

personal-growth +4 条

这五面任一不一致都会被拦。 这比「自己数一遍目录」可靠 —— 人会漏、会重复、会忘记改某处。

门禁 3:toctree 完整性#

第一次运行(拦截):

$ python scripts/check-toctrees.py
检测到 11 处 toctree 导航问题,CI gate 拦截:
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\00-common-mechanisms.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\01-evidence-bridges.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\02-difference-map.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\03-framework-problem-need-goal.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\04-framework-quality-skill-identity.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\05-framework-positive-reader.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\06-learning-path.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\concepts\index.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\log.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\references\cross-map.md
  - 未收录(不可达): doc\bundles\sheke\personal-growth\taoxingzhi-youbenchang-huge\references\index.md

根因:关联枢纽包的根 index.md 漏写 toctree 块。

修复:在根 index 末尾补上 concepts/index、references/index、log 三条。

第二次运行(通过):

$ python scripts/check-toctrees.py
toctree 检查通过: 全部 index.md 引用有效,所有内容文档均可达。

为什么这个拦截是本次最有价值的一次#

Sphinx 对不在任何 toctree 中的文档的处理是:不生成页面,且不报错。

也就是说:如果没跑这个门禁,那 11 个文件会静默地留在导航之外 —— 文件存在、能用编辑器打开,但站点上没有任何入口能到达它们。

「已完成」这个词在那一刻是主观判断;门禁把它变成了机器判定。


八 · 方法论自身的质量:三条自审#

复盘的最后一层:方法论本身有没有问题?

#

自审项

结论

1

本次的深度是否够?

⚠️ 不够。标了 depth=deep,但 V 阶段实际只做了一轮。四视角各攻一次 ≠ 多轮对抗。下次 deep 应做两轮以上,且第二轮必须换视角组合。

2

A 阶段是否被跳过?

⚠️ 是。本次在写作时直接产出原子单元,没跑文档规模盘点。下次应在 E 阶段前先做 A。

3

是否有更简单的路径?

✅ 有关键判断。本次任务表层是「写四篇教程」,但关联包与三个框架是真正的增量 —— 如果只做四篇独立教程,就只是内容搬运,不构成方法论产出。


九 · 可复制的最终检查表#

打印出来贴在显示器旁边。

□ 场景已识别(5 种之一),链路已选定,裁剪理由已记录
□ 骨架已判定(设/不设 examples),理由已写明
□ 事实四级分层完成,D 级有显式措辞
□ 伪事实已隔离并禁止正文引用
□ 事实双份登记,编号集合一致
□ 史料分歧并列保留(不静默择一)
□ 每条洞察有 F 编号 + 反常识 + 可回溯的推导链
□ 每个模式标注成熟度(L1/L2),不可复制的明确标注
□ 每个模式 ≥3 个反模式
□ 框架类产出配可填写表格
□ V 阶段四视角,≥5 条具体意见,≥2 条被采纳
□ V 阶段攻击了推断层自身
□ 编码/乱码脚本复验
□ ★ 每个包的根 index.md 都有 toctree ← 本次唯一失误
□ 三级索引五面对账
□ 三道官方门禁全绿
□ Sphinx -W 构建通过
□ 「不做什么」已记录(不设的部分要写理由)

十 · 交付后补记:全站构建暴露的链接缺陷#

这一节是交付后才发现的,正好印证了「构建不能省」。

背景#

四个包写完、三道门禁全绿后,额外跑了 OKF 全站 sphinx -W 构建(582 包,耗时 18 分钟), 结果 252 个警告。从可见输出判断警告主要来自既有包(jishu/document/myst/、wenxue/english/), 但无法确认自己的 61 个文件是否也有问题。

定向复验的做法#

全站构建太慢,改用最小验证树:只复制 personal-growth 目录 + 配一个最小 conf.py(含 mermaid 扩展), 30 秒内定位到「是我的文件还是环境问题」。

这条经验可复用:全站构建太慢时不要等它跑完——构造一棵只含新内容的最小验证树,先把自己的问题摘出来。

摘出的真实缺陷(7 处,全部已修)#

#

缺陷

根因

修法

1

cross-map.md 里放了 toctree

它是被 references/index.md 收录的文档,不应再有 toctree(重复收录)

删除该 toctree 块

2

examples/index.md 的对应列引用写成同目录

01-stage-craft.md 实际在 concepts/ 下

改为 ../concepts/01-stage-craft.md

3–6

四处 concepts/xx.md 里的跨包引用少一层

从 concepts/ 到兄弟包根需 ../../<pkg>/index.md,写成了 ../

批量改为 ../../

7

06-learning-path.md 引用 05-framework-quality-skill-identity.md

编号错了——该文件实为 04-(框架二),按顺序写成了 05-

改为 04-...

复验结果#

最小树第一次构建:约 20 个警告(多数是环境缺 mermaid / 缺兄弟包的假阳性)
修复缺陷 1-6 后:9 个
修复缺陷 7 后  :我的 61 个文件 → 0 警告
                 (剩余 5 个全部来自兄弟包 female-charm-eq / male-charm-eq /
                  how-to-live-better 的既有问题,与本次产出无关)

三道官方门禁复跑:
  UTF-8 检查通过: 10797 个文件均为有效 UTF-8。
  toctree 检查通过: 全部 index.md 引用有效,所有内容文档均可达。
  bundles 总索引对账通过: 9 域 / 60 组 / 582 束,五面一致。

这一节的三条教训#

#

教训

1

三道门禁全绿 ≠ 链接都对。门禁查 toctree 结构,不查正文里的相对链接是否指向存在的文件。

2

全站构建慢时,构造最小验证树。30 秒定位 vs 18 分钟等待。

3

编号靠手写必错。05- 写成 04- 这种错只有解析器能发现——让机器查,不要靠眼睛。

补充到总检查表(在原有 17 条之后)#

□ ★ 最小验证树复验(Sphinx -W,30 秒内定位自己的文件)
□ ★ 正文相对链接全部指向存在的文件(门禁不查这一项)

十 · 交付后补记:全站构建暴露的链接缺陷#

这一节是交付后才发现的,正好印证了「构建不能省」。

背景#

四个包写完、三道门禁全绿后,额外跑了 OKF 全站 sphinx -W 构建(582 包,耗时 18 分钟), 结果 252 个警告。从可见输出判断警告主要来自既有包(jishu/document/myst/、wenxue/english/), 但无法确认自己的 61 个文件是否也有问题。

定向复验的做法#

全站构建太慢,改用最小验证树:只复制 personal-growth 目录 + 配一个最小 conf.py(含 mermaid 扩展), 30 秒内定位到「是我的文件还是环境问题」。

这条经验可复用:全站构建太慢时不要等它跑完——构造一棵只含新内容的最小验证树,先把自己的问题摘出来。

摘出的真实缺陷(7 处,全部已修)#

#

缺陷

根因

修法

1

cross-map.md 里放了 toctree

它是被 references/index.md 收录的文档,不应再有 toctree(重复收录)

删除该 toctree 块

2

examples/index.md 的对应列引用写成同目录

01-stage-craft.md 实际在 concepts/ 下

改为 ../concepts/01-stage-craft.md

3–6

四处 concepts/xx.md 里的跨包引用少一层

从 concepts/ 到兄弟包根需 ../../<pkg>/index.md,写成了 ../

批量改为 ../../

7

06-learning-path.md 引用 05-framework-quality-skill-identity.md

编号错了——该文件实为 04-(框架二),按顺序写成了 05-

改为 04-...

复验结果#

最小树第一次构建:约 20 个警告(多数是环境缺 mermaid / 缺兄弟包的假阳性)
修复缺陷 1-6 后:9 个
修复缺陷 7 后  :我的 61 个文件 → 0 警告
                 (剩余 5 个全部来自兄弟包 female-charm-eq / male-charm-eq /
                  how-to-live-better 的既有问题,与本次产出无关)

三道官方门禁复跑:
  UTF-8 检查通过: 10797 个文件均为有效 UTF-8。
  toctree 检查通过: 全部 index.md 引用有效,所有内容文档均可达。
  bundles 总索引对账通过: 9 域 / 60 组 / 582 束,五面一致。

这一节的三条教训#

#

教训

1

三道门禁全绿 ≠ 链接都对。门禁查 toctree 结构,不查正文里的相对链接是否指向存在的文件。

2

全站构建慢时,构造最小验证树。30 秒定位 vs 18 分钟等待。

3

编号靠手写必错。05- 写成 04- 这种错只有解析器能发现——让机器查,不要靠眼睛。

补充到总检查表(在原有 17 条之后)#

□ ★ 最小验证树复验(Sphinx -W,30 秒内定位自己的文件)
□ ★ 正文相对链接全部指向存在的文件(门禁不查这一项)

上一篇:执行流水 | 返回:复盘首页