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 中的顺序进行。对于每个屏幕:
- 读取其在 recon 映射中的行:目的、组件、状态、经过该屏幕的流程。
- 查看参考截图以了解布局和层级,而不是具体的像素。
- 使用原语构建它。数据层提供真实数据。
- 每个状态:空、加载(如果原版使用骨架屏,则用骨架屏而非旋转指示器)、已填充、错误、无权限、长内容(例如 60 个字符的名称)、移动端宽度。
- 每次都要做的基础工作:语义化 HTML、输入框标签、键盘可达、可见的焦点、带 alt 文本的图片。
- 将
features.csv中对应的行设置为yes或partial(并附上备注)。 - 在与参考截图相同的视口尺寸下截图,保存到
replica/clone-screens/S07.png用于 replica-diff。 - 每个屏幕一个提交:
build: S07 booking page。
每个屏幕的完成标准
- recon 映射中的所有状态均已覆盖,加上空、错误和加载状态
- 在 390px 和 1440px 宽度下均正常工作
- 仅使用键盘:可以完成流程
- 无控制台错误
- 没有从原版借用的硬编码文案
- features.csv 已更新
- 已保存截图用于对比
步骤 4:构建日志
replica/build-log.md,每个屏幕一行:ID、日期、完成或部分完成、缺失的内容、比预期更难的内容。如果某个功能比看起来更大,请在日志和聊天中说明。不要悄无声息地只交付一半。
当你不确定某个功能如何工作时
以用户身份返回原版:阅读其帮助文章,观看其公开的演示,使用用户自己的账号进行操作。不要深入分析其代码或网络请求。然后构建你自己版本的行为。
输出
屏幕已构建、特性矩阵已更新、截图已保存,以及一个总结:已完成屏幕数/总数、必须完成功能数/总数、下一步是什么。然后如果数据层仍是假的,则执行 /replica-backend,否则执行 /replica-test。