Skills 仓库 editorial-tech 技能实战:用 AI Agent 复刻 NEUS 企业品牌架构页的完整提示词与源码解析

原创2026-10-09 15:15:181,822 阅读

Skills 仓库 editorial-tech 技能实战:用 AI Agent 复刻 NEUS 企业品牌架构页的完整提示词与源码解析

本文围绕 Skills 仓库中 editorial-tech 技能目录 及其 demo/PROMPT.md 提示词文件,讲解如何让 Codex、Claude、Cursor 等 AI 编码 Agent 借助 $editorial-tech 技能,把「杂志式编辑排版 × 精密产品科技感」的视觉语言落到完整的响应式 HTML 页面中。读者将掌握三类提示词配方(最小提示、复刻提示、重混提示)的完整写法、逐条验收标准(Fidelity Target),以及对应 Demo 中 GSAP、Three.js、WebGL Shader、Canvas 抖动纹理等核心实现原理,从而在自己的项目里直接复现或衍生出同类高级界面。

NEUS 企业品牌架构页最终预览

editorial-tech 技能源参考图(含 WebGL 核心诊断区与轨道环粒子)

一、editorial-tech 是什么:技能定位与适用场景

在仓库的 README.md 中,editorial-tech 被归类在 Web Design 分类下的 Layout systems(布局系统) 之一,与 agency-grid-layout-minimal、framed-grid-layout、technical-wireframe-info-layout 等并列。从 SKILL.md 的 frontmatter 可以读出其官方定位:

Blend editorial magazine composition with precision product-tech detailing using asymmetrical grids, cinematic media bands, mono utility labels, and restrained accent color.

(用不对称网格、电影感媒体条带、等宽字体工具标签和克制的强调色,融合杂志式编辑排版与精密产品科技细节。)

技能元数据明确了两点边界:

  • 不是通用企业级 SaaS(generic corporate SaaS),也不是纯粹杂志极简(pure magazine minimalism),而是两者的中间态:既要有叙事性构图(narrative composition),又要有精确的技术细节(precise technical detailing);
  • 它是全系统风格方向(full design-system style direction),要贯穿布局、字体、表面、媒体处理、导航和动效,而不是只套一个 hero 区块。

二、三类提示词配方:从最小提示到重混提示

PROMPT.md 给出了三个由浅入深的提示词层级,对应仓库 README.md 的 Folder contract 中「demo/PROMPT.md 存放精确复刻与重混提示」的约定。

1. 最小提示(Minimal prompt)

原文仅一句话,是触发技能的最短路径:

Use $editorial-tech to create a responsive standalone HTML design with the same visual confidence, hierarchy, and interaction finish as the included Neuform reference.

要点在于三个关键词:

  • visual confidence(视觉自信):指版式、留白、字体层级在观感上要和参考页一样"有把握",而不是怯生生的默认模板;
  • hierarchy(层级):标题、正文、元信息三级的比例关系要对齐参考;
  • interaction finish(交互完成度):入场动画、悬停态、滚动触发等要做到"成品级",而非半成品。

$editorial-tech 前缀是 Agent 技能调用的标准语法,等价于告诉 Agent「按 SKILL.md 的 Use When / Workflow / Recommended patterns 执行」。

2. 复刻提示(Recreate the demo)

这是全文核心,它把任务拆成五块:产品简报(Product brief)、技能方向(Skill direction)、保真目标(Fidelity target)、参考快照(Reference snapshot)。逐条拆解如下。

产品简报(Product brief)

复刻对象是 NEUS | Enterprise Brand Architecture(企业品牌架构页),产品定位为「Neus Enterprise Sidebar Component」,面向现代 Web 项目中的可复用 UI 组件建设,关键词为:

  • 可复用结构(reusable structure)
  • 响应式行为(responsive behavior)
  • 生产级呈现(production-ready presentation)

适用对象是组件库与响应式产品界面。内容锚点为两个叙事板块:System Architecture(系统架构) 与 Cinematic Topologies(电影感拓扑),搜索标签为 sidebar, animated, webgl, threejs, cta, dither, charts, navigation——这些标签直接预告了 Demo 的技术栈(后文第四节会逐一对应源码)。

技能方向(Skill direction)

  • 视觉目标:构建不对称编辑构图(asymmetrical editorial compositions),强调强列结构(strong column structure)、刻意留白(deliberate negative space)与清晰的空间节奏;用大号表现性标题(large expressive headline moments)搭配安静的实用文本、等宽标签、小号元数据。
  • 定位红线:不落入「通用 SaaS」与「纯杂志极简」任一端。

保真目标(Fidelity target)

这是复刻的验收清单,共五条,必须在交付前逐条自检:

  1. 构图与细节匹配:对齐参考的构图、信息密度、字体尺度、间距节奏、表面处理、颜色关系与动效克制度;
  2. 保留最强的交互与动画背景:不要用通用淡入淡出(generic fades)或装饰性位移替代原有的交互和动态背景;
  3. 首屏定调、全页延续:首屏要做成 art-directed(精心导演过),并把同一套设计逻辑贯穿所有支撑性区块;
  4. 全端可用:从移动端到桌面端响应式,键盘可访问(keyboard accessible),开启 prefers-reduced-motion 后保持稳定;
  5. 交付物规范:交付完整的 index.html,页面自有图片、视频、模型、纹理放入 demo/assets/;外部运行时库在源依赖它们时可以保留为固定版本 CDN 依赖(pinned CDN dependencies)。

参考快照(Reference snapshot)

记录了 Neuform 平台的同步信息,其元数据同样沉淀在 demo/source.json 中:设计 slug 为 neus-enterprise-brand-architecture,607 次浏览、21 个收藏、6 次重混,在 editorial-tech 技能下同步排名第 1(排序规则为浏览量降序、再按收藏数降序)。这部分的作用是:当 Agent 复现时,以 demo/index.html 为视觉与交互参考(reference),而不是松散的情绪板(mood board)。

3. 重混提示(Remix prompt)

以 $editorial-tech 和内置 Neuform Demo 为质量基准(quality bar),但替换品牌、主题、文案、调色板与内容。保留底层布局逻辑、标志性视觉处理、交互编排、响应式行为与性能约束,让重混结果仍然清晰体现该技能。

这段提示的价值在于「换皮不换骨」:品牌与内容可以自由替换,但布局逻辑、视觉签名、交互 choreography、响应式与性能约束是技能的可迁移资产,必须原样保留,否则重混出来的页面就不再体现 editorial-tech。

三、技能设计系统:实现指引、推荐模式与调参旋钮

复刻提示提到的视觉目标,在 SKILL.md 中有更完整的实现指引(Implementation guidance),可作为 Agent 写码时的硬约束:

  • 布局:优先多列布局、错位对齐(offset alignment)、编辑式裁切(editorial cropping),拒绝居中通用的 SaaS hero 块;
  • 字体:用一套展示型字体(display-oriented type treatment)承载 hero 与章节大标题,再用干净的无衬线或等宽字体承载标签、步骤、时间戳与 UI 注释;
  • 表面:暗色面板、低饱和填充、细描边、渐变描边壳层(gradient-border shells)或轻微发光叠加,不要夸张的玻璃拟态(loud glassmorphism);
  • 媒体:引入可横向跨网格、受控重叠相邻列的电影感横条或带框媒体区;
  • 动效:掩膜文字揭示(masked text reveals)、平静视差(calm parallax)、缓慢媒体漂移、悬停线条提亮;动效应「刻意且技术化」,绝不俏皮弹跳;
  • 强调色:只用于激活态、数字高亮、当前步骤、进度指示、焦点分隔线与关键 CTA 表面。

推荐模式速查表

模块 推荐做法
导航 稀疏顶栏、宽间距、低饱和链接、居中的精确标记或带框 Logo
Hero 一侧超大编辑标题 + 另一侧紧凑支撑文案 + 一条贯穿构图的电影感条带/内嵌媒体条
信息模块 步骤列表、章节标记、等宽计数器、时间线刻度、带边框胶囊、紧凑元数据簇
容器 细框面板、受控图片裁切、微弱辉光强调、强化网格的结构线
CTA 简洁高级控件、利落几何、明暗对比、克制的强调色,而非超大营销按钮

五个调参旋钮(Tuning knobs)

  1. Editorial intensity(编辑强度):调节构图的不对称与重叠程度,决定戏剧性高低;
  2. Technical density(技术密度):增删分割线、标记、等宽标签与界面元数据,控制页面的"产品感"浓度;
  3. Accent restraint(强调色克制度):让颜色保持稀疏,系统才显得高级而不过度修饰;
  4. Media prominence(媒体比重):调节电影感影像/视觉条带相对纯排版的统治力;
  5. Contrast(对比度):即使使用阴沉暗色表面与叠图处理,也要保证强可读性。

必须避免(Avoid)

  • 居中通用 SaaS 布局、可互换卡片与库存渐变;
  • 过度装饰的科幻镀铬、过量霓虹、嘈杂 HUD 叠加;
  • 打破克制编辑色调的高饱和多色配色;
  • 把技能当成"没有技术精确线索的纯杂志设计";
  • 到处使用强调色,而不是让它作为构图中的"标点"。

四、Demo 源码级剖析:NEUS 页面的技术实现

复刻提示要求把 demo/index.html 当作视觉与交互参考,我们从 source.json 和 Demo 页面的实际运行 HTML 中可以还原出完整技术栈与实现细节。

1. 运行时依赖与资源策略

source.json 的 runtime_dependencies 与 assets.bundled 记录了源页面的外部依赖,同步到仓库时被固化(pinned)为本地运行时文件:

从 index.html 的外层包装可以看到仓库的演示安全策略:Demo 以 sandbox="allow-scripts" 的 iframe 运行,内部通过 postMessage({ type: "neuform-assets-v1" }) 注入图片资产,并给 iframe 设置 allow-scripts、referrerpolicy="no-referrer",外层 Content-Security-Policy 全部收紧(default-src 'none')。也就是说,运行时图片与脚本都是在沙箱里以 Blob/Object URL 方式替换加载,不会依赖原始外部图床——这正是"生产级、可移植"交付形态的体现。

2. 三层背景系统

页面 body 是深色基底 bg-[#030305]、白色 90% 文字、青绿强调色 #00F0FF,叠加了三层固定背景:

  • Layer 0:WebGL 空间/光束着色器(#bg-canvas,透明度 40%):片段着色器使用经典 mod289/permute 噪声函数生成缓慢漂移的青绿→深紫光束带,time uniform 按毫秒推进,边缘做 smoothstep 渐隐;
  • Layer 1:Canvas 抖动纹理(#dither-canvas,透明度 20%):用 4×4 Bayer 矩阵 [[0,8,2,10],[12,4,14,6],[3,11,1,9],[15,7,13,5]] 生成程序化抖动点阵,并叠加径向渐变做暗角(vignette)——这正是产品简报标签里 dither 的来源;
  • Layer 2:SVG 噪声 DIV(feTurbulence fractalNoise,透明度 8%):以 data-URI 内联 SVG 提供全屏噪点肌理。

3. 主内容区:编辑排版与 GSAP 动效

左侧主内容区(flex-1)内部有对角细线网格背景(45 度 repeating-linear-gradient),再往上依次是:

  • 编辑式头部:左侧是带青绿角标与发光点的品牌方块 + 等宽标签 NEUS // 2026,右侧是 MANIFESTO / VISUAL ASSETS / COMPONENTS 三个等宽导航链接(Roboto Mono、12px、tracking-[0.15em]、悬停变青绿);
  • Hero 排版:超大标题 System Architecture(64px → md:96px、font-light、tracking-[-0.05em]、leading-[0.9]),右侧 1/3 列是支撑文案与 CTA 按钮。CTA 是典型的"渐变描边壳层 + 白底黑字主块 + 暗色箭头块"三段式结构,箭头图标用 Iconify solar:arrow-right-linear,hover 时块体变灰、箭头右移——对应 SKILL 里"简单但高级的 CTA";
  • 文字揭示动效:reveal-text 标题被 JS 按 <br> 分行、按词包裹 span.word-inner,初始 translateY(110%),再用 GSAP to(..., { y: '0%', duration: 1.4, stagger: 0.05, ease: 'power4.out', scrollTrigger: { trigger: el, start: 'top 85%' } }) 逐词上移显现;reveal-fade 元素则用 y:30, opacity:0 → 1.2s 淡入 + stagger 0.15。

4. 标志性视觉:Three.js 粒子轨道环(CORE DIAGNOSTICS 区)

这是整个页面最"技术化"的视觉签名,位于 600px 高的框体内,四角有白色 30% 的 L 形括号,内部包含:

  • WebGL 渲染器:PerspectiveCamera(50, aspect, 0.1, 100)、WebGLRenderer({ alpha:true, antialias:true })、setPixelRatio(Math.min(devicePixelRatio, 2)),场景带 FogExp2(0x000000, 0.25) 大气雾;
  • 核心密度球:SphereGeometry(1.4, 64, 64) + PointsMaterial({ color: 0xaaaaaa, size: 0.012, transparent, opacity: 0.5, blending: AdditiveBlending }),约 65×65 个点的中性灰粒子云;
  • 轨道环:TorusGeometry(2.2, 0.6, 24, 150) 的点位置加随机扰动(±0.3)形成"粒子环盘",材质用品牌青绿 0x00F0FF、size 0.018、opacity 0.7,绕 X 轴倾斜 Math.PI/2.8,每帧 rotation.z -= 0.0015 缓慢自转;
  • 动效循环:requestAnimationFrame 驱动,核心球呼吸缩放 1 + sin(t*0.8)*0.015,并对手指/鼠标位置做流畅惯性跟随(tX += (mX*0.25 - tX)*0.04),让场景产生轻微视差旋转,配合 Core Diagnostics 与 Orbital Ring · Consensus Layer Active 两枚悬浮标签(等宽字体、backdrop-blur-sm 黑块、虚线连接线),把纯装饰的粒子系统包装成"系统诊断"叙事——这正是 charts、webgl、threejs 标签的落点。

5. 右侧固定侧边栏:产品级遥测界面

aside 是 320px(lg:400px)固定宽度侧栏,backdrop-blur-md bg-black/10,承载"可复用 UI 组件"定位的展示:

  • TELEMETRY 头部:等宽标签 + 三段式信号灯条(两灰一青绿);
  • 状态组件:内凹圆角面板(shadow-[inset_0_2px_5px_rgba(255,255,255,0.06),inset_0_-2px_5px_rgba(0,0,0,0.8)])、顶部高光细线、右上角青绿辉光斑,内含 server-square-line 图标、ACTIVE 状态胶囊、Network Load 84.2% 数值与青绿渐变内嵌进度条(带右侧 2px 白光发光缘);
  • FOUNDING PROTOCOL 团队栏:两位成员(Elena Rostova / Chief Architect、Marcus Vance / Head of Cryptography)的圆形头像(灰度滤镜,hover 时 grayscale-0 500ms 恢复)加姓名与等宽职位;
  • 底部诊断走马灯:animate-[pulse_3s_ease-in-out_infinite] 的横向滚动文本条,内容为 SYS_UPTIME: 99.999% · LATENCY: 4ms · NODES: 2,041 · ENCRYPT: AES-256——用 mono 小字把"系统数据"做成持续的视觉节奏,是"技术密度"旋钮的直接体现。

6. 响应式与可访问性实现

  • 导航在 md 以下隐藏(hidden md:flex),侧边栏 hidden md:flex,hero 由 flex-col 在 lg 断点切为 lg:flex-row,媒体区从单列切到 4/8 列网格;
  • 侧栏独立 overflow-y-auto,主区同步滚动,符合"组件库/产品界面"双栏交互;
  • 隐藏滚动条类 no-scrollbar 保留滚动功能;背景层统一 pointer-events-none 防止遮挡交互;动效全部走 GSAP 且克制,配合 prefers-reduced-motion 场景下(SKILL 要求)保持页面稳定可用。

五、如何在项目中运行与复用

仓库是只读参考,运行方式如下:

  1. 直接打开演示:在浏览器中打开 demo/index.html(也可从 DEMOS.md 的 editorial-tech 条目 进入),或参考 SCREENSHOTS.md 中的截图说明;
  2. 查看提示词:阅读 demo/PROMPT.md,把"复刻提示"整段粘贴给支持技能语法的 Agent(Codex / Claude Code / Cursor),Agent 会按 SKILL.md 的 Workflow 与 Recommended patterns 产出页面;
  3. 自行重混:基于重混提示替换品牌、文案与配色,保留布局逻辑与交互编排,产出新的 index.html 与 demo/assets/ 资源;
  4. 同步元数据参考:技能排名、浏览量、运行时依赖清单等均可从 source.json 查阅,作为"该技能在 Neuform 平台以该设计为 #1 参考"的出处依据。

六、小结:把「编辑 × 科技」落成可复制的技能资产

editorial-tech 的价值不在于单个页面,而在于把一套可判定的设计系统(不对称网格、等宽工具标签、克制的青绿强调、三层技术背景、GSAP 文字揭示、Three.js 粒子轨道环、产品级遥测侧栏)写进了 SKILL.md 与 PROMPT.md,并通过 demo/index.html 给出可运行的保真样本。最小提示负责"快",复刻提示负责"准",重混提示负责"变",五个调参旋钮负责"度"——这正是仓库 README「Prompts are assets / Specs beat vibes / References beat paragraphs」哲学的完整落地,适合作为任何产品级暗色技术品牌页、企业架构页或组件库展示页的起点。

登录后查看全文
Skills