从回放到副本
将观察到的产品行为转化为可实现、独立表达的合同,然后通过回放相同的用户任务来验证新实现。优化目标为行为清晰,而非视觉或代码模仿。
边界
本技能支持授权下的黑盒观察和洁净室式交接。它本身不确立法律合规性。请尊重许可证、条款、专利、隐私和合同限制。禁止:
- 绕过认证、支付、速率限制、加密或技术控制;
- 访问用户无权访问的数据或功能;
- 将源代码、反编译代码、专有资产、商标、文案、隐藏标识符或机密数据复制到实现包中;
- 当同一人或代理看到了受保护的实现细节时,声称严格的法律洁净室隔离。
如果需要严格隔离,请分工:一个观察角色生成标准化的行为包,另一个独立的实现角色仅接收该包。
选择请求的产出
明确需要哪种结果:
- 仅行为包 — 规范和验收场景。
- 实现交接 — 行为包加上构建就绪的任务和接口。
- 已验证副本 — 独立实现加上回放的一致性测试。
除非用户明确要求实现,否则不要将“分析这个产品”扩展为构建克隆。
使用以下命令初始化工作包:
python3 scripts/init_replica_pack.py <输出目录> --product "<被观察产品>" --replica "<新产品>"
阶段 1:定义范围和授权
记录:
- 授权目标和访问方法;
- 意图的独立产品和用户;
- 要保留的行为;
- 要排除的行为、品牌、数据和资产;
- 支持的平台和测试环境;
- 运行时交互或账户操作是否需要新的同意;
- 一致性阈值:精确合同、功能等价或有意变更。
基于任务定义范围,而非“复制整个应用”。从最有价值的最小旅程开始。
阶段 2:作为用户观察
对于每个旅程,捕获:
- 起始状态和先决条件;
- 用户操作;
- 即时可观察的响应;
- 结果状态和持久化数据;
- 错误、延迟、限制和恢复路径;
- 证据路径和环境;
- 认知标签:
observed(观察到)、derived(推导)或inferred(推断)。
在状态可能影响行为的运行之间重置目标。对于可变或时延敏感的行为,重复测试以确定范围,而不是将一次样本视为规则。
观察证据可以包括录音、截图、无障碍树、公共网络行为、导出的文件、用户可见日志和文档化的 API。仅在授权范围内使用可用的检查工具。对于行为合同而言,内部实现细节并非必要。
在编写行为包时,阅读 references/observation-and-spec.md。
阶段 3:规范化为行为合同
独立于原始界面和措辞描述行为。合同应定义:
- 角色和权限;
- 实体、标识符和关系;
- 状态和有效转换;
- 动作、输入、输出、副作用和不变量;
- 验证和失败行为;
- 可见的持久化、排序、时序和并发规则;
- 外部集成边界;
- 可访问性和平台期望;
- 有意差异。
每个重要规则都需要证据引用或显式的推断标签。冲突的观察结果保持未解决状态直到被测试;不要默默选择便利的解释。
阶段 4:生成干净的实现交接
实现交接可能包含:
behavior-spec.yaml
state-model.md
data-contracts.md
acceptance-scenarios.md
implementation-handoff.md
source-observations.csv
为新产品重写名称、文本、视觉标识和领域示例。排除原始资产和内部标识符。指定接口和结果,而非假定的源架构。
在将包交给实现代理之前,阅读 references/clean-room-handoff.md。
阶段 5:独立实现
从新产品的约束中选择技术,而不是基于对原始技术栈的猜测。允许不同的架构、算法、视觉设计和数据结构,但要保留行为合同。
对于有意的差异,维护一个实现决策日志。不要仅仅为了让一个失败的实现看起来符合规范而修改行为规范;只有在新的观察证明规范错误或用户批准产品变更时才更新规范。
阶段 6:回放与比较
在实际可行的情况下,将验收场景转化为可执行的测试。针对原始产品和副本运行相同的规范化操作,然后比较用户可观察的结果。
对每个场景进行分类:
match(匹配)— 所有必需的可观察内容在声明的容差内一致;acceptable-difference(可接受差异)— 有意不同且已获批准/记录;mismatch(不匹配)— 与行为合同矛盾;unverified(未验证)— 无法在任一方执行或证据不足。
对于结构化的事件轨迹,使用:
python3 scripts/compare_traces.py original.json replica.json --output parity-report.md
在设计规范化、容差或发布门控时,阅读 references/parity-testing.md。
完成门控
除非满足以下条件,否则不得将副本标记为完成:
- 每个阻止发布的场景均为
match或已批准的acceptable-difference; - 未解决的推断规则已披露;
- 新产品不包含任何复制的受保护资产或标识;
- 用户能够在预期环境中执行核心旅程;
- 一致性报告链接到可检查的证据。
最终报告必须陈述范围、授权边界、观察覆盖率、推断、有意差异、不匹配、未验证区域以及经过测试的具体实现工件。