shawon-builds/Ai-skill

高自主性前端技能

1. 当前基线配置

• DESIGN_VARIANCE: 8（1=完美对称，10=艺术混乱）
• MOTION_INTENSITY: 6（1=静态/无动效，10=电影级/魔法物理）
• VISUAL_DENSITY: 4（1=艺术画廊/通透，10=飞行驾驶舱/数据密集）

AI 指令： 所有生成的标准基线严格设置为这些值（8, 6, 4）。不要要求用户编辑此文件。否则，始终听从用户：根据他们在聊天提示中明确要求的内容动态调整这些值。使用这些基线（或用户覆盖的）值作为全局变量，驱动第 3 节到第 7 节中的具体逻辑。

2. 默认架构与约定

除非用户明确指定不同的技术栈，否则遵循以下结构约束以保持一致性：

• 依赖验证 [强制]： 在导入任何第三方库（例如 framer-motion、lucide-react、zustand）之前，你必须检查 package.json。如果包缺失，你必须在提供代码之前输出安装命令（例如 npm install package-name）。永远不要假设库存在。
• 框架与交互性： React 或 Next.js。默认为服务端组件（RSC）。
  • RSC 安全： 全局状态只能在客户端组件中使用。在 Next.js 中，将 Provider 包裹在 "use client" 组件中。
  • 交互性隔离： 如果第 4 节或第 7 节（动效/液态玻璃）处于激活状态，特定的交互式 UI 组件必须被提取为一个孤立的叶子组件，并在其顶部使用 'use client'。服务端组件必须专门渲染静态布局。
• 状态管理： 对孤立的 UI 使用本地的 useState/useReducer。仅在需要避免深层属性传递时使用全局状态。
• 样式策略： 90% 的样式使用 Tailwind CSS（v3/v4）。
  • TAILWIND 版本锁定： 首先检查 package.json。不要在 v3 项目中使用 v4 语法。
  • T4 配置防护： 对于 v4，不要在 postcss.config.js 中使用 tailwindcss 插件。使用 @tailwindcss/postcss 或 Vite 插件。
• 反表情符号策略 [关键]： 绝不 在代码、标记、文本内容或替代文本中使用表情符号。用高质量的图标（Radix、Phosphor）或干净的 SVG 基本图形替换符号。表情符号被禁止。
• 响应式与间距：
  • 标准化断点（sm、md、lg、xl）。
  • 使用 max-w-[1400px] mx-auto 或 max-w-7xl 限制页面布局。
  • 视口稳定性 [关键]： 绝不 为全高 Hero 区域使用 h-screen。始终使用 min-h-[100dvh] 以防止移动浏览器（iOS Safari）上出现灾难性的布局跳跃。
  • 网格优于弹性数学： 绝不 使用复杂的 flexbox 百分比计算（w-[calc(33%-1rem)]）。始终使用 CSS Grid（grid grid-cols-1 md:grid-cols-3 gap-6）以获得可靠的结构。
• 图标： 你必须使用 @phosphor-icons/react 或 @radix-ui/react-icons 作为导入路径（检查已安装版本）。全局标准化 strokeWidth（例如，统一使用 1.5 或 2.0）。

3. 设计工程指令（偏差修正）

LLM 对特定的 UI 陈词滥调模式存在统计偏差。使用这些工程规则主动构建高级界面：

规则 1：确定性排版

• 展示/标题： 默认为 text-4xl md:text-6xl tracking-tighter leading-none。
  • 反敷衍： 对于“高级”或“创意”氛围，不鼓励使用 Inter。强制使用独特的字符，如 Geist、Outfit、Cabinet Grotesk 或 Satoshi。
  • 技术 UI 规则： 在仪表盘/软件 UI 中严格禁止衬线字体。对于这些场景，只使用高端无衬线字体搭配（Geist + Geist Mono 或 Satoshi + JetBrains Mono）。
• 正文/段落： 默认为 text-base text-gray-600 leading-relaxed max-w-[65ch]。

规则 2：色彩校准

• 约束： 最多 1 种强调色。饱和度 < 80%。
• 紫色禁令： “AI 紫/蓝色”审美被严格禁止。没有紫色按钮发光，没有霓虹渐变。使用绝对中性基底（Zinc/Slate）搭配高对比度、单一强调色（例如翡翠绿、电光蓝或深玫瑰红）。
• 色彩一致性： 在整个输出中坚持使用一种调色板。不要在同一个项目中在暖灰和冷灰之间波动。

规则 3：布局多样化

• 反居中偏差： 当 DESIGN_VARIANCE > 4 时，严格禁止居中的 Hero/H1 部分。强制使用“分屏”（50/50）、“左对齐内容/右对齐资源”或“非对称空白”结构。

规则 4：材质感、阴影与“反卡片过度使用”

• 仪表盘强化： 对于 VISUAL_DENSITY > 7，严格禁止通用的卡片容器。使用逻辑分组，通过 border-t、divide-y 或纯负空间。数据指标应该不受约束地呈现，除非在功能上需要层级（z-index）。
• 执行： 仅当阴影传达层级时使用卡片。使用阴影时，将其色调调整为背景色。

规则 5：交互式 UI 状态

• 强制生成： LLM 自然地生成“静态”的成功状态。你必须实现完整的交互周期：
  • 加载： 匹配布局尺寸的骨架加载器（避免通用的圆形旋转器）。
  • 空状态： 精美组合的空状态，指示如何填充数据。
  • 错误状态： 清晰的内联错误报告（例如，表单）。
  • 触觉反馈： 在 :active 时，使用 -translate-y-[1px] 或 scale-[0.98] 来模拟物理按压，指示成功/动作。

规则 6：数据与表单模式

• 表单： 标签必须位于输入框上方。辅助文本是可选的，但应存在于标记中。错误文本在输入框下方。对输入块使用标准的 gap-2。

4. 创造性主动性（反敷衍实现）

为了积极对抗通用的 AI 设计，系统性地将这些高端编码概念作为你的基线：

• “液态玻璃”折射： 当需要玻璃拟态时，超越 backdrop-blur。添加 1px 内边框（border-white/10）和微妙的内阴影（shadow-[inset_0_1px_0_rgba(255,255,255,0.1)]）来模拟物理边缘折射。
• 磁性微物理（如果 MOTION_INTENSITY > 5）： 实现稍微朝鼠标光标拉近的按钮。关键： 绝不 对磁性悬停或连续动画使用 React useState。专有地使用 Framer Motion 的 useMotionValue 和 useTransform（在 React 渲染循环之外），以防止移动设备上的性能崩溃。
• 持续微交互： 当 MOTION_INTENSITY > 5 时，在标准组件（头像、状态点、背景）中嵌入连续的、无限的微动画（脉冲、打字机、浮动、闪烁、轮播）。对所有交互元素应用高级弹簧物理（type: "spring", stiffness: 100, damping: 20）——没有线性缓动。
• 布局过渡： 始终利用 Framer Motion 的 layout 和 layoutId 属性，实现状态变化时平滑的重新排序、调整大小和共享元素过渡。
• 交错编排： 不要立即挂载列表或网格。使用 staggerChildren（Framer）或 CSS 级联（animation-delay: calc(var(--index) * 100ms)）来创建顺序瀑布式显示。关键： 对于 staggerChildren，父元素（variants）和子元素必须位于相同的客户端组件树中。如果数据是异步获取的，则将数据作为 props 传递到集中的父 Motion 包装器中。

5. 性能防护

• DOM 成本： 仅对固定的、pointer-events-none 的伪元素（例如 fixed inset-0 z-50 pointer-events-none）应用纹理/噪点滤镜，并且绝不应用于滚动容器，以防止连续的 GPU 重绘和移动性能下降。
• 硬件加速： 绝不 对 top、left、width 或 height 进行动画。仅通过 transform 和 opacity 进行动画。
• Z-Index 约束： 绝不 随意使用 z-50 或 z-10。严格为系统层级上下文（粘性导航栏、模态框、覆盖层）使用 z-index。

6. 技术参考（参数定义）

DESIGN_VARIANCE（等级 1-10）

• 1-3（可预测）： Flexbox justify-center，严格的 12 列对称网格，等距内边距。
• 4-7（偏移）： 使用 margin-top: -2rem 重叠，变化的图像宽高比（例如 4:3 旁边是 16:9），标题左对齐，数据居中。
• 8-10（非对称）： 瀑布流布局，使用分数单位的 CSS Grid（例如 grid-template-columns: 2fr 1fr 1fr），大量空白区域（padding-left: 20vw）。
• 移动端覆盖： 对于等级 4-10，任何在 md: 以上断点的非对称布局，在视口 < 768px 时必须强制回退到严格的单列布局（w-full、px-4、py-8），以防止水平滚动和布局破坏。

MOTION_INTENSITY（等级 1-10）

• 1-3（静态）： 无自动动画。仅限 CSS :hover 和 :active 状态。
• 4-7（流畅 CSS）： 使用 transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1)。使用 animation-delay 级联实现加载入场。严格专注于 transform 和 opacity。谨慎使用 will-change: transform。
• 8-10（高级编排）： 复杂的滚动触发显示或视差。使用 Framer Motion 钩子。绝不 使用 window.addEventListener('scroll')。

VISUAL_DENSITY（等级 1-10）

• 1-3（艺术画廊模式）： 大量空白。大段间距。一切都感觉非常昂贵和干净。
• 4-7（日常应用模式）： 标准 Web 应用的正常间距。
• 8-10（驾驶舱模式）： 极小的内边距。没有卡片框；仅使用 1px 线条分隔数据。一切都是密集的。强制： 对所有数字使用等宽字体（font-mono）。

7. AI 特征（禁止模式）

为保证高品质、非通用的输出，你必须严格避免这些常见的 AI 设计签名，除非用户明确要求：

视觉与 CSS

• 无霓虹/外发光： 不要使用默认的 box-shadow 发光或自动发光。使用内边框或微妙的着色阴影。
• 无纯黑色： 绝不 使用 #000000。使用 Off-Black、Zinc-950 或炭黑色。
• 无过饱和强调色： 降低强调色饱和度，使其优雅地融入中性色。
• 无过多渐变文本： 不要对大标题使用文本填充渐变。
• 无自定义鼠标光标： 它们已经过时，并且会破坏性能/可访问性。

排版

• 无 Inter 字体： 禁止使用。使用 Geist、Outfit、Cabinet Grotesk 或 Satoshi。
• 无过大的 H1： 第一个标题不应该喧宾夺主。通过粗细和颜色控制层次，而不仅仅是巨大的字号。
• 衬线字体约束： 仅在创意/编辑设计中使用衬线字体。绝不 在干净的仪表盘中使用衬线字体。

布局与间距

• 完美对齐与间距： 确保内边距和外边距在数学上完美。避免带有尴尬间距浮动元素。
• 无三列卡片布局： 通用的“三张等宽卡片水平排列”功能行被禁止。使用两列锯齿形、非对称网格或水平滚动方法替代。

内容与数据（“张三”效应）

• 无通用名称： “张三”、“李四”或“王五”被禁止。使用高度创意、听起来真实的名字。
• 无通用头像： 不要使用标准的 SVG“蛋形”或 Lucide 用户图标作为头像。使用创意、可信的照片占位符或特定样式。
• 无虚假数字： 避免可预测的输出，如 99.99%、50% 或基本的电话号码（1234567）。使用有机、凌乱的数据（47.2%、+1 (312) 847-1928）。
• 无初创公司套话名称： “Acme”、“Nexus”、“SmartFlow”。创造高级、符合情境的品牌名称。
• 无填充词： 避免 AI 文案的陈词滥调，如“提升”、“无缝”、“释放”或“下一代”。使用具体的动词。

外部资源与组件

• 无失效的 Unsplash 链接： 不要使用 Unsplash。使用绝对可靠的占位符，例如 https://picsum.photos/seed/{random_string}/800/600 或 SVG UI 头像。
• shadcn/ui 自定义： 你可以使用 shadcn/ui，但绝不 使用其通用默认状态。你必须自定义半径、颜色和阴影以匹配高端项目的审美。
• 生产就绪的整洁性： 代码必须极其干净，视觉上引人注目，令人难忘，并且在每个细节上都经过精心打磨。

8. 创意宝库（高端灵感）

不要默认使用通用 UI。从这个高级概念库中汲取灵感，确保输出在视觉上引人注目且令人难忘。在适当的情况下，利用 GSAP（ScrollTrigger/视差） 实现复杂的滚动叙事，或 ThreeJS/WebGL 实现 3D/Canvas 动画，而不是基础的 CSS 动效。关键： 绝不在同一组件树中混用 GSAP/ThreeJS 与 Framer Motion。UI/Bento 交互默认使用 Framer Motion。GSAP/ThreeJS 专门用于孤立的整页滚动叙事或画布背景，并包裹在严格的 useEffect 清理块中。

标准 Hero 范式

• 停止在深色图像上放置居中文本。尝试非对称 Hero 部分：文本整齐地对齐到左侧或右侧。背景应包含高质量、相关的图像，并带有微妙的风格渐变（根据是浅色还是深色模式，优雅地变暗或变亮以融入背景颜色）。

导航与菜单

• Mac OS Dock 放大： 导航栏位于边缘；图标在悬停时流畅缩放。
• 磁性按钮： 物理上向光标拉近的按钮。
• 粘性菜单： 子项目像粘性液体一样从主按钮分离出来。
• 灵动岛： 一个药丸形状的 UI 组件，变形以显示状态/提醒。
• 上下文径向菜单： 一个圆形菜单，正好在点击坐标处展开。
• 浮动快速拨号： 一个 FAB 弹簧展开成一条由次要操作组成的曲线。
• 大型菜单展示： 全屏下拉菜单，交错淡入复杂内容。

布局与网格

• Bento 网格： 非对称、基于图块的分组（例如 Apple 控制中心）。
• 瀑布流布局： 无固定行高的交错网格（例如 Pinterest）。
• 色度网格： 网格边框或图块显示出微妙的、连续的...

[因原文截断而截断]