结论是:如果讲解的目标是让非技术同事能判断“什么时候不该照做”,那就要把限制条件放在结论前面,而不是附在最后。只讲动作、不讲适用边界,对方往往会把它当成通用规则;一旦场景变化,执行结果就会偏离预期。更稳妥的做法是采用“条件—动作—反例”的顺序,先说明前提,再给操作,最后指出一个会让前提失效的情况。
并非所有讲解都需要完整保留限制。如果对方只是临时执行一次、由你复核结果,那么省略边界通常不会造成大问题。但如果对方要独立判断、跨项目复用,或者需要向其他人转述,限制条件就必须保留,否则信息会在传递中丢失。
一个简单的判断办法是问自己:如果对方换一个前提还照做,会不会得到错误结论?如果会,就属于必须保留限制的情况。此时讲解的重点不是“怎么做”,而是“在什么条件下才这么做”。
很多人习惯先说做法,最后补一句“注意这只适用于某某情况”。问题在于,非技术同事往往记住的是前面的动作,末尾的补充容易被忽略。更有效的顺序是:
这样对方接收到的是一组带边界的判断,而不是一条孤立指令。你可以把限制写成一句话,例如“这个做法只在内容需要被外部发现时成立”,让对方先建立场景感。
假设你告诉同事“给重要页面加内链有助于被发现”。这句话本身没有错,但如果对方把它理解成“所有页面都要加大量内链”,就可能出现另一种结果:页面之间互相指向,用户和爬虫都难以判断哪个是重点。
这个反例说明,限制条件不是附加说明,而是结论的一部分。缺少限制时,动作会被过度使用;保留限制后,对方能判断“内链应该指向需要被优先发现的内容,而不是平均分配”。
再比如,你告诉对方“提交站点地图可以帮助发现页面”。如果对方以为提交后所有页面都会被处理,就会忽略“站点地图只列出你希望被发现的地址,不保证每个地址都会被采用”这一层限制。把这句话提前,对方就不会把提交动作当成结果保证。
“注意适用条件”这类提醒太笼统,非技术同事很难据此判断。更实用的做法是把限制写成可检查的表述:
这些表述的共同点是:对方能根据当前场景判断是否满足条件,而不是依赖你的临场解释。你可以在讲解后请对方复述一次限制条件,如果复述中只剩动作、没有前提,就说明限制没有被保留下来。
讲完之后,不要只问“听懂了吗”,而是请对方用自己的话说出“这个做法在什么情况下不适用”。如果对方能说出反例,说明限制已经进入他的判断框架;如果只能重复动作,就需要重新调整讲解顺序。
这个动作的结果会直接影响下一步:能复述限制,就可以让对方独立执行;不能复述,就先把限制写成一句话再讲一遍,而不是继续补充更多操作细节。限制条件保留住了,讲解才算真正完成。