Communitygithub.com

AkaraChen/aghub

通过技术性极强的实现方式——着色器、弹簧物理、滚动驱动揭示、60fps动画——将界面推至常规极限。当用户想要惊艳、震撼、全力以赴,或打造非凡体验时使用。

aghub 是什么?

该技能(AkaraChen/aghub)旨在帮助开发者将用户界面推至常规极限,不仅限于视觉效果,而是利用浏览器的全部能力,让界面中任何部分都感觉非凡,例如处理百万行数据的表格、从触发器变形的对话框、实时流式验证的表单或电影级页面过渡。它强调先通过提议环节确定项目个性(视觉/营销、功能UI、性能关键或数据密集型),再选择合适的技术(如View Transitions API、滚动驱动动画、WebGL/WebGPU、虚拟滚动、Web Workers等),并严格遵守渐进增强、性能优化(目标60fps、尊重prefers-reduced-motion)和迭代改进(使用浏览器自动化预览、视觉验证)的原则。该技能支持所有主流浏览器,但要求对不支持的API提供功能回退,并通过“惊叹测试”、“移除测试”、“设备测试”等验证最终体验,确保技术服务于体验,而非相反。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/AkaraChen/aghub/tree/HEAD/.agents/skills/overdrive

在你喜欢的 AI 中提问

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

文档

──────────── ⚡ OVERDRIVE ───────────── 》》》 进入过载模式...

将界面推至常规极限。这不仅关乎视觉效果——而是要利用浏览器的全部能力,让界面中的任何部分都感觉非凡:一张处理百万行数据的表格,一个从触发器变形的对话框,一个实时流式验证的表单,一场电影级的页面过渡。

强制准备

调用 /frontend-design——它包含设计原则、反模式和上下文收集协议。在执行前遵循该协议——如果还没有设计上下文,你必须先运行 /teach-impeccable。

对此技能尤其重要:上下文决定了“非凡”的含义。在创意作品集上的粒子系统令人印象深刻;在设置页面上的相同粒子系统却令人尴尬。但一个具有即时乐观保存和动画状态转换的设置页面?那也同样非凡。在决定何种方式恰当之前,要理解项目的个性和目标。

先提议,再构建

此技能最容易出现偏差。切勿直接跳入实现。你必须:

  1. 思考2-3个不同的方向——考虑不同的技术、雄心水平和美学方法。对每个方向,简要描述结果的外观和感受。
  2. 直接询问用户以澄清你无法推断的事项。 向用户展示这些方向并在写任何代码前让用户选择。解释权衡(浏览器支持、性能成本、复杂性)。
  3. 仅按照用户确认的方向进行。

跳过这一步可能会构建出需要被丢弃的尴尬产物。

结合浏览器自动化迭代

技术性极强的效果几乎从未在第一次尝试时成功。你必须主动使用浏览器自动化工具来预览你的工作,视觉验证结果,并进行迭代。不要假设效果看起来正确——要检查它。预计需要多轮改进。“技术上可行”和“看起来非凡”之间的差距是通过视觉迭代来弥合的,而非仅靠代码。


评估此处的“非凡”意味着什么

合适的技术野心完全取决于你正在处理的内容。在选择技术之前,问自己:这个特定界面的用户会在什么情况下说“哇,真不错”?

对于视觉/营销界面

页面、英雄区、落地页、作品集——“哇”通常来自感官:滚动驱动揭示、着色器背景、电影级页面过渡、响应光标的生成艺术。

对于功能型界面

表格、表单、对话框、导航——“哇”在于感受:通过视图过渡从触发按钮变形的对话框、通过虚拟滚动以60fps渲染10万行的数据表格、带有流式验证的极速表单、具有弹簧物理特性的拖放。

对于性能关键型界面

“哇”是隐形的但能被感受到:一个过滤5万项毫无闪烁的搜索、一个永不阻塞主线程的复杂表单、一个近乎实时处理的图像编辑器。界面从不犹豫。

对于数据密集型界面

图表和仪表盘——“哇”在于流畅性:通过Canvas/WebGL对海量数据集进行GPU加速渲染、数据状态之间的动画过渡、自然沉降的力导向图布局。

共同线索:实现过程中的某些东西超出了用户对网页界面的预期。技术服务于体验,而非相反。

工具箱

按目标而非技术名称组织。

让过渡感觉电影级

  • View Transitions API(同文档:所有浏览器;跨文档:不支持Firefox)——状态间的共享元素变形。列表项展开为详情页面。按钮变形为对话框。这是最接近原生FLIP动画的方式。
  • @starting-style(所有浏览器)——仅用CSS将元素从display: none动画到可见,包括入场关键帧。
  • 弹簧物理——通过质量、张力和阻尼实现自然运动,而非三次贝塞尔曲线。库:motion(原Framer Motion)、GSAP,或自行实现弹簧求解器。

将动画绑定到滚动位置

  • 滚动驱动动画(animation-timeline: scroll())——纯CSS,无需JavaScript。视差、进度条、揭示序列均由滚动位置驱动。(Chrome/Edge/Safari;Firefox:仅标记——始终提供静态回退。)

超越CSS的渲染

  • WebGL(所有浏览器)——着色器效果、后处理、粒子系统。库:Three.js、OGL(轻量)、regl。用于CSS无法表达的效果。
  • WebGPU(Chrome/Edge;Safari部分;Firefox:仅标记)——下一代GPU计算。比WebGL更强大,但浏览器支持有限。始终回退到WebGL2。
  • Canvas 2D / OffscreenCanvas——自定义渲染、像素操作,或通过Web Workers + OffscreenCanvas将重型渲染移出主线程。
  • SVG滤镜链——用于有机扭曲效果的置换图、湍流、形态学滤镜。可通过CSS动画。

让数据感觉生动

  • 虚拟滚动——仅为包含数万项的表单/列表渲染可见行。简单情况无需库;复杂情况使用TanStack Virtual。
  • GPU加速图表——通过Canvas或WebGL渲染数据可视化,适用于数据量过大无法使用SVG/DOM的情况。库:deck.gl、基于regl的自定义渲染器。
  • 动画化数据过渡——在不同图表状态间变形而非替换。使用D3的transition()或基于DOM的图表的View Transitions。

动画化复杂属性

  • @property(所有浏览器)——注册带类型的自定义CSS属性,从而实现CSS通常无法插值的效果,如渐变、颜色和复杂值。
  • Web Animations API(所有浏览器)——由JavaScript驱动的动画,具有CSS般的性能。可组合、可取消、可逆。是复杂编排的基础。

挑战性能极限

  • Web Workers——将计算移出主线程。重型数据处理、图像操作、搜索索引——任何会导致卡顿的功能。
  • OffscreenCanvas——在Worker线程中渲染。主线程保持空闲,而复杂视觉效果在后台渲染。
  • WASM——为计算密集型功能提供接近原生的性能。图像处理、物理模拟、编解码器。

与设备交互

  • Web Audio API——空间音频、音频响应式可视化、声音反馈。需要用户手势启动。
  • 设备API——方向、环境光、地理位置。谨慎使用,且始终征得用户许可。

注意:本技能是关于增强界面的感受,而非改变产品的功能。增加实时协作、离线支持或新的后端能力是产品决策,而非界面增强。专注于让已有功能感觉非凡。

有纪律地实现

渐进增强是硬性要求

每种技术都必须优雅降级。没有增强的体验也必须良好。

@supports (animation-timeline: scroll()) {
	.hero {
		animation-timeline: scroll();
	}
}
if ("gpu" in navigator) {
	/* WebGPU */
} else if (canvas.getContext("webgl2")) {
	/* WebGL2 回退 */
}
/* 纯CSS回退必须仍然好看 */

性能规则

  • 目标60fps。如果降至50以下,则简化。
  • 始终尊重 prefers-reduced-motion。提供美观的静态替代方案。
  • 懒初始化重型资源(WebGL上下文、WASM模块),仅在接近视口时加载。
  • 暂停屏幕外渲染。关闭不可见的内容。
  • 在真实的中端设备上测试,而非仅在你的开发机上。

细节决定差异

“酷”与“非凡”之间的差距在于最后20%的打磨:弹簧动画的缓动曲线、错开揭示的时间偏移、使过渡感觉有物理感的细微二级运动。不要交付第一个能用的版本——交付那个感觉必然如此的版本。

切勿:

  • 忽略 prefers-reduced-motion——这是无障碍要求,而非建议。
  • 交付导致中端设备卡顿的效果。
  • 使用前沿API而不提供功能性回退。
  • 在没有明确用户选择的情况下添加声音。
  • 用技术野心掩盖薄弱的设计基础——先用其他技能修复设计问题。
  • 叠加多个相互竞争的非凡时刻——聚焦创造冲击力,过量制造噪音。

验证结果

  • 惊叹测试:展示给未见过的人。他们有反应吗?
  • 移除测试:去掉效果。体验是否有所下降,还是无人察觉?
  • 设备测试:在手机、平板、Chromebook上运行。仍然流畅吗?
  • 无障碍测试:启用减少动画。仍然美观吗?
  • 上下文测试:这对这个品牌和受众有意义吗?

记住:“技术上的非凡”不在于使用最新的API。而在于让界面做出用户没想到网站能做到的事情。

相关技能