用途:在接触任何远程 Runtime 或 Adobe 产品调用之前,为 Adobe 适配器建立可重复的本地开发循环,用合成契约与离线夹具提前验证,产出可评审的工件和证据,避免产生真实副作用。
主要能力:梳理适配器、SDK 锁定版本、App Builder 配置、夹具与本地模式假设;依据当前官方文档定义类型化的请求、响应、异步状态、错误、限流与脱敏契约;为成功、新增字段、畸形数据、401/403、429、5xx 及完成状态不明确等场景创建合成夹具;在禁用网络、启用密钥金丝雀的条件下运行单元与契约测试;记录本地与远程模式差异,清理远程测试工件,仅保留脱敏后的确定性夹具。
使用方式:先用 Read、Glob、Grep 检查文档、配置、代码与夹具,再用 Write、Edit 仅修改已批准的仓库工件。若使用 App Builder,需分别验证 aio app dev(本地运行 action,缺少激活记录及部分 Runtime 专属存储能力)与 aio app run(远程 Runtime action 配本地 UI)两条路径。.env 与 .aio 不得纳入版本控制,配置值应显式传入 action,而非假设部署后的 Runtime 存在本地环境变量。
适用场景:实现或调试 Adobe 适配器、需要在不触发真实调用的情况下验证契约与错误处理时。
限制:技能调用本身不授权网络访问、凭据使用、Adobe 内容、同意、上传、生成、花费、部署、注册变更、重放、取消或删除;远程 Runtime 或 Adobe API 调用需沙箱所有者批准,上传、生成、写入或删除需另行批准。夹具中出现生产主机名、组织、凭据或资产即应失败;不得将签名 URL 或文档/图片字节快照进源码控制;本地不支持的 State 或 Files 行为在远程测试前应视为未知。执行前须重新核对带日期的 Adobe 一手资料,观察到的租户或产品行为仅属环境特定证据,不构成通用保证。