Community编程与开发github.com

Replicate / 复现

通过系统的参考审查、实现和度量比较,复现设计、界面、应用、网站和服务工作流。当用户明确要求复现参考、忠实匹配设计或恢复早期实现遗漏的细节时使用。

复现 是什么?

Replicate 技能是一种以证据驱动的实现循环,旨在确保高保真度。它指导 AI 代理从用户提供的参考(如截图、设计文件或现有实现)开始,进行系统化的审查、实施、对比和校正。该技能强调检查细节而非简化,例如布局、排版、表面效果、状态、行为和动画等。支持多种平台和工具,包括设计文件(通过设计集成)、移动应用(通过设备工具)、网站(通过浏览器工具)、截图和性能分析。其核心原则是:发现并记录差异,优先修复结构性差异,然后处理排版和表面细节,最后优化动画和交互。最终输出应包含完整的实现和验证证据,区分已知的故意差异与缺陷,并报告测试范围与剩余差异。该技能特别适合需要精确还原参考设计或修复已有实现保真度不足的任务。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/janrtvld/skills/tree/HEAD/replicate

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

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

文档

复现 是做什么的?

使保真度成为证据驱动的实现循环。检查参考,建立细节清单,实现,对比,修正并验证。令人信服的第一印象不代表完成:保留那些使参考具有独特性的细微关系和交互行为。

从用户的参考开始

  1. 从对话中推断目标、范围、平台和意图差异。此技能适用于截图、设计文件、组件、现有实现、应用、网站或服务。当用户提供的是静态设计时,不要要求交互原件。
  2. 在编码前实际检查参考。优先使用用户指定的来源:使用已安装的软件观察行为,使用设计文件获取明确的设计规格,使用全分辨率图像获取渲染外观。当来源不一致时,记录差异,并按照用户声明的优先级应用,而不是暗中混合。
  3. 检查现有实现和项目指令。保留工作功能以及用户所做的更改。如果任务是保真度修正,则修复现有设计,而不是发明新的方向。
  4. 只询问阻碍有意义进展的缺失信息。如果无法获取原件,则根据现有证据继续,并说明哪些内容无法验证。绝不捏造观察结果。
  5. 确立一组有边界的流程或状态和验收标准。不要将“复现”解释为授权购买、发布、联系他人、复制凭据或更改无关的服务数据。

检查后再简化

使用 evidence-template.md 创建简洁的参考清单。对于小型组件,这可以是几行;不要将小编辑变成大型文档项目。

先检查整个参考,然后检查各个区域。分别记录观察到的事实、测量值、估计值和未知项。不要因为某些不寻常的细节更容易实现,就用常见的默认值替换它们。

检查相关的细节:

  • 布局:对齐、包含、网格、外边距、内边距、间距、比例、分层、裁剪、安全区域、固定/粘性元素。
  • 排版:字体族、字重、字号、行高、字间距、基线、换行、截断、对齐。文本长度和真实内容也属于布局的一部分。
  • 表面:采样颜色、渐变、透明度、材质、边框、圆角处理、阴影、艺术作品裁剪、图标形状/粗细、光学对齐。
  • 状态:选中、聚焦、按下、加载、空状态、错误、禁用、展开、滚动、键盘可见;在范围内时还包括浅色/深色或响应式变体。
  • 行为:点击区域、导航、返回行为、状态保持、搜索范围、菜单、滚动、过度滚动、擦洗(scrubbing,如进度条拖拽)以及中断的手势。
  • 动效:触发器、延迟、持续时间、缓动/弹簧、行程、过冲、淡入淡出、缩放、锚定、中断以及恢复静止。
  • 服务工作流:输入/输出契约、排序、持久化、重试、错误、延迟以及用户可见的副作用。仅视觉相似不能复现服务。

对于静态参考,首先匹配可见的外观。将未显示的交互和响应式行为标记为推断;选择合理的交互行为,但不要声称是观察到的。对于交互式参考,探索完整的过渡过程,而不仅仅是终点。在相关情况下,包括快速重复输入以及部分/取消的手势。

为证据选择合适的工具

使用可用的工具,而不是假设的工具名称或能力。在使用工具前,阅读适用的工具/技能说明。

  • 设计文件:使用相关的设计集成来检查节点、样式、资源和约束,以及渲染预览。尽可能导出实际授权的资源,而不是近似替代。
  • 应用:使用 Argent/设备工具进行操作、截图、无障碍框架和可重复的流程。默认使用连接的物理 USB 手机,然后再考虑模拟器。必要时应用平台设置/交互技能。
  • 网站:使用可用的浏览器工具进行截图、视口状态、交互和布局检查。测试相关的响应式宽度和输入模式。
  • 截图:以全分辨率检查并裁剪区域进行分析。在已知设备缩放比例时,以逻辑单位进行测量;不要混淆截图像素与布局点。
  • 动效:使用支持的录制工具捕获视频,并检查帧/接触表。测量位置随时间的变化,包括最终的稳定帧。使用录制品研究动效,而不是用来声称其无法确定的显示帧率。
  • 性能:对于原生应用,使用原生性能分析器/Instruments;对于 Web 应用,使用浏览器性能工具。阅读相关的性能分析技能。动画/UI 抛光技能可以补充参考证据;但它们的一般偏好不应覆盖请求的设计。
  • 服务:使用文档化的 API、可用的连接器和受控的测试数据来比较可观察的契约。避免破坏性探测和不必要的付费请求。

在测量能解决不确定性时,使用小型的测量脚本。优先使用可重复的采样,而不是猜测颜色、字体、间距或弹簧参数。当现有工具已足够时,不要为一个小型比较安装大型工具链。

实现一个完整的切片

  1. 在扩展之前,先复现一个完整的代表性流程或组件,并使用真实的内容。选择一个能锻炼重要布局和状态转换的流程。
  2. 将共享的测量值连贯地编码。保持组件标识、导航状态和布局在转换过程中稳定。
  3. 在匹配参考的情况下,使用原生/平台机制。只有通过观察或测试证明存在不匹配时,才使用更底层的实现。不要仅仅因为看起来原生,就假设默认的 sheet、菜单或弹簧是匹配的。
  4. 保留文本、资源、顺序和独特的视觉细节。除非被要求,否则不要添加渐变、装饰、占位章节、文案更改或参考中没有的“改进”。
  5. 在匹配外观的同时,保持功能行为的正确性。加载、预处理或动画不应不必要地阻塞某个已经可以执行的操作。

对比并修正

在每个有意义的切片之后运行此循环:

  1. 将参考和实现置于可比较的状态:相同的内容、视口/设备、缩放比例、主题、滚动位置、键盘以及相关的数据/播放状态。
  2. 捕获两者。比较整体构图,然后比较各个区域。在有用时使用叠加/差异对比,并检查实际图像,而不仅仅是得分。保持排除掩码(exclusion masks)的明确性,并仅限制在真正变化的区域。
  3. 记录具体的差异、其证据和严重程度。首先修复最大的结构性差异,然后是排版/表面,最后是动效和小型交互细节。如果后续观察与最初结构矛盾,重新审视结构。
  4. 对于动效,比较完整的过渡过程,包括第一帧、取消、过冲、安全区域覆盖范围以及最终稳定。检查闪烁、背景的后期更改、消失的导航栏、图标缩放和内容重建。
  5. 修复后,重复相关的检查以及相关的行为回归测试。在没有新证据支持的情况下,不要持续重复广泛的测试。

不要将像素不匹配视为通用的相似度分数。在量化声明背后,明确说明确切的状态、设备/视口、阈值和掩码。匹配一张截图并不表明整个产品具有一致性。渲染/字体差异可能是合理的约束;识别它们,而不是用宽泛的阈值来掩盖。

如果看起来对但感觉不对

将动效设计与执行性能区分开来。先进行性能分析,而不是随意更改持续时间和弹簧参数。

  • 在更改前后,运行相同的代表性工作负载,并附带可比的观测开销。
  • 在时序敏感的测量期间,避免逐帧截图/无障碍查询。当工具本身改变了工作负载时,应单独捕获视觉证据。
  • 调查重复的数据转换、过度的状态失效、视图重建、同步 I/O、解码、布局工作以及重复的手势回调。
  • 更改演示出的瓶颈,然后同时验证性能和外观。保留视图/缓存会用内存换取速度:设定边界,并正确处理失效和生命周期。
  • 报告测量了什么及其局限性。视频重采样并非显示帧率;不同的工作负载是不能作为有效数值基线的。

以证据完成工作

完成授权的实现和验证,而不仅仅是审计或计划,除非用户仅要求研究。

在宣布工作完成之前:

  • 每个范围内的验收标准都有实现和验证证据,或者有明确的未解决限制。
  • 重要的静态状态已与参考进行对比;在可观察时,重要的过渡过程已得到测试。
  • 功能检查覆盖了更改可能破坏的行为。对于重要流程,使用可重复的路径;避免仅仅复述简单样式代码的测试。
  • 已知的故意差异与缺陷和未知项区分开来。
  • 最终报告说明更改了什么、实际测试了什么以及剩余差异。链接有用的对比证据;不要声明超出验证范围的“像素级完美”或“完全一致”。

注意宿主资源的限制。在性能有限的机器上对繁重的构建/性能分析进行序列化。仅关闭为此任务启动且不再需要的窗口、应用、设备和服务。保留用户现有的工作和必要的服务。将秘密和个人会话数据排除在证据和源代码控制之外。未经授权,不要删除参考证据;保留有用的最终捕获和测量结果。

调用示例

  • /replicate 在当前页面中匹配此截图。注意排版和间距。
  • /replicate 实现此设计文件,包括其移动端变体。保留现有的结账行为。
  • /replicate 重新创建此应用的播放器和搜索流程。在连接的手机上比较两个应用。
  • /replicate 当前实现遗漏了此设计中的细节。检查两者并完成保真度检查。
  • /replicate 使用我们的后端复现此服务的导入工作流,包括进度、重试和失败状态。

相关技能