复制网站风格
目标
重建特定网站的可见风格、布局、动效和交互感受,作为一个干净的静态实现。
此技能适用于“让它像这样”的任务。它比松散的主题参考更严格:输出应在可识别的构成和行为上类似于目标,同时使用原始、可维护的 HTML/CSS/JS。
核心原则:
- 复制风格和交互模式。
- 默认情况下,不复制受保护的代码、资产、个人身份、私密链接或分析数据。
- 重写一个干净的静态版本。
- 使用页面相对的内部链接和资产,使结果能通过直接文件打开、本地 HTTP 和静态托管工作。
- 在真实浏览器中对照目标进行验证。
契约
输入:
- 目标 URL、截图、模板、本地引用或具体的视觉/动效参考。
- 期望的范围:首页、选定的页面或完整的可导航静态重建。
- 输出文件夹、权限上下文以及任何用于替换目标内容的用户身份/内容。
输出:
- 一个干净的纯 HTML/CSS/JS 静态重建,包含目标的可识别布局、动效、交互感受和页面类型。
- 使用占位符或用户拥有的内容替换复制的目标身份。
EDITING.md文件,包含页面地图、内容位置、简化的交互和省略的路由。- 比较和验证摘要。
边界:
- 不要重新分发受保护的代码、私有资产、分析数据、原始个人内容或未经许可的媒体。
- 当请求的范围暗示一个可导航的网站时,不要仅停留在单个首页。
- 默认情况下,不要保留根绝对路径的框架路由;转换为静态相对路径。
- 不要发布;使用
publish-static-site。
成功标准:
- 本地重建版本在签名布局、视觉语言和核心交互上足够紧密地匹配目标,达到请求的保真度。
- 重要的页面类型存在且已链接。
- 目标身份已被替换或明确允许。
review-static-site能通过或仅报告可接受的限制。
如果标准失败:
- 重新检查目标,并在签名布局/动效上迭代。
- 使用
personalize-site处理身份残留。 - 使用
review-static-site处理结构/路径/编码/浏览器阻塞问题。
简短流程
按照以下流程进行网站重建:
- 在浏览器中探索目标。
- 映射目标内部页面和可点击的路由。
- 检查源代码和资产作为研究。
- 提取签名布局、动效、交互和视觉元素。
- 替换原始网站身份和个人内容。
- 使用纯 HTML/CSS/JS 重建完整的可导航网站。
- 将框架/根路由转换为静态页面相对链接。
- 添加一个编辑指南,供未来模型/用户编辑。
- 在真实浏览器中通过 HTTP 本地验证。
- 与目标进行比较并迭代。
- 检查是否还有遗留的目标特定文本或资产。
何时使用
当用户说或暗示以下内容时使用此技能:
- 复制这个网站的风格。
- 重建这个页面。
- 克隆这个网站。
- 制作这个网站的静态版本。
- 让它看起来像这个 URL 或截图。
- 匹配原始的动画、滚动、悬停或交互。
- 1:1、高保真度、像素级、相同感觉、相同动效。
当用户想要紧密重建而非松散灵感时,将其用于来自网站、v0、Figma、GitHub 主题、Astro、Hugo、Jekyll、Quartz、Next、React、Tailwind 或其他基于框架的模板的参考。
不要使用的情况
在以下情况不要使用此技能:
- 用户只想搜索主题。使用
search-blog-theme。 - 用户想要一个基于选定方向的原创个人网站。使用
make-personal-site。 - 用户想要内容迁移或文章导入。使用
add-blog-posts。 - 用户只想要部署帮助。使用
publish-static-site。 - 用户要求直接复制他们不拥有的网站的受保护代码、私有资产或个人内容。
- 用户明确希望保留原始框架和构建系统,而不是制作纯静态版本。
输入
使用可用的任何内容:
- 目标 URL、截图、视频、模板链接或本地引用。
- 用户期望的输出文件夹。
- 最终结果是保留占位内容还是使用用户自己的内容。
- 需要的页面或部分。
- 如果用户提供了期望的范围:仅首页、选定页面或完整可导航网站。
- 用户是否拥有目标或有权重用资产/代码。
- 任何所需的静态约束:无构建步骤、无外部依赖、仅本地部署等。
浏览器探索步骤
在实现之前,当有 URL 或交互式参考可用时,在真实浏览器中探索目标。
使用实际可用的交互式浏览器工具作为观察目标和本地预览的首选方式。“可用”意味着该工具在当前轮次的可调用工具列表中暴露出来,而不仅仅是技能、插件列表或系统描述中提及。在 Codex 中,这可能是浏览器/应用内浏览器插件(当用户或客户端已将其路由到当前轮次时);在其他代理中,它可能是一个等效的可见浏览器、浏览器使用工具或带开发者工具后端的浏览器。目标是像用户一样看到页面:视口、动效、滚动、悬停/点击行为、移动布局、控制台状态和网络故障。
如果在当前轮次中没有交互式浏览器工具暴露出来,不要假装浏览器探索步骤已完成。如果目标探索或本地比较依赖于它,请要求用户使用客户端的路由方法启用或调用浏览器工具;对于 Codex,这可能意味着发送一个明确提及 @browser 的请求。如果用户没有重新路由或客户端没有这样的工具,则回退到 Playwright、截图、静态审计或源代码检查,并说明限制。
当交互式浏览器工具实际可调用时,不要默认使用 Playwright、仅无头截图或原始源代码检查。截图可以记录观察到的情况,但不能替代交互式浏览器探索步骤。仅当没有交互式浏览器工具可调用、用户明确要求使用 Playwright 或特别需要可重复的脚本化比较时,才使用 Playwright。
当任务需要用户的 Chrome 配置文件、现有的 Chrome 标签页、扩展程序、经过身份验证的页面或 Chrome 特定行为时,使用 Chrome 自动化。
在探索期间,检查:
- 桌面首屏:构图、比例、间距、排版、颜色、可见导航和主要视觉主题。
- 移动首屏:布局变化、隐藏导航、滚动行为和内容优先级。
- 打开序列:加载状态、揭示顺序、不透明度/比例/裁剪变化、延迟和缓动感觉。
- 滚动行为:垂直与水平滚动、固定区域、吸附点、惯性、滚动链接变换和小地图变化。
- 指针行为:悬停状态、光标细节、拖拽行为、跟随指针的元素和点击区域。
- 点击行为:导航、切换、复制状态、活动状态、模态框和过渡。
- 键盘行为:方向键、Tab 焦点、在相关时的 Escape/Enter 行为。
- 内部页面地图:主要导航链接、页眉/页脚链接、打开内部页面的卡片、文章/详情页面、归档/分类/搜索/主题/设置页面、分页和仅移动菜单路由。
- 源代码线索:DOM 结构、CSS 变量、类名、内联样式、加载的字体、图片资源、打包的 CSS/JS 名称和网络请求。
- 控制台状态:可能影响行为的可见运行时错误或警告。
捕获或心理记录足够的证据以指导实现。除非用户要求,否则不要暴露长长的探索日志;用它来构建签名清单和实施计划。
源代码检查规则
对于公开网站,可以检查页面源代码、打包的 CSS/JS、网络加载的资产和 DOM 结构,以理解布局、断点、CSS 变量、动画计时、滚动行为和交互逻辑。
使用检查的源代码作为研究材料,而不是默认的可交付代码。
除非以下之一为真,否则不要直接复制、重新分发或保留另一个网站的代码、图片、字体、个人内容、私密链接、分析数据或打包资产:
- 用户拥有该网站。
- 源代码或资产明确是开源且具有兼容许可证。
- 用户确认他们有权重用。
对于普通的复制工作,重写一个干净、可维护的纯 HTML/CSS/JS 版本,捕获可见行为和设计语言。如果检查到的实现细节很重要,则将其想法翻译成原始代码。
保真度工作流程
将这些步骤视为严肃重建所需的内部分工作:
- 尽可能运行浏览器探索步骤。
- 从可见导航和重要内部链接构建目标页面地图。
- 检查目标源代码和 DOM 以获取实现线索。
- 识别目标的签名布局、签名动效、签名交互和签名视觉细节。
- 实现共享外壳,然后是链接的内部页面。
- 通过 HTTP 预览本地静态版本。
- 在类似的浏览器视口中将本地结果与目标进行比较。
- 迭代直到结果足够紧密地匹配目标的感觉,满足用户请求。
- 报告任何有意义且剩余的差异。
如果目标以动效为先,不要仅因 HTML 结构相似就停止。
完整网站范围规则
默认重建目标为一个可导航的静态网站,而不仅仅是一个首页。
除非用户明确要求“仅首页”,否则为目标的内部路由创建静态页面:
- 主要导航页面。
- 从首页或主要列表链接的文章/详情页面。
- 当它们是可见体验的一部分时,创建归档、分类、标签、链接、主题、预览、设置或搜索页面。
- 仅移动菜单目的地。
- 当它们定义了网站浏览方式时,创建分页或列表页面。
对于大型网站,不要镜像每个真实内容项。使用占位内容重建网站结构和页面类型:
- 一个或少数有代表性的文章/详情页面。
- 有代表性的归档/分类/列表页面。
- 展示分页、过滤、搜索、卡片和侧边栏行为的占位条目。
- 在生成的静态页面之间工作的内部链接。
在 EDITING.md 中记录生成的页面地图。如果某些目标路由被故意省略,请解释原因以及如何添加它们。
签名清单
在编码之前,构建一个内部清单:
- 签名布局:页面结构、构图、比例、间距、导航、断点、重复主题和不寻常的布局机制。
- 签名动效:打开动画、揭示效果、滚动行为、缓动、弹簧式移动、悬停状态、过渡、加载状态。
- 签名交互:滚轮行为、键盘行为、点击状态、复制状态、活动导航、拖拽/滚动手势、移动变化。
- 签名视觉:颜色、排版感觉、对比度、边框、阴影、遮罩、混合模式、形状、插图、背景处理。
在填充次要内容之前重建这些签名部分。
框架和动效翻译规则
目标可能使用任何技术栈。除非用户明确要求其他方式,否则将可见行为翻译为纯静态文件。
常见翻译:
- React、Next 或 Astro 组件 -> 重复的 HTML 部分,使用可重用的 CSS 类。
- Tailwind 实用类 -> 普通 CSS 规则。
- 框架路由 -> 链接的
.html文件。 - 内容集合或 CMS 数据 -> 静态 HTML 列表或小型 JSON 文件。
- 主题配置 -> CSS 自定义属性。
- Framer Motion 弹簧 -> 原生 JavaScript 弹簧循环、
requestAnimationFrame或精心调整的 CSS 缓动。 scrollX/scrollY变换 -> 滚动进度映射到 CSS 自定义属性和变换。- 裁剪揭示 ->
overflow: hidden加translateY、clip-path或蒙版动画。 - 缩放揭示 ->
transform: scale(...)配合变换原点 and 缓动。 - 布局动效 -> 变换和不透明度过渡,而不是引发布局抖动的宽度/高度变化。
- 滚动链接的水平画布 -> 滚轮监听器加水平滚动、吸附点、活动面板检测和可选的惯性缓动。
- 小地图跟踪器 -> 活动状态加变换/不透明度同步到滚动位置。
- 复制到剪贴板动画 -> 两状态文本切换配合平移/不透明度过渡。
- 光标/十字准线细节 -> 如果对参考至关重要,则使用固定元素或跟随指针的变换。
- 混合效果 -> CSS
mix-blend-mode、蒙版或需要时的简化静态对比度。
尊重 prefers-reduced-motion,但除非减少动效处于活动状态,否则不要完全移除签名动效。
静态路径兼容性规则
目标网站可能使用服务器根路径,如 /assets/...、/posts/...、/blog 或框架路由。重建的静态输出默认不应保留这些根绝对路径。
默认规则:
- 对每个站点本地资产和内部链接使用页面相对路径。
- 从根页面,使用
assets/style.css、assets/script.js、posts/example.html和archive/index.html。 - 从嵌套页面,使用正确的深度,如
../assets/style.css、../index.html或同级相对链接。 - 将目标路由如
/posts/foo、/tags/bar或/projects转换为生成的静态路径,如posts/foo.html、tags/bar.html、projects.html或projects/index.html,根据输出结构决定。 - 除非用户明确接受仅服务器根路径行为,否则不要为内部导航保留
/assets/...、/posts/...、/data/...、/images/...或/。 - 将此应用于 HTML 属性、CSS
url(...)、网站图标、封面图片、字体、数学/供应商资产、JavaScript 生成的卡片/搜索结果以及复制的路由数据。