Communitygithub.com

portfolio-maker

為工程師、設計師、剪輯師、研究員或顧問打造可在生產環境中使用的個人作品集網站,可產出 React 應用程式或單一 HTML 檔案。

portfolio-maker 是什麼?

這個「Portfolio Maker」技能是一個完全自主且自成一體的 AI 作品集生成工具,專為消除「AI 生成的低劣設計」而設計。它能自動為軟體工程師、影片剪輯師、產品設計師、AI/ML 研究員與自由顧問等五種核心專業角色,產出獲獎等級的專業作品集。此技能內建了強大的美學引擎,透過嚴格的視覺與文案過濾器,禁止使用常見的紫色霓虹漸層等陳腔濫調,強制採用如精密鈷藍、暖沙色等經審核的高級配色。其數學化設計系統涵蓋了排版韻律、8pt 網格系統、表面層次與微互動細節,並提供如即時狀態指示燈、一鍵複製電子郵件與深淺色主題切換等實用元件。此技能支援兩種交付模式:預設模式會產生完整的 React + Vite + Tailwind 專案結構;零設定模式則會產出單一的獨立 HTML 檔案,方便用戶立即在瀏覽器中預覽或託管。此技能基於開源的 shadcn MCP 伺服器與 21st.dev 等頂級設計生態系統的元件庫,無需任何付費 API 金鑰,即可存取超過 11,750 個生產就緒的 TSX 元件,並從這些平台汲取現代佈局與動感設計的靈感。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Portfolio Maker:主權設計與工程技能

主權與自給自足:此技能以完全自主的方式運作。它不依賴、委託或需要任何外部第三方的設計或動畫技能。所有美學直覺、排版數學、空間和諧、微互動動態、反劣質設計強制執行以及元件基礎,都已原生內建於此技能中。


🎯 主要目標與使命

旨在消除業餘、千篇一律的「AI 劣質設計」作品集,並為以下 5 種核心專業角色自主產出獲獎等級、可投入生產環境的作品集:

  1. 軟體工程師與系統架構師(分散式系統、高吞吐量 API、簡潔的技術 Bento 風格)
  2. 影片剪輯師、動態圖形設計師與創作者(爆紅 Showreel、調色前後對比、觀看次數指標)
  3. 產品設計師與 UI/UX 主管(設計系統、案例研究、高反差瑞士排版、設計 Token 解析)
  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) 強調色,適用於創意與影片 Showreel。

3. 禁止的 AI 空洞文案:

  • ❌ 禁止:「充滿熱情的開發者,將想法轉化為優雅的數位解決方案。」
  • ❌ 禁止:「在設計、科技與同理心的交匯點持續創新。」
  • ❌ 禁止:「以結果為導向的專業人士,擅長解決問題。」
  • ✅ 必須使用:具體、以數據為驅動、強調影響力的陳述:
    • 「建構了分散式 Go 微服務,在 p99 延遲 14 毫秒下處理了 120k req/s。」
    • 「剪輯了爆紅的長篇 YouTube 紀錄片,累積了 7,500 萬以上的自然觀看次數。」
    • 「主導了跨多品牌的 Figma 設計 Token 系統,並在 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
    • 媒體 Showreel 風格:max-w-6xl mx-auto px-4 sm:px-6

3. 表面層次與髮絲線邊框科學

  • Layer 0 (畫布):#09090b(深色)/ #fafaf9 或 #ffffff(淺色)。
  • Layer 1 (卡片基底):#121215 / bg-white dark:bg-zinc-900/60 搭配 backdrop-blur-md。
  • Layer 2 (髮絲線邊框):border border-zinc-200/80 dark:border-zinc-800/80 或 border border-white/[0.08]。絕不使用沉重、渾濁的投影。
  • Layer 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 主目錄,其中包含橫跨 22 個類別(按鈕、英雄區塊、畫廊、功能、定價、頁腳、常見問題等)的 11,750 多個已分類元件。

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,以及用於主題切換、複製回饋、模態彈出視窗和懸停互動的純 JavaScript。
  • 請參閱 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 風格 — 寬敞留白、精緻排版、微妙線條)。
    • 高反差編輯風格(襯線字體標題、工作室美學、雜誌式案例研究)。
    • 電影級創作者 / 動感風格(深邃暗色畫布、豐富的影片 Showreel 嵌入、觀看次數徽章)。
    • **新粗獷主義

相關技能