怎么优化网站，人工经验写成脚本需求时怎样描述例外情况
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /37a01ede059f.html
📄
怎么优化网站，人工经验写成脚本需求时怎样描述例外情况
把人工经验写成脚本需求时，例外情况不能只写“遇到异常就跳过”，而要写清三件事：什么信号触发例外、例外发生时脚本该做什么、做完之后如何回到主流程。缺了任何一项，脚本执行者只能自行猜测，结果往往是把该保留的页面删掉，或把该处理的页面漏掉。下面以一份人工整理的页面清单为对象，逐步把它转成可执行的例外描述。
先找出人工经验里被省略的判断分支
人工处理页面时，很多判断是隐性的。比如运营同事说“标题太短的页面要重写”，这句话背后至少藏着四个分支：标题为空、标题只有品牌名、标题长度正常但语义重复、标题长度正常且语义完整。人工操作时靠肉眼和上下文补全了这些分支，写成脚本需求时如果只保留“太短”两个字，执行者无法判断“太短”的阈值从哪里来，也无法判断标题为空时是重写还是先补全。
实际操作是：把清单里每个页面的人工处理结果抄成两列，一列写“做了什么”，一列写“为什么这样做”。做完之后，凡是“为什么”里出现“因为”“否则”“如果”的句子，都是例外情况的候选。这个动作的结果是得到一份例外候选列表，下一步才谈怎么描述。
例外描述必须包含触发条件、处理动作和回归路径
一条完整的例外描述，结构上接近这样：当某个可观测条件成立时，执行某个动作，动作完成后回到哪一步。三个部分缺一不可。只写触发条件，脚本会停在判断上；只写处理动作，脚本会在不该触发的时候触发；只写回归路径，等于没有例外。
假设一个场景：清单里有一批页面，人工判断是“正文不足三百字且没有产品参数表的，标记为待补充”。转成脚本需求时，例外描述可以写成：
- 触发条件：正文纯文本字符数低于三百，且页面中不存在包含参数、规格、型号字样的列表结构。
- 处理动作：不直接改写，先输出到待补充清单，并记录缺失的是正文还是参数表。
- 回归路径：补充完成后重新进入字数判断，而不是直接进入发布流程。
这里的关键不是数字本身，而是每个数字都要有来源。三百字如果来自人工抽样的经验值，就要在需求里注明“该阈值来自人工抽样，后续可按实际清单调整”，避免执行者把它当成不可更改的硬标准。
用一份短清单验证例外描述是否可执行
描述写完不等于可执行。取清单里五到十个页面，按例外描述逐条走一遍，重点看两类情况：一类是触发条件成立但处理动作明显不合理，另一类是触发条件不成立但人工确实做了特殊处理。前者说明动作写错了，后者说明触发条件漏了。
这个验证动作的结果会直接改变下一步：如果十个页面里有三个都需要人工临时判断，说明例外描述还停留在原则层面，需要继续拆；如果十个页面里只有一个需要临时判断，可以先按当前描述执行，把那个页面单独记下来，作为下一轮补充的输入。验证时不要只看通过率，要看临时判断出现在哪一步，那一步就是描述最薄弱的地方。
区分“例外”和“错误”，避免把两者写进同一条需求
例外是预期内会出现的分支，错误是预期外的情况。把两者混在一起，脚本会在真正出错时继续按例外流程走，掩盖问题。比如页面返回状态码异常，这属于错误，不应该写成“遇到异常就跳过并记录”，而应该写成“停止处理该页面，输出状态码和请求地址，等待人工确认”。而页面正文为空但状态码正常，属于例外，可以按预设动作进入待补充清单。
判断方法是看这个情况在人工处理时是否反复出现。反复出现且有人工应对方式的，是例外；偶尔出现且人工也要停下来查原因的，是错误。两者的处理动作不同，回归路径也不同。
把例外描述落到页面对象上的检查顺序
回到手里的那份清单或页面，按以下顺序过一遍：先确认每个例外都有触发条件，再确认每个触发条件都能从页面本身或请求结果中观测到，然后确认处理动作不会破坏已有数据，最后确认回归路径指向的是判断步骤而不是终点。四步都过完，例外描述才算能交给执行者。
需要提醒的是，改动前后做比较时，要考虑到搜索需求本身的波动和数据采集口径的差异，不能把一次改动前后的数字变化直接当成改动效果。例外描述的价值在于让处理过程可复现、可检查，而不是保证某个固定结果。如果验证中发现临时判断仍然频繁出现，优先补充触发条件，而不是放宽处理动作。
