wix-headless-replatform

wix-headless-replatform

角色

根据源网站，构建一个足够相似且视觉精致的 Wix Headless 前端。 实现范围仅限一个已确定的首页，默认输出路径为 projects/<project-name>，项目名称根据主机名确定。使用 Wix CLI Headless、Astro、 TypeScript 和 Tailwind；仅在构建复杂交互式岛屿时使用 React。 在后续获批的工作流明确了页面解析方式和跨路由共享证据之前，对于额外页面和明确指定 URL 的范围请求， 应予以拒绝，并提供可执行的说明。

此入口技能负责监督流程。它决定下一个工作流阶段，并且只加载该阶段所需的资源。不要预先加载所有资源或参考资料：各阶段的规则会按需加载。

存在两种模式：

• 独立克隆： 从源 URL 创建新的真实 Wix CLI Headless 项目。
• 迁移阶段： 使用 --handoff <migration-project>/website/handoff.json 在迁移项目拥有的目标站点上继续操作。集成迁移时绝不能省略 --handoff：独立命令会创建第二个站点。

不可妥协的约束

• 将用户请求的公开品牌首页视为已获授权；遵循 references/safety.md 中的边界，无需另行提出常规授权问题。
• 必须使用基于浏览器的提取方式。不得用仅提取 HTML 的方式代替。
• 截取页面前，必须先确定首页。只能依据经过验证且已冻结的提取清单进行构建；原始观察结果绝不能作为构建输入。
• 独立模式的输出必须是成功生成的 Wix CLI 脚手架，并包含有效的 Wix 身份信息以及可运行的 dev 和 build 脚本。绝不能手动创建伪装成 Wix 项目的替代品。
• 在迁移模式下，沿用交接文件中的站点、项目及路由／数据绑定意图；不得创建或改用第二个目标站点。
• 保留源网站的结构、首屏证据、页面框架层级、源素材、字体、核心交互、SEO、内部 URL 行为和品牌化回退行为。
• 构建完成不代表任务完成。只有具备 rp-qa-gap-loop 所述的验收后视觉审查和差距迭代证据，才算完成；只有用户明确选择了焕新模式时，才需要验收可选的焕新效果。

主管协议

每次新运行或恢复运行时：

1. 确定源 URL、输出目录和模式。在迁移模式下，先读取 website/handoff.json 和 docs/site-clone/frontend-automation-state.json。
2. 从下表中选择第一个未完成的阶段，并且只读取该资源的 SKILL.md 及其明确要求的参考资料。
3. 执行该阶段，直到它写入所需的持久化产物，或记录有证据支持的具体真实阻塞及精确的解除阻塞操作。
4. 每完成一个阶段后，重新选择阶段。不要说某个必需的后续步骤“需要执行”，然后就结束运行；应加载其资源并实际执行。

阶段	仅在以下情况加载	资源	持久化结果
上下文	模式、范围、项目或浏览器环境尚未确定	resources/rp-project-context/SKILL.md	有效上下文、审批记录、可运行的项目/计划状态，或阻塞记录
证据	缺少冻结的主页提取内容，或内容已过时	resources/rp-source-evidence/SKILL.md	已验证的 extraction/latest.json 和冻结清单，或全局阻塞记录
实现	冻结的构建计划已存在，且主页 UI 尚未完成	resources/rp-ui-implementation/SKILL.md	可运行且能识别清单哈希的主页实现
验证与改进	构建、QA、对比、审查、修复、报告、发布或收据尚未完成	resources/rp-qa-gap-loop/SKILL.md	验收结果、done_with_gaps，或全局阻塞记录
可选外观优化	常规克隆已验收，且自动化状态表明已请求外观优化	resources/rp-facelift/SKILL.md	已验收的外观优化审查，或阻塞记录

当 frontendPhase.allowedNow 为 plan 时，只完成符合计划阶段要求的上下文和证据工作，并保留可恢复的计划状态记录。当它为 build 时，继续针对迁移拥有的项目完成实现和验证。

一键继续

声明 automationMode: "one_click" 的迁移交接授权执行常规范围及前端检查点。将这些审批记录在 docs/site-clone/frontend-automation-state.json 中；不要暂停询问是否继续执行必需阶段、截图审查或已授权的差距修复流程。 可以在一键接收阶段提出明确的外观优化请求，但必须等常规克隆验收后才能进行；一键模式本身并不意味着可以进行外观优化。

在一键构建运行中，持续选择并执行阶段，直到满足以下某一持久化结果：

• website/completion.json 有效，且最新视觉审查已完成，没有尚未解决的关键/高严重性身份识别问题；或
• 已完成五轮视觉差距循环，且 website/completion.json 记录了真实的最终状态 done_with_gaps 以及最终审查证据；或
• 记录了真实阻塞，并注明负责人、证据、已尝试的恢复操作，以及所需的确切后续权限/操作。

由项目拥有的本地提取差距不属于真实阻塞。继续进行无关工作，最多进行两次不同的定向恢复尝试，然后临时构建受影响的依赖闭包，并在 final-report.json 和 .md 中列出组装后的选项。

在将 shell、浏览器或网络故障归类为阻塞之前，请使用仓库本地 Wix/Yarn 工具链的 PATH 顺序，并按照 resources/rp-project-context/SKILL.md 中的恢复顺序操作：先重试对齐的 shell，然后执行要求的浏览器/网络升级并重试；只有仍然失败或审批尚待处理时，才能记录阻塞。每轮差距迭代后，立即返回阶段表；切勿将首次构建、已报告的计划或后端导入视为前端完成。

命令

独立模式下运行 node scripts/site-clone.mjs <source-url>，迁移模式下运行 node scripts/site-clone.mjs <source-url> --handoff <path>。当前阶段所需的确切命令和输入由相应资源提供。

参考资料

资源会加载各自的参考资料。共享契约保存在 references/ 下： safety.md、workflow.md、extraction-schema.md、output-contract.md、 qa-checklist.md，以及交互、布局、控件、规范化和缺口契约。