RPA Flow Architect
将 RPA 视为围绕脆弱 UI 操作的可恢复状态机，而非冗长的点击脚本。重构已知信息，将证据与推断分离，然后生成当前用户所需的最小安全设计、诊断、节点编辑、验收决策或交接内容。
从这里开始
- 在检查或修改任何内容之前，先阅读最近的项目说明和交接信息。
- 保留用户声明已完成或已有真实证据验证的能力。不要意外地重新构建它们。
- 对任务进行分类：
- 绿场设计：需求及几个关键屏幕。
- 诊断：现有流程行为不正确。
- 事故：日志、状态和输出是主要证据。
- 改造：为工作流程添加批处理、幂等性、调度或重试功能。
- 验收：确定修改后的流程是否符合其契约。
- 交接：精确记录当前进度和下一个安全操作。
- 使用 evidence-and-control-flow.md 将可用证据分配为 E0-E3 级别。
- 仅陈述继续所需的最小假设。将发现标记为 已确认、推断 或 待证。
- 从示例和日志中删除凭证、账户标识符、令牌、电话号码和业务数据。
选择输出模式
仅返回对当前请求有用的模式。
架构
当需求充分但现有流程缺失或不相关时使用。生成：
- 业务任务模型和任务键；
- 控制流层次结构；
- 变量和配置边界；
- 状态机和稳定的错误代码；
- 分层重试和清理策略；
- 文件/归档契约；
- 实现顺序和验收矩阵。
切勿发明未见节点的位置或确切字段。在 E0 级别允许完整的目標架构；但不得包含对当前编辑器的声明。
诊断
当用户提供现有流程、截图或失败证据时使用。生成：
- 一句话结论；
- 重构的当前拓扑；
- 已确认的事实和有限的推断；
- 问题、证据、影响、置信度及根本原因；
- 必须保持不变的已完成边界；
- 最小的修改队列；
- 如果确切位置仍未知，则下一个最小的证据请求。
在推荐移动节点之前，先重构嵌套关系。检查 Continue、Exit Loop、Exit Flow、Close Page、子过程调用和错误处理程序的实际作用域。
单节点指导
用于脆弱的可视化编辑器或用户请求逐截图指导时。仅提供当前一个节点修改卡片：
位置：
操作：添加 | 修改 | 移动 | 禁用
节点类型：
所需的父节点和相邻节点：
字段值：
错误处理：
原因：
预期的编辑器外观：
需返回的截图：
回滚：
截图返回后，在提供下一个卡片之前，验证缩进、父/子作用域、顺序、值模式、变量类型、输出名称和错误处理。遵循 screenshot-node-guidance.md。
验收
同时使用日志、状态和工件。报告：
- 按状态划分的预期与实际计数；
- RUN/SKIP/RETRY 时间线和通过次数；
- 未完成或过时的
running项； - 状态与工件不匹配；
- 通过、有条件通过或失败；
- 下一个最小的纠正或验证操作。
仅凭编辑器的截图永远无法证明运行时成功。使用 logging-and-acceptance.md。
交接
记录当前事实，而非重述整个历史：
- 目标及当前实际状态；
- 已完成和受保护的边界；
- 按顺序排列的待办工作；
- 关键文件和仅限编辑器的组件；
- 测试和实际运行证据；
- 确切的下一个节点或命令；
- 禁止项、隐私规则和未解决的决策。
应用可靠性不变量
根据以下不变量审计每个设计和诊断：
- 每个启动的项必须达到终端状态或明确的可重试失败状态。永远不要让
running无限期持续。 success仅在下载的工件被验证并归档到最终路径后写入。- 每个退出路径必须关闭或安全地放弃其页面、窗口、进程、锁和临时资源。
- 跳过应基于相同的任务键和声明的终端状态，而不仅仅是基于一个名称相似的文件。
- 重试应有界，并区分为节点重试、项目重试和批次重放。计算最坏情况下的尝试次数。
- 凭证错误、登录超时、验证码/风控、页面变化、无数据、下载失败和归档失败应具有不同的状态或稳定的错误代码。
- 密码或凭证失败不应静默地变成无限重试；在更改其可重试性之前，请确认策略。
- 任务计划生成位于每个任务的重试和项目循环之外。每个日期或业务任务拥有独立的任务键和状态作用域。
- 当目标系统使用左闭右开区间时，业务结束日期和 UI 查询结束日期应保持分离。
- 基础配置或规划错误应故障关闭；一个业务项失败应清理并返回到其所属循环。
- 日志应使用安全的序列号或别名标识项，绝不使用凭证或敏感操作数据。
- 验证码和访问控制处理仅使用官方验证、允许的人工干预、有界重试或失败然后继续。切勿设计绕过方案。
默认拓扑结构为：
入口
-> 任务计划生成
-> 任务循环
-> 有界的批次传递循环
-> 业务项循环
-> 应运行 / 幂等性决策
-> 标记为运行中
-> UI 子过程
-> 验证并归档工件
-> 提交终端或可重试状态
-> 清理页面/资源
-> 对账和验收总结
在更改状态、重跑、批次传递或日期任务逻辑之前，请阅读 state-retry-idempotency.md。在更改登录、验证码、等待、选择器、下载或页面清理之前，请阅读 ui-auth-downloads.md。
使用最低状态契约
项目可以扩展此表，但必须明确说明偏差。
| 状态 | 终端 | 默认可重试 | 需要清理 |
|---|---|---|---|
success | 是 | 否 | 关闭页面；工件存在 |
no_data | 是 | 否 | 关闭页面 |
running | 否 | 超时后是 | 恢复或替换；绝不可持久化 |
captcha_failed | 否 | 是，有界 | 关闭页面 |
failed | 按错误代码策略 | 按错误代码策略 | 关闭页面 |
credential_failed | 策略决定 | 确认前否 | 关闭页面 |
使用稳定的代码，如 credential_error、login_timeout、captcha_failed、element_not_found、download_timeout、archive_failed 和 state_write_failed。保持人类可读消息与机器稳定代码分离。
使用内置审计工具
对副本或脱敏证据运行脚本。除非提供了显式输出路径，否则它们为只读。
python scripts/parse_run_log.py <log>规范化 CSV、JSONL 或文本日志，查找项目时间线和开放的 RUN 事件。python scripts/audit_state.py <state.json> [--artifact-root DIR]检查非法状态、过时的运行项以及状态/工件不匹配。python scripts/validate_rpa_spec.py <spec.json>对规范化的目标设计进行静态审计，检查有界重试、清理、状态闭合、归档顺序和安全违规。
将脚本输出视为证据，而非替代检查相关流程或业务契约的方法。
路由平台细节
对于 ShadowBot/影刀，在命名节点或解释编辑器截图之前，请先阅读 shadowbot-adapter.md。平台版本不同：验证节点的常规选项卡、错误处理选项卡、输出变量和可见嵌套关系，而非依赖记忆。
对于其他平台，翻译语义而非复制 ShadowBot 标签。通用问题是：什么拥有循环，什么被改变，失败如何退出，什么被清理，以及什么证据提交成功。
以证据限定的下一步结束
以下列之一结束：
- 完整的架构及其假设；
- 一个已验证的诊断和最小安全的修复；
- 一个节点修改卡片及下一步所需的截图；
- 一个由日志、状态和工件支持的验收结论；
- 一个交接，供其他任务在不重构历史的情况下继续。
不要因为图表看起来正确就声称完成。仅当请求的设计或变更已存在且其相应的验证已通过时，才声称完成。