Portfolio Maker:自主设计与工程技能
自主且自包含:此技能完全自主运行。它不依赖、委托或需要任何外部第三方设计或动画技能。所有美学直觉、排版数学、空间和谐、微交互动态、反AI俗套执行和组件原语均原生内置于此技能中。
🎯 主要目的与使命
消除业余、通用的“AI 俗套”作品集,为5类核心专业人士自主生成屡获殊荣、生产级作品集:
- 软件工程师与系统架构师(分布式系统、高吞吐量API、简洁的技术bento布局)
- 视频编辑、动态图形与创作者(病毒式展示片、前后调色对比、观看量指标)
- 产品设计师与UI/UX主管(设计系统、案例研究、高对比度瑞士排版、设计令牌分解)
- AI/ML 研究员与数据工程师(模型架构、arXiv论文、基准遥测、权重徽章)
- 代理机构、顾问与个体创业者(社会证明、客户评价、服务层级、无缝预订转化)
🚫 反AI俗套荣誉准则(严格执行)
生成的每个作品集在输出代码前必须通过此严格的美学过滤器:
1. 禁止的视觉俗套:
- ❌ 绝不使用俗气的紫色/紫罗兰霓虹渐变套路:标题文字不得使用
from-purple-500 via-indigo-500 to-pink-500。不得使用模糊的紫色背景光晕 (bg-purple-500/10 blur-3xl)。 - ❌ 没有扁平、无聊的灰色方块网格:避免使用默认的 Tailwind
bg-gray-100/border-gray-300且无深度或纹理的块。 - ❌ 没有过度饱和的激光边框:避免使用高强度的合成波霓虹描边。
2. 批准的精英调色板:
- 钛金单色(瑞士深/浅):深黑曜石画布 (
#09090b),凸起卡片层 (#121215配合backdrop-blur-md),发丝边框 (border-white/[0.08]),清爽白色标题 (#ffffff),锌合金灰色文本 (#a1a1aa),微妙的石板白聚光灯 (rgba(255,255,255,0.06))。 - 精密翡翠与石板色:黑曜石画布 (
#09090b),翡翠色在线状态指示器 (#10b981),单色卡片配微妙的薄荷悬停强调色。 - 国际电光钴:深炭画布 (
#0a0a0f),清爽白色排版,高对比度电光皇家蓝 (#2563eb) 交互目标和按钮。 - 温暖建筑沙色与浓缩咖啡色:暖奶油画布 (
#fafaf9),浓郁浓缩咖啡色标题 (#18181b),微妙的香槟/琥珀色 (#d97706) 强调色。 - 电影玫瑰与琥珀色:黑曜石
#0b0c10画布,高冲击力玫瑰 (#e11d48) 和暖琥珀 (#f59e0b) 强调色,适用于创意和视频展示片。
3. 禁止的AI套话文案:
- ❌ 禁止:“充满热情的开发人员,将创意转化为优雅的数字解决方案。”
- ❌ 禁止:“在设计、技术和同理心的交汇处进行创新。”
- ❌ 禁止:“以结果为导向的专业人士,擅长解决问题。”
- ✅ 要求:具体、以指标为驱动、注重影响力的陈述:
- “构建了分布式Go微服务,处理 120k req/s,p99 延迟 14ms。”
- “编辑了病毒式传播的长篇 YouTube 纪录片,产生了 7500 万+自然浏览量。”
- “主导了跨品牌 Figma 设计令牌系统,被 42 个工程团队采用。”
🧠 原生美学引擎(内置设计智能)
AI 必须将以下数学设计法则应用于每个元素:
1. 排版层次与视觉节奏
- 展示标题 (
text-4xl到text-6xl md:text-7xl):-
- 行高必须紧凑(
leading-[1.08]到leading-[1.12])。大字号松散行高显得业余。
- 行高必须紧凑(
-
- 字间距必须压缩(
tracking-tight或tracking-tighter)。
- 字间距必须压缩(
-
- 字体粗细:技术类用粗体或超粗体(
font-bold/font-extrabold);编辑类衬线用中等或半粗体(font-medium/font-semibold)。
- 字体粗细:技术类用粗体或超粗体(
-
- 正文(
text-base到text-lg):-
- 行高必须宽松(
leading-relaxed或leading-7)以确保可读性。
- 行高必须宽松(
-
- 行长(测量值):使用
max-w-xl或max-w-2xl限制正文字体宽度(每行 45–75 个字符)。绝不让段落横跨整个屏幕宽度。
- 行长(测量值):使用
-
- 文本对齐:绝不要将连续 3 行以上的正文居中对齐。 为符合人体工学的阅读习惯,使用左对齐。
-
- 精选字体搭配:
- 现代技术:
Inter或Geist Sans+JetBrains Mono(用于标签和代码)。 - 高冲击力创意:
Plus Jakarta Sans或Syne+Inter。 - 编辑与奢华:
Cormorant Garamond(衬线展示)+Inter(无衬线正文)。
- 现代技术:
2. 空间节奏与 8pt 数学网格
- 区块内边距:充足的纵向呼吸空间(
py-20 md:py-28)。紧凑的区块会使设计窒息。 - 布局堆叠:主要区块之间的垂直间距必须使用
space-y-24或space-y-28。 - 卡片网格:统一使用
gap-6或gap-8。 - 内容宽度容器:
- 编辑/极简:
max-w-4xl mx-auto px-6 - 开发 Bento:
max-w-5xl mx-auto px-4 sm:px-6 - 媒体展示:
max-w-6xl mx-auto px-4 sm:px-6
- 编辑/极简:
3. 表面高度与发丝边框科学
- 层级 0(画布):
#09090b(深色)/#fafaf9或#ffffff(浅色)。 - 层级 1(卡片基底):
#121215/bg-white dark:bg-zinc-900/60配合backdrop-blur-md。 - 层级 2(发丝边框):
border border-zinc-200/80 dark:border-zinc-800/80或border border-white/[0.08]。切勿使用沉重、浑浊的投影。 - 层级 3(微悬停):跟随光标的径向聚光灯(
rgba(255,255,255,0.06)),或微妙的边框增亮hover:border-zinc-400 dark:hover:border-zinc-700,加上微妙的提升hover:-translate-y-0.5 transition-all duration-300。
4. 交互细节与润色
- 在线状态指示器:
<div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20"> <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span> <span>接受 2026 年第一季度机会</span> </div> - 一键复制邮箱药丸(带视觉反馈): 提供即时剪贴板复制功能,并带有确认“已复制!”的工具提示过渡。
- 双模式主题切换器:
始终包含一个可工作的主题切换开关(深色/浅色),带有图标变形和
localStorage持久化。
📦 已验证的组件库(直接访问)
该技能包含经过验证、生产就绪的 TSX 原语和完整目录:
1. 特色头部 (components-library/heroes/):
ImageStreamHero.tsx:具有深度的消失点流式轨道(创作者和视频编辑)。PerspectiveTunnelHero.tsx:具有实时指标的 3D Z 轴空间透视(工程师和架构师)。ProductRailGallery.tsx:具有摆动物理效果的交互式衣架(电商与时尚)。TiltedGridHero.tsx:向观看者弯曲的曲线 3D 图像流(UI/UX 设计师和摄影师)。PrismHero.tsx:彩色水晶折射着色器美学(艺术总监和奢华作品集)。TigerTearRevealHero.tsx:交互式泪痕揭示标语效果(高冲击力创意人员)。AgencyHero01.tsx:高信任度代理机构头部,带有社交头像和评分徽章(自由职业者和代理机构)。ResponsiveHeroBanner.tsx:具有玻璃态导航的电影级横幅(创始人和主管)。CenteredImageFanHero.tsx:带有 3 张图片扇形拼贴的突出标题(产品设计师)。
2. 独立交互原语 (components-library/):
- 背景:
backgrounds/AuroraBackground.tsx(微妙的翡翠/青色/石板色波浪,无霓虹紫色)。 - 交互卡片:
cards/SpotlightCard.tsx(鼠标跟踪发光)、cards/Card3D.tsx(透视倾斜)、cards/BorderBeam.tsx(动画发丝边框光束)、cards/Meteors.tsx(流星粒子)。 - 区块与布局:
sections/BentoGrid.tsx(非对称响应式网格)、sections/InfiniteMarquee.tsx(无缝技术/标志滚动条)、sections/BeforeAfterSlider.tsx(交互式图片/视频比较)、sections/VideoModal.tsx(电影级视频弹出窗口)、sections/TerminalWidget.tsx(模拟交互式 CLI)。 - UI 控件:
ui/FloatingNav.tsx(浮动玻璃态药丸导航栏)、ui/ShimmerButton.tsx(闪烁动作按钮)、ui/TextGenerateEffect.tsx(交错文字揭示)、ui/CopyEmailButton.tsx(一键复制药丸)、ui/ThemeToggle.tsx(深色/浅色主题切换)。
3. 主组件索引:
- 在
components-library/catalog/INDEX.md中访问完整的 21st.dev 主目录,包含 11,750 多个跨 22 个类别(按钮、头部、图库、功能、定价、页脚、FAQ 等)分类的组件。
4. 官方 shadcn MCP 服务器(零 API 密钥):
- AI 使用官方的 shadcn MCP 服务器(
npx shadcn@latest mcp),该服务器 100% 免费、开源,且不需要任何 API 密钥。 - 目录中的任何组件都可以通过以下方式安装:
npx shadcn@latest add "https://21st.dev/r/<author>/<component-name>" - 永远不需要付费的 21st.dev MCP 或 API 密钥。
5. 高级模板与动效设计灵感:
AI 可以主动从世界上最高级的设计生态系统中汲取建筑模式、动态运动和高效转换布局:
- VibeUI (
vibeui.dev):现代组件合成、触感卡片堆叠、交互式徽章、浮动控制药丸和美学布局原语。 - Trical (
trical.so):超简洁、高转化率的作品集模板、杂志级排版、微妙的分隔线和编辑级项目案例研究。 - Motion Site (
motion.site.ai):流畅的微动画、动态标题揭示、弹簧物理和有机过渡曲线。 - 21st.dev 与 Aceternity UI:包含 11,750 多个 shadcn 兼容组件和空间 3D 交互原语的主目录。
⚡ 双重交付模式
AI 根据用户需求支持两种灵活的交付格式:
模式 A:完整的 React + Vite + Tailwind(TypeScript)代码库(默认)
生成一个完整的、模块化的、企业级项目结构:
my-portfolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
├── main.tsx
├── App.tsx
├── index.css
├── components/
│ ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
│ └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
└── types/index.ts
模式 B:即时独立单文件 HTML/Tailwind/Lucide/JS
当用户想要零设置、即时本地浏览器预览或即时托管(例如 GitHub Pages)时:
- 生成一个单独的、格式精美的、自包含的
index.html。 - 包含 Tailwind CSS CDN、Google Fonts、Lucide Icons CDN 和用于主题切换、复制反馈、模态弹出窗口和悬停交互的 vanilla JS。
- 请参阅
templates/developer-bento/index.html、templates/creative-minimalist/index.html和templates/video-editor-showreel/index.html中的生产级参考实现。
🛠️ 逐步执行工作流程
┌────────────────────────────────────────────────────────┐
│ 步骤 1:信息采集与简历提取 │
│ 提取指标、角色、项目、技术栈 │
│ (或执行 3 批后备问卷) │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 步骤 2:强制性交互式对齐 │
│ 询问:美学、主题模式、头部和组件选择 │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 步骤 3:组件选择与架构 │
│ 从 components-library/ 组装 21st.dev 原语 │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 步骤 4:生产代码生成 │
│ 生成 React + Vite(默认)或独立 HTML │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 步骤 5:审核与运行说明 │
│ 检查反俗套规则、验证构建、提供命令 │
└────────────────────────────────────────────────────────┘
步骤 1:信息采集协议
- 如果用户提供简历或 LinkedIn 摘要:解析真实的指标、职业时间线、前 3-4 个项目和技术能力。
- 如果没有提供简历:切勿编造凭据。执行 references/questionnaire.md 中的 3 批问卷:
- 第 1 批:身份与目标角色
- 第 2 批:前 2-3 个项目与具体数字
- 第 3 批:社交与联系方式
步骤 2:强制性交互式对齐(请勿跳过)
除非用户事先明确指定了视觉风格和组件,否则暂停并呈现交互式对齐:
“在我生成您的作品集之前,让我们自定义视觉设计和交互组件:
- 视觉风格 / 美学:
- 光滑技术 / 深色 Bento(Linear / 21st.dev 风格 — 黑曜石画布、聚光灯悬停卡片、发丝边框)。
- 清洁极简 / 瑞士现代(Dieter Rams / Apple 风格 — 充足空白、精致排版、微妙线条)。
- 高对比度编辑(衬线标题、工作室美学、杂志风格案例研究)。
- 电影创作者 / 动态(深暗画布、丰富的视频展示嵌入、观看量徽章)。
- 新粗野主义