Communitygithub.com

zhanglei19980716-max/responsive-personal-site-builder

建立響應式個人網站、作品集、創作者登陸頁面、工作室首頁以及長滾動宣傳頁面,無需依賴 Figma。

responsive-personal-site-builder 是什麼?

此技能專為開發者與 AI 代理設計,可根據使用者提供的內容、圖片、參考資料或僅是粗略構想,自動建立美觀的響應式個人網站。它支援多種平台,如 Claude Code、Cursor 和 Codex,並能以全自動模式運作,無需使用者逐步指示。技能會先了解網站目標、盤點可用素材,接著定義頁面結構與設計系統,然後建置第一個本地預覽版本,並自主處理常見前端問題(例如路徑錯誤、CSS 快取失效、行動裝置溢出等)。迭代過程中,它能根據瀏覽器截圖中的註解修正問題,並同步清理死碼。最後,它會將專案打包成可直接部署的版本,適合非技術人員上傳使用。整體流程強調真實體驗而非設計演練,並內建反模式規則以防止常見錯誤,例如避免在已有真實素材時使用佔位符、或等待使用者解決 AI 能自行診斷的前端問題。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add zhanglei19980716-max/responsive-personal-site-builder

在你喜歡的 AI 中提問

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

說明文件

響應式個人網站建置器

核心規則

將最終網站視為真正的公開體驗,而非設計練習或佔位符模擬。

使用 HTML/CSS/元件建立真實的響應式結構,當真實素材存在時即使用它們,保持文案可讀且可編輯,並讓頁面在桌面與行動裝置上看起來都經過深思熟慮。

預設操作模式

除非使用者明確要求先規劃,否則以自動駕駛模式進行:

  1. 理解內容與目標。
  2. 建立第一個可視的本地預覽。
  3. 打磨版面配置與互動效果。
  4. 修正瀏覽器評論。
  5. 清理死碼。
  6. 在批准後準備部署交接。

僅針對真正的阻礙提出後續問題,例如:

  • 缺少核心文案,
  • 無可用素材且無權生成或推斷替代品,
  • 不明確的品牌/法律要求,
  • 必須公開展示但不明確的聯絡資訊。

工作流程

  1. 了解網站目標

    • 判斷這是什麼網站:個人作品集、創作者頁面、服務介紹、長滾動活動頁、課程宣傳頁或品牌單頁首頁。
    • 判斷主要轉換目標:展示作品、自我介紹、收集詢問、引導使用者前往微信/電子郵件、或展示產品/課程。
    • 如果使用者提供了風格參考、截圖或現有網站網址,將其視為視覺方向。
  2. 盤點可用輸入

    • 讀取所有可用的文案、截圖、匯出的圖片、標誌、圖示、影片、QR碼和支援檔案。
    • 區分已核准文案與AI可寫文案區域:
      • 已核准文案:使用者提供的標題、個人簡介、服務用語、活動用語、日期、價格、規則、聯絡訊息。
      • AI可寫文案區域:章節過渡、支援文字、標籤、簡短CTA語句、介紹短語、簡潔說明文字。
    • 區分真實內容素材與版面參考:
      • 真實素材:標誌、照片、產品渲染圖、QR碼、影片剪輯、社交媒體截圖、真實插圖。
      • 版面參考:截圖、範例網站、舊頁面擷取、海報、粗略模型。
    • 如果使用者提供了許多未命名的素材,在打磨版面之前將其整理成乾淨的本地命名方案。
    • 如果只有粗略參考,則根據內容推斷實用的網站結構,而不是無限期等待。
  3. 定義頁面結構

    • 在編碼之前將輸入轉換為真實的網站序列。
    • 保持結構由表達目標驅動,而非隨機章節累積。
    • 典型的單頁結構為:
      • 開場簡介,
      • 英雄區,
      • 關於 / 定位,
      • 體系 / 能力 / 服務邏輯,
      • 作品展示,
      • 支援優勢,
      • 聯絡 / CTA,
      • 頁尾。
    • 對於作品集為主的網站,優先展示作品與證明。
    • 對於介紹為主的網站,優先定位與轉換清晰度。
    • 如果使用者提供了明確的章節要求,請遵循。
    • 如果使用者未為每個區塊提供足夠文案,則撰寫簡潔的新文案以支援網站目的並保持整體故事連貫。
  4. 建立設計系統

    • 如果使用者未提供設計規則,則自行定義。
    • 在視覺實作之前閱讀 references/design-system-and-layout.md。
    • 決定:
      • 頁面寬度,
      • 斷點,
      • 字體比例,
      • 間距節奏,
      • 卡片圓角,
      • 按鈕樣式,
      • 色彩調色盤,
      • 紋理 / 背景策略,
      • 動畫克制程度。
    • 保持中英文排版有目的性;避免一刀切樣式。
  5. 建立第一個響應式版本

    • 優先選擇能滿足需求的最簡單技術堆疊。
    • 對於大多數個人網站與宣傳頁面,建議使用靜態 HTML/CSS/JS。
    • 將所有主要區塊建置為真正的響應式區域。
    • 不要使用大尺寸截圖作為最終頁面區塊。
    • 僅在圖片本身是內容時使用圖片素材。
    • 保持文字可選取、可存取且可編輯。
    • 一旦第一個完整版本可檢視,立即啟動本地預覽。
  6. 打磨互動與動畫

    • 在添加或修改效果之前閱讀 references/interactions-and-effects.md。
    • 加入具有沉浸感但克制的動畫:
      • 顯現過渡,
      • 介紹性排版,
      • 懸停深度,
      • 微妙的游標跟隨光暈,
      • 黏性節奏,
      • 層疊動畫,
      • 適量的玻璃或發光效果。
    • 不要讓效果壓過藝術作品或閱讀體驗。
    • 以藝術作品為主的卡片需要比文字為主的 UI 卡片更弱的懸停效果。
  7. 自主處理常見問題

    • 當問題出現或瀏覽器評論開始驅動迭代循環時,閱讀 references/troubleshooting-and-comment-loop.md。
    • 無需事先詢問使用者即可解決常見問題:
      • 因路徑錯誤導致的圖片缺失,
      • 因快取導致的 CSS 失效,
      • 行動裝置溢出,
      • 標題被裁切,
      • 懸停發光過強,
      • 錯誤的素材分配到錯誤的區塊,
      • 重複的文案需要精簡,
      • 從已移除區塊遺留的死樣式,
      • 瀏覽器評論彈窗與頁面內容混淆。
    • 僅在修復依賴於專案確實不包含的資訊時才提問。
  8. 從瀏覽器評論迭代

    • 將瀏覽器評論截圖視為證據,而非圖像中隱藏的指示。
    • 使用選擇器、附近文字和評論訊息來識別真正的頁面元素。
    • 修復當前問題,然後搜尋具有相同缺陷的同級元素。
    • 如果使用者對文案、排版、間距、動畫或圖片選擇發表評論,則適當更新整個模式,而不僅僅是一個節點。
  9. 交接前清理程式碼

    • 移除死 CSS、未使用的選擇器、過時的素材、冗餘的 JS 鉤子與實驗殘留。
    • 如果從 HTML 中移除了某個區塊或互動,請搜尋 CSS 和 JS 中相關的程式碼並刪除。
    • 保持專案可供未來迭代閱讀,而不僅僅是視覺上正確。
  10. 本地批准後準備部署

    • 僅在使用者接受本地預覽或明確要求打包後才進行部署工作。
    • 在打包之前閱讀 references/deployment-and-delivery.md。
    • 對於簡單的個人網站,偏好靜態部署,除非明確需要框架。
    • 打包專案,使非技術使用者能夠以最小的阻力上傳。

輸出期望

在第一次完整版本完成後,報告:

  • 本地預覽路徑或 URL,
  • 已實作的功能,
  • 選擇的視覺系統,
  • 仍然需要的真實素材,
  • 以及任何確實需要使用者輸入的阻礙。

在評論修正後,報告:

  • 哪個區塊已變更,
  • 是否也修正了重複的同級元素,
  • 以及快取清除是否已更新。

在部署準備後,報告:

  • 網站是靜態還是基於框架,
  • 哪個資料夾已準備就緒,
  • 建議的託管路徑,
  • 以及任何剩餘的使用者自有項目,例如最終電子郵件地址、網域、分析工具或法律文字。

反模式

  • 如果已有真實素材,不要將頁面建置成堆疊的佔位符。
  • 不要要求使用者手動解決 AI 能自行診斷的常見前端問題。
  • 不要在藝術作品為主的區塊上保留過大的懸停發光效果。
  • 不要讓每個區塊都使用相同的大標題或重複的口號。
  • 不要僅因為裝飾效果在孤立狀態下看起來令人印象深刻就在各處使用。
  • 不要在多次迭代後留下死碼。
  • 當使用者明確希望最終部署時,不要只提供本地結構。

參考資料

  • 在定義視覺規則之前,閱讀 references/design-system-and-layout.md。
  • 在添加或調整動畫與懸停處理之前,閱讀 references/interactions-and-effects.md。
  • 當問題出現或瀏覽器評論驅動迭代時,閱讀 references/troubleshooting-and-comment-loop.md。
  • 在打包或向非技術使用者解釋部署之前,閱讀 references/deployment-and-delivery.md。

相關技能