质量门记录#
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:陶行知对后二者的「隐性在场」)降级为弱假设并写明无证据。
回归对抗#
项 |
是否执行 |
说明 |
|---|---|---|
编码乱码复验 |
✅ |
脚本扫描全目录 → |
门禁重跑 |
✅ |
修复 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 |
|
577 → 582 |
计数行 |
正文的「当前共 X 个知识包」 |
577 → 582 |
节标题 |
|
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 |
本次的深度是否够? |
⚠️ 不够。标了 |
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 |
|
它是被 |
删除该 toctree 块 |
2 |
|
|
改为 |
3–6 |
四处 |
从 |
批量改为 |
7 |
|
编号错了——该文件实为 |
改为 |
复验结果#
最小树第一次构建:约 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 |
编号靠手写必错。 |
补充到总检查表(在原有 17 条之后)#
□ ★ 最小验证树复验(Sphinx -W,30 秒内定位自己的文件)
□ ★ 正文相对链接全部指向存在的文件(门禁不查这一项)
十 · 交付后补记:全站构建暴露的链接缺陷#
这一节是交付后才发现的,正好印证了「构建不能省」。
背景#
四个包写完、三道门禁全绿后,额外跑了 OKF 全站 sphinx -W 构建(582 包,耗时 18 分钟),
结果 252 个警告。从可见输出判断警告主要来自既有包(jishu/document/myst/、wenxue/english/),
但无法确认自己的 61 个文件是否也有问题。
定向复验的做法#
全站构建太慢,改用最小验证树:只复制 personal-growth 目录 + 配一个最小 conf.py(含 mermaid 扩展),
30 秒内定位到「是我的文件还是环境问题」。
这条经验可复用:全站构建太慢时不要等它跑完——构造一棵只含新内容的最小验证树,先把自己的问题摘出来。
摘出的真实缺陷(7 处,全部已修)#
# |
缺陷 |
根因 |
修法 |
|---|---|---|---|
1 |
|
它是被 |
删除该 toctree 块 |
2 |
|
|
改为 |
3–6 |
四处 |
从 |
批量改为 |
7 |
|
编号错了——该文件实为 |
改为 |
复验结果#
最小树第一次构建:约 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 |
编号靠手写必错。 |
补充到总检查表(在原有 17 条之后)#
□ ★ 最小验证树复验(Sphinx -W,30 秒内定位自己的文件)
□ ★ 正文相对链接全部指向存在的文件(门禁不查这一项)