Communitygithub.com

replica-build

根据 recon 映射,逐屏幕重建应用:先构建应用外壳,再实现垂直切片的核心里程,最后构建所有屏幕及其全部状态,并逐步更新特性矩阵。每行代码都从头编写,绝不使用原版的代码、资源或文案。

replica-build 是什么?

replica-build 是一个 AI 代理技能,用于在 Cursor 等支持 SKILL.md 的开发平台上,根据预先定义的设计规范(recon 映射、架构文档、设计文件)从头重建一个应用。它遵循严格的“净室”原则:所有代码、标签、图标和文案都重新编写,禁止复制原版的 HTML、CSS、JavaScript、SVG、图片或直接查看源码。该技能分四个步骤执行:首先搭建应用外壳(路由、布局、令牌和种子数据);然后实现一个垂直切片(端到端的核心里程,即使界面简陋);接着按屏幕逐个构建,每个屏幕都覆盖所有状态(空、加载、填充、错误、无权限等),并更新特性矩阵和保存截图用于对比;最后生成构建日志。这确保了重建过程独立、可审计,并生成与原始应用功能等价但代码完全原创的克隆。它特别适用于需要从现有应用的功能描述和视觉设计出发、从零创建全新实现的场景。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/silasroliver-hue/replica-skill-cursor/tree/HEAD/.cursor/skills/replica-build

在你喜欢的 AI 中提问

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

文档

replica-build 是做什么的?

读取 replica/recon.md、replica/architecture.md、replica/design/ 中的内容。更新 replica/features.csv(clone 列)并维护 replica/build-log.md。

规则

  • 净室操作。 每一行代码都是根据 recon 映射和规范在此编写的。切勿粘贴原版的 HTML、CSS、JavaScript、SVG 或图片,切勿从其域名或 CDN 加载任何内容,切勿“查看源码并改编”。
  • 你自己的文字。 每个标签、按钮、空状态和电子邮件都要重新编写。功能相同是等价的。文案相同是抄袭。
  • 仅用令牌。 组件中不要使用原始十六进制色值或像素值。如果某个值缺失,请将其添加到令牌中。

步骤 1:外壳

为清单中的每个屏幕建立路由(存根页面也可以),布局(导航、页眉、侧边栏),令牌连接,来自 replica-design 的原语,以及种子数据以便屏幕有真实内容可展示。提交。

步骤 2:垂直切片

在一切之前,先实现 recon 映射中的核心里程,从端到端。对于预约应用:创建活动类型、打开公开页面、预约时段、在仪表盘上查看。界面丑陋没关系,能工作才是关键。如果 replica-backend 尚未运行,则使用种子数据和具有相同函数签名的假数据层,以便后续替换为真实数据时无需修改任何屏幕代码。

步骤 3:逐个屏幕

按照 architecture.md 中的顺序进行。对于每个屏幕:

  1. 读取其在 recon 映射中的行:目的、组件、状态、经过该屏幕的流程。
  2. 查看参考截图以了解布局和层级,而不是具体的像素。
  3. 使用原语构建它。数据层提供真实数据。
  4. 每个状态:空、加载(如果原版使用骨架屏,则用骨架屏而非旋转指示器)、已填充、错误、无权限、长内容(例如 60 个字符的名称)、移动端宽度。
  5. 每次都要做的基础工作:语义化 HTML、输入框标签、键盘可达、可见的焦点、带 alt 文本的图片。
  6. 将 features.csv 中对应的行设置为 yes 或 partial(并附上备注)。
  7. 在与参考截图相同的视口尺寸下截图,保存到 replica/clone-screens/S07.png 用于 replica-diff。
  8. 每个屏幕一个提交:build: S07 booking page。

每个屏幕的完成标准

  • recon 映射中的所有状态均已覆盖,加上空、错误和加载状态
  • 在 390px 和 1440px 宽度下均正常工作
  • 仅使用键盘:可以完成流程
  • 无控制台错误
  • 没有从原版借用的硬编码文案
  • features.csv 已更新
  • 已保存截图用于对比

步骤 4:构建日志

replica/build-log.md,每个屏幕一行:ID、日期、完成或部分完成、缺失的内容、比预期更难的内容。如果某个功能比看起来更大,请在日志和聊天中说明。不要悄无声息地只交付一半。

当你不确定某个功能如何工作时

以用户身份返回原版:阅读其帮助文章,观看其公开的演示,使用用户自己的账号进行操作。不要深入分析其代码或网络请求。然后构建你自己版本的行为。

输出

屏幕已构建、特性矩阵已更新、截图已保存,以及一个总结:已完成屏幕数/总数、必须完成功能数/总数、下一步是什么。然后如果数据层仍是假的,则执行 /replica-backend,否则执行 /replica-test。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能