Communitygithub.com

ShaysFrame/個人品牌系統

Shay (ShaysFrame) 個人作品集與品牌系統。用於建置、設計或改善 Shay 的個人作品集網站、部落格、專案頁面、履歷頁面或任何自我推廣的網路內容。觸發詞:「portfolio」、「my site」、「project page」、「about me」、「resume page」、「hero section」、「personal brand」、「shay.pub」。

個人品牌系統 是什麼?

這個技能定義了 M. Mahafuj Rahman(線上暱稱 Shay)的個人作品集與品牌建置系統。系統涵蓋身份識別、設計理念(包含編輯式美學、高對比配色、排版驅動的風格)、色彩與字體規範、動態互動分層原則,以及完整的網站結構與技術棧(Astro + TypeScript + CSS 自訂屬性)。此外,還指定了專案展示的優先順序與內容架構,以及寫作語氣和元件開發指引。此技能支援 Astro 框架、React/Preact 互動元件,並部署於 Vercel,專注於打造一份能展現深度、廣度與工藝的個人作品集,而非僅是技術列表。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ShaysFrame/my/tree/HEAD/tools/portfolio-skill

在你喜歡的 AI 中提問

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

說明文件

M. MAHAFUJ RAHMAN 的作品集 — 品牌與建置系統

你正在建置 M. Mahafuj Rahman 的個人作品集,他是一位擁有廣泛已發布專案(涵蓋行動裝置、網頁、後端、物聯網與機器學習)的全端開發者。這個作品集必須傳達深度、廣度與工藝,而不僅僅是列出技術。


身份識別

姓名:M. MAHAFUJ RAHMAN(線上暱稱 Shay) GitHub:ShaysFrame 網站:shay.pub
技術定位:全端通才 — Flutter、Vue、Astro、React、Django、PHP、Docker、YOLO/CV
職涯目標:透過展示真實已發布的作品,在一流科技公司任職


設計理念

美學:編輯式。高對比。排版驅動。立即吸引目光。
氛圍:乾淨優雅 — 像雜誌封面,而非 SaaS 登陸頁面。
指導原則:每個元素若不是為了吸引注意,就應該被移除。

色彩調色盤

--color-bg:        #0a0a0a   /* 近乎黑色的背景 */
--color-surface:   #111111   /* 卡片、面板 */
--color-border:    #222222   /* 微妙的分隔線 */
--color-text:      #f5f5f5   /* 主要文字 — 非純白的米白色 */
--color-muted:     #777777   /* 次要/元數據文字 */
--color-accent:    #ffffff   /* 純白 — 節制使用以創造最大對比 */
--color-highlight: #e8e8e8   /* 懸停狀態、選取項目 */

沒有色彩強調色。沒有漸層。黑色、白色和對比度完成所有工作。

排版

  • 展示/主視覺:一個大膽的襯線字體或高對比度的怪誕展示字體。 建議:Playfair Display、Editorial New、PP Neue Montreal、Instrument Serif
  • 內文/UI:乾淨的幾何無襯線字體。Inter、DM Sans 或 Geist
  • 程式碼:JetBrains Mono 或 Geist Mono
  • 規則:更少的字重,更有意圖的字級。使用比例,而非顏色,來建立層級結構。

動態與互動

理念:動態應該感覺是必然的,而非裝飾性的。每個動畫都回答「這個為什麼會動?」—— 為了引導注意力、指示狀態、或獎勵滾動行為。

第一層 — CSS(永遠使用,無需依賴)

  • 頁面轉場:使用 Astro 內建的 <ViewTransitions /> — 零 JavaScript 成本
  • 懸停狀態:透明度變化、底線揭示、微幅縮放 (1.0 → 1.02)
  • 焦點狀態:使用 --color-accent 的可見外框
  • 進入動畫:使用 CSS @keyframes fadeUp 處理視窗上方內容

第二層 — 滾動驅動動畫(優先使用 CSS)

  • 在瀏覽器支援的情況下,使用原生 CSS animation-timeline: scroll()
  • 備援方案:一個小型的 .ts 工具中的 IntersectionObserver — 不需要函式庫
  • 專案卡片:在進入視口時,以交錯方式執行 fade + translateY(24px → 0)
  • 區塊標題:在滾動時從左側滑入

第三層 — 主視覺「驚嘆」元素(僅限一個,且只有一個)

  • 主視覺獲得一個標誌性的動態效果。按偏好順序選項如下:
    1. 交錯字母/單詞揭示 — 主視覺名稱逐字動畫顯示(僅限 CSS)
    2. 噪點/顆粒覆蓋層 — 在深色背景上使用 CSS 動畫顆粒紋理(僅限 CSS)
    3. 微妙的 3D 傾斜 — 專案卡片在滑鼠移動時略微傾斜(純 JavaScript,約 15 行)
    4. Three.js / React Three Fiber — 僅在需要特定 3D 素材時使用(例如旋轉的幾何標誌)。使用 3D-Animation-Creator 或 3D-Website-Asset-Generator 技能分別產生素材,然後將其作為單一隔離元件嵌入。

絕對不要做的事

  • 全頁 Three.js 背景(降低效能,干擾內容)
  • 除了主視覺區域外,任何地方使用循環動畫
  • 彈性彈簧物理效果(不適合編輯式美學的調性)
  • 文字上的視差滾動
  • 僅僅因為教學示範而加入動態

網站結構

/                  → 主視覺 + 精選專案預覽 + 簡短介紹
/about             → Shay 是誰、背景、理念、技能概覽
/projects          → 所有專案的網格,附帶技術棧標籤和簡短描述
/projects/[slug]   → 單一專案深入介紹(問題、解決方案、技術棧、連結、螢幕截圖)
/resume            → 內嵌履歷檢視 + 可下載的 PDF 連結
/blog              → 部落格文章列表(已存在於 Astro 中)
/blog/[slug]       → 單篇文章(已存在)

技術棧

  • 框架:Astro(SSG,以 Markdown 為優先,預設零 JavaScript,出色的 SEO)
  • 元件語言:Astro 元件 + 用於互動孤島的 React/Preact (.tsx)
  • 語言:全面使用 TypeScript — .ts、.tsx、.astro 搭配型別化的 frontmatter。絕不使用 .js 或 .jsx
  • 樣式:CSS 自訂屬性(除非使用者特別要求,否則不使用 Tailwind)
  • 部署:Vercel
  • 內容:用於部落格文章和專案的 Astro Content Collections

專案展示優先順序

在建置專案頁面時,請按此順序優先處理這些專案(最令人印象深刻者優先):

  1. Qifa — 多應用程式生態系統(客戶端、商店、辦公室、Docker、自訂記錄儀表板、ChatWoot)
  2. Open RTMS — 使用 YOLO v8n 人臉偵測的即時系統(機器學習角度罕見且令人印象深刻)
  3. XueHanYu — 全端(Vue + Django),中文學習平台
  4. NoorConnect — 應用程式 + 後端 + 韌體(物聯網/嵌入式對於網頁開發者來說較罕見)
  5. Jidian Daojia — Flutter + PHP + uniapp,多平台
  6. LittleLemon — Meta 專業證書畢業專案(經認證的作品)

對於每個專案頁面,請按以下結構組織內容:

  1. 一句話鉤子(它解決了什麼問題,而非使用了什麼技術)
  2. 技術棧徽章
  3. 挑戰 / 有趣之處
  4. 做出的關鍵決策
  5. 連結(GitHub、線上展示(如有))

寫作語氣

  • 直接。自信。無廢話。
  • 在適當情況下使用第一人稱(「我建立了...」、「我選擇了...因為...」)
  • 避免使用:「對...充滿熱情」、「自我驅動」、「結果導向」、「運用綜效」
  • 技術細節 > 模糊宣稱。說「建立了一個使用 YOLO v8n 的即時人臉偵測管道」,而不是「從事電腦視覺專案」

元件指南

為此作品集產生 Astro 元件時:

  • 預設匯出風格:帶有 --- frontmatter 的 .astro 檔案
  • 使用上方調色盤中的 CSS 自訂屬性
  • 行動裝置優先的響應式設計
  • 語意化的 HTML(正確使用 <article>、<section>、<nav>、<main>)
  • 除了動態值之外,不使用內聯樣式
  • 透過 CSS 動畫 — 將關鍵幀放在 global.css 或限域的 <style> 區塊中
  • 互動孤島:使用 client:visible 指令,以便只在需要時載入 JavaScript

應避免事項

  • 像「嗨,我是個熱愛寫程式的開發者」這種一般化的主視覺文字
  • 紫色漸層、到處都是圓角、藍色的 CTA 按鈕
  • 雜亂的版面 — 擁抱白色(或黑色)空間
  • 在沒有上下文的情況下列出你接觸過的每一項技術
  • 讀起來像履歷表的文案;這是一篇敘事文,不是清單

相關技能