Communitygithub.com

portfolio-maker

为工程师、设计师、编辑、研究员或顾问构建生产级个人作品集,支持React应用或单个HTML文件。

portfolio-maker 是什么?

该AI技能可自主生成生产级个人作品集,专为软件工程师、视频编辑、UI/UX设计师、AI/ML研究员、自由职业者等五类核心专业人士设计。它内置了严格的反“AI 俗套”美学过滤器,禁止使用紫色霓虹渐变、扁平灰色网格和空洞的套话文案,强制采用钛金单色、精密翡翠、国际电光钴等精英调色板,以及基于8pt网格和数学排版法则的设计系统。技能支持React + Vite + Tailwind(TypeScript)完整项目代码库或单文件HTML两种交付模式,并包含丰富的组件库,如 SpotlightCard、BentoGrid、FloatingNav 等,可直接通过 shadcn MCP 服务器免费安装。最终作品集可在本地预览、托管至GitHub Pages,并提供详细的构建和运行说明。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/NaitikGrover/portfolio-maker/tree/HEAD

在你喜欢的 AI 中提问

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

文档

Portfolio Maker:自主设计与工程技能

自主且自包含:此技能完全自主运行。它不依赖、委托或需要任何外部第三方设计或动画技能。所有美学直觉、排版数学、空间和谐、微交互动态、反AI俗套执行和组件原语均原生内置于此技能中。


🎯 主要目的与使命

消除业余、通用的“AI 俗套”作品集,为5类核心专业人士自主生成屡获殊荣、生产级作品集:

  1. 软件工程师与系统架构师(分布式系统、高吞吐量API、简洁的技术bento布局)
  2. 视频编辑、动态图形与创作者(病毒式展示片、前后调色对比、观看量指标)
  3. 产品设计师与UI/UX主管(设计系统、案例研究、高对比度瑞士排版、设计令牌分解)
  4. AI/ML 研究员与数据工程师(模型架构、arXiv论文、基准遥测、权重徽章)
  5. 代理机构、顾问与个体创业者(社会证明、客户评价、服务层级、无缝预订转化)

🚫 反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:信息采集协议

  1. 如果用户提供简历或 LinkedIn 摘要:解析真实的指标、职业时间线、前 3-4 个项目和技术能力。
  2. 如果没有提供简历:切勿编造凭据。执行 references/questionnaire.md 中的 3 批问卷:
    • 第 1 批:身份与目标角色
    • 第 2 批:前 2-3 个项目与具体数字
    • 第 3 批:社交与联系方式

步骤 2:强制性交互式对齐(请勿跳过)

除非用户事先明确指定了视觉风格和组件,否则暂停并呈现交互式对齐:

“在我生成您的作品集之前,让我们自定义视觉设计和交互组件:

  1. 视觉风格 / 美学:
    • 光滑技术 / 深色 Bento(Linear / 21st.dev 风格 — 黑曜石画布、聚光灯悬停卡片、发丝边框)。
    • 清洁极简 / 瑞士现代(Dieter Rams / Apple 风格 — 充足空白、精致排版、微妙线条)。
    • 高对比度编辑(衬线标题、工作室美学、杂志风格案例研究)。
    • 电影创作者 / 动态(深暗画布、丰富的视频展示嵌入、观看量徽章)。
    • 新粗野主义

相关技能