如何建博客把人工经验写成脚本需求时怎样描述例外情况

📍 WDQWDWQD987AAAAA:176.9.65.124
📱 Mozilla/5.0 (compatible; QlyzeBot/1.0; +https://app.qlyze.io/bot)
🔗 /7df35b6ba70a.html
📄

把人工写博客的经验转成脚本需求时，例外情况不能只写“遇到异常就跳过”，而要写清楚：在什么条件下触发哪条分支、脚本能观察到什么信号、无法判断时停下来还是继续。缺少完整数据或权限时，最小可执行动作是先把例外分成“可自动判定”和“必须人工确认”两类，再分别写成不同的需求语句。

先判断例外属于哪一类，再决定描述方式

人工操作时，很多判断靠的是模糊感觉，比如“这篇看起来太薄”“这个标题不太像人写的”。脚本没有这种感觉，所以要先区分两种例外。

选择依据很直接：如果脚本能拿到一个稳定信号，就写成自动分支；如果拿不到，就写成“标记后暂停”，而不是硬编一个判断。缺少完整数据时，不要假装脚本能判断语义质量，这会把错误藏进后续流程。

假设一个建博客的脚本负责把草稿整理成发布前的结构，那么例外描述应当像下面这样，而不是“内容不好就跳过”。

例如，需求里可以写：当正文字数少于 300 字，或缺少至少两个二级小标题，或同一段落连续出现两次时，脚本不执行自动合并，改为输出一条待确认记录，记录里包含草稿标识和触发原因。这里的数字只是说明写法，实际阈值要按你的博客定位来定。

这个动作的结果会影响下一步：如果脚本输出了待确认记录，人工只需要处理这些记录，而不是重新检查全部草稿；如果脚本直接跳过，你反而不知道哪些草稿被漏掉。也就是说，例外的处理方式决定了后续工作量落在哪里。

当例外无法用客观信号判定时，需求里要写“暂停并交给人工”，同时说明人工需要看什么。例如：当脚本检测到草稿里出现引用、数据或外部来源时，不自动改写这些句子，只标记出来，由人工确认来源是否成立。

这种写法的前提是脚本没有权限访问外部来源，或者无法验证引用是否准确。此时不能推出的结论是“标记等于内容有问题”，标记只表示需要人工看一眼。实施动作可以是：脚本把这类句子单独列成一份清单，人工逐条确认后再决定是否放行。清单越具体，后续确认越快。

如果你没有完整的发布数据，也没有后台权限，仍然可以执行一个最小动作：先写一份例外清单，只覆盖你当前能观察到的信号，比如字数、小标题数量、重复段落、是否缺少结尾。对每个信号写清楚触发后脚本做什么，以及人工需要接手什么。

不能从这份清单推出的结论是：它不能证明内容质量合格，也不能证明发布后一定有效果。它只能减少明显遗漏。一次改动前后比较时，还要考虑季节、搜索需求变化和数据采集差异，不能把短期波动直接归因于脚本改动。

假设你写了一个建博客的脚本，用来检查草稿是否具备发布前的基本结构。

条件一：脚本能读取草稿的标题、正文和小标题数量。那么例外可以写成：标题为空、正文少于 300 字、二级小标题少于两个时，脚本不进入下一步，输出待确认记录。下一步人工只处理这些记录。

条件二：脚本只能读取正文，读不到标题和分类字段。那么例外就不能写成“标题不合格就暂停”，因为脚本拿不到标题。此时只能写成：正文里出现连续重复段落时标记，其余情况不判断。下一步人工需要自己检查标题和分类。

两种条件的区别不在于哪个更好，而在于脚本能观察到什么。观察不到的信号，写进需求只会制造假例外。

把例外写进需求后，先拿少量草稿试跑，重点看三件事：触发记录是否和预期一致、人工确认量是否可接受、有没有出现脚本无法判断却强行判断的情况。如果人工确认量过大，说明例外条件写得太宽；如果几乎没有触发记录，说明条件可能写得太窄，或者脚本根本没读到对应信号。

试跑结果只用于调整例外描述，不能用来承诺收录、排名或收益，也不能替代真实发布后的观察。把每次调整前后的触发记录放在一起比较时，要留意草稿来源和采集时间是否发生了变化，否则容易把数据差异误当成脚本改进的效果。