Communitygithub.com

replay-to-replica

将已获授权的现有应用、网站、设备工作流或用户演示的观察结果,转化为带有证据链接的行为规范、独立的实现交接件、可执行的验收场景以及一致性报告。用于在不复制源码、品牌或受保护资产的情况下复现产品行为;不得用于绕过访问控制、提取机密或制作未经许可的高度相似克隆。

replay-to-replica 是什么?

Replay to Replica 是一项系统化技能,旨在将用户对现有产品的授权观察,转化为一份独立、可实现的“行为合同”,并通过回放相同的用户任务来验证新实现的正确性。它要求严格遵守法律和授权边界,明确禁止复制源代码、品牌资产或绕过任何安全控制。该技能支持三种主要产出:纯行为包、实现交接包(含构建就绪任务和接口),以及经过回放一致性测试的已验证副本。整个工作流程分为六个阶段:定义范围与授权、以用户视角观察、规范化为行为合同、生成干净的实现交接、独立实现,以及最终的回放与比较。通过这种方式,用户可以高效地实现“洁净室”式的新产品开发,确保行为一致性,同时最大限度降低知识产权风险。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wangjunyu86/replay-to-replica/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

从回放到副本

将观察到的产品行为转化为可实现、独立表达的合同,然后通过回放相同的用户任务来验证新实现。优化目标为行为清晰,而非视觉或代码模仿。

边界

本技能支持授权下的黑盒观察和洁净室式交接。它本身不确立法律合规性。请尊重许可证、条款、专利、隐私和合同限制。禁止:

  • 绕过认证、支付、速率限制、加密或技术控制;
  • 访问用户无权访问的数据或功能;
  • 将源代码、反编译代码、专有资产、商标、文案、隐藏标识符或机密数据复制到实现包中;
  • 当同一人或代理看到了受保护的实现细节时,声称严格的法律洁净室隔离。

如果需要严格隔离,请分工:一个观察角色生成标准化的行为包,另一个独立的实现角色仅接收该包。

选择请求的产出

明确需要哪种结果:

  • 仅行为包 — 规范和验收场景。
  • 实现交接 — 行为包加上构建就绪的任务和接口。
  • 已验证副本 — 独立实现加上回放的一致性测试。

除非用户明确要求实现,否则不要将“分析这个产品”扩展为构建克隆。

使用以下命令初始化工作包:

python3 scripts/init_replica_pack.py <输出目录> --product "<被观察产品>" --replica "<新产品>"

阶段 1:定义范围和授权

记录:

  • 授权目标和访问方法;
  • 意图的独立产品和用户;
  • 要保留的行为;
  • 要排除的行为、品牌、数据和资产;
  • 支持的平台和测试环境;
  • 运行时交互或账户操作是否需要新的同意;
  • 一致性阈值:精确合同、功能等价或有意变更。

基于任务定义范围,而非“复制整个应用”。从最有价值的最小旅程开始。

阶段 2:作为用户观察

对于每个旅程,捕获:

  1. 起始状态和先决条件;
  2. 用户操作;
  3. 即时可观察的响应;
  4. 结果状态和持久化数据;
  5. 错误、延迟、限制和恢复路径;
  6. 证据路径和环境;
  7. 认知标签: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;
  • 未解决的推断规则已披露;
  • 新产品不包含任何复制的受保护资产或标识;
  • 用户能够在预期环境中执行核心旅程;
  • 一致性报告链接到可检查的证据。

最终报告必须陈述范围、授权边界、观察覆盖率、推断、有意差异、不匹配、未验证区域以及经过测试的具体实现工件。

相关技能