先写输入与输出契约
列出任务接收的数据字段、目标窗口、预期页面和最终产物，注明空值、重复值和失败记录如何处理。输入不清楚时不要开始搭建节点。
- 输入字段
- 目标窗口
- 输出与失败记录
建立可重复的手动流程
在一个测试窗口中手动完成整条任务，记录每步页面状态和耗时。遇到偶发弹窗或登录要求时，先把它列为分支。
- 单窗口基线
- 步骤耗时
- 异常页面清单
为等待设置可观察条件
优先等待明确元素、页面状态或结果出现，并设置超时。固定长时间停顿既拖慢任务，也不能处理网络波动。
- 元素或状态等待
- 合理超时
- 超时退出
显式处理分支与失败
为登录失效、页面变化、网络失败和数据缺失分别设置停止或转人工路径。未知页面不应继续执行后续点击。
- 已知分支
- 未知状态停止
- 转人工队列
日志只记录必要证据
保存任务版本、窗口代号、节点、时间和错误类型。截图与日志不得包含 Cookie、代理密码或完整账号资料。
- 任务版本
- 节点与时间
- 日志脱敏
先用少量测试数据运行
使用覆盖正常、空值和异常分支的小样本，检查每条数据的输出与退出位置。通过后再运行一个小批次，而不是直接全量。
- 正常样本
- 边界样本
- 小批次
定义上线停止阈值
规定连续失败数、错误比例、页面变化或运行时长达到何值必须停止，并指定谁判断恢复。没有停止阈值的自动化容易持续制造错误。
- 失败数量
- 错误比例
- 负责人
准备手动回滚与版本恢复
保留最后可用工作流版本、已处理数据清单和人工完成步骤。回滚时先停止新任务，再确认哪些记录已成功，避免重复执行。
- 最后可用版本
- 已处理清单
- 防止重复操作