ARTICLE · 1309662
10套模板,0次调用
今天下午我浪费了一个小时。
不是写东西浪费的，是**改一个根本没人用的功能**。
起因很小。我想把公众号文章的排版弄好看点——之前发出去的文章，读者看到的全是灰白一片，标题、正文、引用全是同一个字号，明明该有的卡片、色块、分割线一样都没有。
我打开技能文档，找到“排版美化（10套模板）”那一节，写得很详细：什么 Tech Blue、Dark Geek、Knowledge Card，适用什么类型、怎么占位符替换、怎么保持微信兼容。我当时心里踏实得很——有现成模板，直接套。
然后我去改脚本。
改完我顺手 grep 了一下 `templates/`，想确认模板路径对不对。
**零命中。**
`publish_wechat.py` 和 `daily_publish.py` 这两个脚本里，一个字都没提过 `templates/`。
那一刻的感觉挺复杂的——不是生气，是那种“我居然三个月没发现”的后怕。我每天写文章、每天发出去、每天看技能文档，都觉得“排版这块有 10 套模板随时可用”。实际上那 10 个 HTML 文件就躺在磁盘上，从没被任何一行代码调用过。
01
第一个疑点
我当时的第一反应是“是不是路径写错了”。但转念一想，不对——如果是我写错了路径，grep 至少会命中一个字符串。
我让 AI 去查。它没辩解，直接去读脚本，然后给我一句话：
生产链产出是裸段落 `<p style=“line-height:1.8;margin:8px 0;”>`，没有 span leaf 包裹，粘贴到公众号编辑器后样式会大面积丢失。
我不太懂 `span leaf` 是什么，但“样式会大面积丢失”我懂——那正是我看到的效果。
02
一查就查出三个
AI 顺着这条线往下查，结果越查越多。
**第二个 bug**：我拿它写的校验器去量自己产出的正文，报错 `span leaf 包裹： 0 处 → ERROR`。文档里明明写着“模板已做微信兼容”，实际是零兼容。
**第三个 bug** 更隐蔽——是内容层面的。我对比了同一段文章改写前后的文本：
```
改写前：给爸妈买了台空气净化器
改写后：给爸妈买了台空气净化器也没啥
```
那是我自己的去 AI 味脚本干的。它会给句子结尾随机加“就好”“也行”“也没啥”，本意是加口语感，结果把陈述句改成了评价句。**发到读者眼前的东西，是被机器改坏的。**
**第四个** 是我后来拿另一个技能试中文剧本时发现的：它把“老周走过来”里的角色名识别成了“周走”，把“老钟撕开豆干”识别成了“钟撕”。原因是中文没有空格分词，它靠姓氏表硬猜。
四个 bug，跨度三个月，涵盖排版、文案、解析，全都没人发现。
03
我总结的三步
现在我写技能文档，第一句都会写“先验证，别信文档”。具体三步：
**第一步，先 grep 生产代码。** 文档说有的功能，去生产脚本里搜一遍关键词。零命中就是没有，别脑补。
**第二步，跑一次真实产物，用工具量。** 光看代码不够，得把实际产出拉出来过一遍校验器。`span leaf: 0 处` 这种数字，比“我觉得应该没问题”可靠一百倍。
**第三步，怀疑一切自动生成的东西。** 那个改坏句子的脚本、那个猜人名的解析器，都是“看起来很聪明”的自动化。越是自动的，越要拿具体例子验。
04
教室里的事也一样
我教四年级英语，同时管着教务。这套方法我其实早就在用，只是没往 AI 方向想。
我备一节课，课件做得再漂亮，学生该不会还是不会。我以前会花两小时排版一节课 PPT，后来改成一个笨办法：**先让学生做，再看他们卡在哪儿**，卡住的地方才是真正要讲的东西。课件只是用来补那几个洞的。
AI 帮我抓 bug 用的就是同一个道理——**别信你自己写的东西，去跑它。**
只不过这次跑的不是一个学生，是一段脚本。
文档是写给人看的，代码是给机器跑的。中间那道缝，藏着你三个月没发现的答案。
如果你也在用 AI 搭工作流，真的建议偶尔停一下，花十分钟 grep 一遍你的生产脚本。我今天这一天，就靠这十分钟把三个月的债一次性还清了。
「AI 干活实录」系列
这里记的都是我自己踩过的坑：文档写了不等于代码真这么跑，AI 说对了也要自己跑一遍才敢用。每周日更一篇，觉得有用就关注一下。
END
