Communitygithub.com

作品集建置

從一個內容檔案和三種經過驗證的頁面網格中,建置或重建設計師的個人作品集網站,讓審閱者在 30 秒內了解其內容。

作品集建置 是什麼?

「作品集建置」技能旨在為設計師、藝術總監、插畫家、動態與 3D 藝術家、攝影師及電影製作人,快速生成一個結構清晰、易於理解的靜態作品集網站。它能根據單一的 `portfolio.json` 內容檔案,並讓使用者從三種精心設計的頁面佈局(固定側邊欄搭配滿版作品、等寬雙欄網格、或每個專案一頁長篇案例研究)中選擇,產生純 HTML/CSS 的靜態網站,無需依賴任何框架或建置工具。此技能的價值在於專注於「結構」而非「外觀」——它確保作品集在初次瀏覽的 30 秒內,就能清楚呈現「你是誰」、「你做什麼」、「你的作品」以及「如何聯繫你」,而字體、色彩、邊角圓潤度與間距則留給設計者自主決定。技能支援透過 `--compare` 參數同時生成三種網格供比較,並會在建置後自動輸出「30 秒審計清單」與「待填補的資訊空缺」,協助使用者逐步完善作品集。它適用於 Claude Code、Cursor 等以檔案為基礎的開發環境,也適合與 `portfolio-audit` 技能搭配使用。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/adrituyo/30s/tree/main/skills/portfolio-build

在你喜歡的 AI 中提問

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

說明文件

作品集建置 是做什麼的?

一份作品集在初次造訪時大約只有 30 秒的關注時間。此技能建置的作品集能善用這 30 秒:第一眼就讓訪客知道你是誰、你做什麼,旁邊就是你的真實作品,每個專案中你的角色都清楚陳述,並提供一個明確的聯絡方式。

它修復的是結構,而將外觀留給設計者本人。三種網格決定內容的位置與順序。字體、顏色、圓角與間距都由他們決定,並集中在一個小區塊中設定。使用此技能建置的兩個作品集,讀起來應該感覺相同,但看起來卻完全不一樣。

以下路徑皆相對於此技能的資料夾。

運作方式

一個檔案 portfolio.json 包含所有內容:這個人是誰、專案、選擇的網格以及外觀設定。一個指令就能將它轉換成靜態網站(純 HTML 和 CSS,無框架,無需安裝):

python3 scripts/build.py path/to/their-site/portfolio.json

網站會產生在內容檔案旁邊。腳本接著會印出兩份清單:一份是 30 秒審計仍然會標記出的問題,每一行都對應一個規則編號(references/rules.md 中有十七條規則,每條一行);另一份是所有仍在等待填入事實的 [插槽]。將兩者都視為待辦事項清單。

步驟

1. 釐清作品集的用途

詢問,或從你取得的資訊中推斷:

  • 目標對象。 作品集所針對的職位或客戶。它決定了標題、順序以及要省略的內容。
  • 作品。 哪些專案,以及每個專案的:內容是什麼、他們的角色、為誰而做、年份、他們決定的一件事及其結果。
  • 素材。 圖片和影片的來源。

如果他們有現有的網站,先閱讀它並沿用其中的內容。如果 portfolio-audit 技能可用且他們有一個上線的網站,先執行該技能可以精確告訴你需要更改什麼。

只詢問你找不到的資訊。一個擁有圖片資料夾和 LinkedIn 頁面的人,已經提供了大部分資訊。如果沒有人可以回答,就繼續使用你已有的資訊,並使用插槽(步驟 3)。

如果設計者對某個素材不確定(例如草圖、學生專案、舊作品),就將其排除。他們懷疑它是有原因的,而作品集的好壞取決於其中最弱的作品。說明你遺漏了什麼以及原因。三個強而有力的專案就是一個完整的作品集;不要為了湊到四個而塞入不重要的內容。

2. 讓設計者選擇網格

閱讀 references/grids.md。它說明了三種網格以及每種網格適合誰。網格決定了整個網站的閱讀方式,所以這是設計者的選擇,而不是你的。你的職責是讓選擇變得簡單。

在建置之前,用一則簡短的訊息列出這三種網格,每種一行,說明你推薦哪一種用於他們的作品和目標對象以及原因,然後詢問他們想要哪一種。將此與你在步驟 1 中需要詢問的任何其他內容結合起來,這樣只會有一輪問題,而不是兩輪。

  • 如果他們已經指定了一種網格,就直接使用,不要再重新提出問題。
  • 如果他們選擇了與你推薦不同的網格,就建置他們選擇的。如果這會帶來影響,請說明一次(例如,index 沒有地方放置決策和結果),然後就放下。
  • 如果他們不確定,或者沒有人可以回答,就繼續執行你的推薦,並在步驟 5 中使用 --compare 參數建置,這樣三種網格都會產生,可以並排開啟。

稍後切換網格只需要修改檔案中的一個詞,所以沒有人會被鎖定。這是一個輕鬆提供選擇的理由,而不是跳過它的理由。

3. 撰寫內容檔案

複製 assets/example/portfolio.json 作為起點,並閱讀 references/content.md 以了解每個欄位。將它放在將成為網站的資料夾中,圖片放在它旁邊。此範例使用 case 網格;對於 index 和 columns 網格,decision 和 result 是可選的,而且很少需要前後對照行。

如何撰寫最重要的部分:

  • 標題: 一句話說明他們做什麼以及為誰而做,並包含一個事實。這句話不應該適合放在任何其他人的網站上。「金融科技應用程式的產品設計師。八年經驗,最近在 Ledger 主導儲蓄流程。」而不是「充滿熱情的跨領域創意人,致力於打造體驗。」
  • 證明: 緊接在標題之後,列出三到四個最有力的名稱或數字。
  • 順序: 最符合目標對象的專案排在第一位,無論其日期。四到八個專案。次要專業(例如藝術總監的電影作品、產品設計師的插畫作品)最好作為第二個網站,使用自己的內容檔案,而不是混在一起。
  • 每個專案: 一行摘要、角色,以及它是為客戶、雇主還是個人概念而做。對於產品和領導職位的目標對象,需添加決策和結果。
  • 角色: 他們目前的職稱,照實寫,而不是他們正在申請的職位。
  • 行動呼籲: 在電子郵件上方用一句話說明應在信件中提及什麼。
  • 語言: 使用目標觀眾的語言撰寫,並設定 site.lang。範本的內建文字(Index, Facts, Next…)會跟隨英文與西班牙文;對於任何其他語言,在 labels 中設定。

只使用設計者提供給你的事實,或他們現有頁面上的事實。你自己推斷出來的事實,例如從檔案名稱讀出的客戶名稱,可以使用,但必須告知設計者這是推斷出來的,以便他們確認。

如果缺少某個事實,請撰寫一個方括號插槽([年份]、[團隊規模]、[交付成果])。插槽會按原樣顯示在網站上,而且建置腳本會列出每一個,因此:

  • 保持標題中沒有插槽:根據你已知的資訊來撰寫。第一句話中的插槽是訪客首先會讀到的。
  • 如果整個欄位未知且可選(city、team、site.url),則省略該欄位。
  • 對於沒有成果的作品,請陳述事實:「於 2024 年交付;我沒有相關數據」、「概念,未上線」。這就是一個結果。一個空洞的影響力承諾則不是。
  • 帶有插槽的網站是草稿。在交接時要明確說明這一點。

一個帶有誠實空白的作品集是可以接受的。一個捏造客戶的作品集在面試中會是問題。

4. 設定外觀

在 theme 區塊中:淺色或深色、一種強調色、字體、圓角半徑、圖片間距。如果設計者有品牌或現有網站,請從中提取這些設定。如果他們什麼都沒有,請選擇一種適合他們作品的字體和強調色,並說明你的選擇。不要複製範例或任何其他設計師網站的外觀。

如果字體並非所有裝置都內建,則需要 font_url 來載入;僅在 font 中指定名稱會導致大部分訪客使用系統字體。請同時提供兩者,或選擇一組系統字體。

5. 建置、檢視、修正

執行建置。如果設計者尚未選擇網格,請加上 --compare:

python3 scripts/build.py path/to/their-site/portfolio.json --compare

這會將相同的內容以全部三種網格寫入 compare/ 資料夾,並附上一個連結它們的頁面。向設計者展示該頁面,讓他們選擇。compare/ 僅供選擇使用:發佈前請刪除它。

然後在瀏覽器中以桌面和手機寬度檢視,如果可能的話:在網站資料夾中啟動 python3 -m http.server(case 網格會連結到專案資料夾,需要伺服器),並親自檢查第一個畫面:姓名、他們做什麼、證明、一個聯絡方式,以及一個真實的作品,無需滾動。

如果你無法開啟瀏覽器,請在交接時說明,並至少將標題和證明控制在總共約 45 個詞內,這是手機上第一張圖片上方能容納的長度。

根據腳本印出的清單進行修正。從內容層面修復你能處理的部分(例如缺少角色描述行、圖片過大、標題過長)。將剩下的部分作為一份簡短的清單交給設計者,這些是只有他們能提供的內容。

6. 交接

告訴他們:使用了哪種網格以及是他們選擇的還是你選擇的(以及另外兩種網格只需修改一個詞,或者如果你建置了 compare/ 資料夾,它們就在裡面)、你為標題寫了什麼、你遺漏了什麼、你推斷了什麼、仍有待填補的插槽、審計清單仍然顯示的問題,以及如何修改(編輯 portfolio.json,再次執行建置)。該資料夾是一個完整的靜態網站:可以直接上傳到任何靜態主機來發佈。

有兩件事只有他們能提供,所以在這裡詢問:網站將放置的網址(site.url),以及用於連結預覽的 1200×630 圖片(site.share_image);從第一個專案最佳圖片裁剪出來的圖片就可以了。

圖片

  • 導出時寬度最多 2000 px,格式為 AVIF 或 WebP,每張約 500 KB 以下。建置腳本會對較大的圖片發出警告。JPEG、PNG 和 SVG 也可使用。
  • 當檔案成對命名時,會自動使用較小的手機版複本:內容檔案中的 shot-lg.jpg 和旁邊的 shot-sm.jpg。相同名稱的 .avif 檔案會優先提供給支援的瀏覽器。
  • 為每張圖片提供 alt 屬性,說明其內容。如果沒有,則會使用專案標題,這對搜尋引擎或 AI 助手提供的資訊非常有限。如果你沒有看過這些圖片,請說明每張圖片是哪個作品,並請設計者描述它們。
  • 短循環影片(.mp4、.webm)可以作為圖塊使用。它們會在靜音狀態下播放,且僅在螢幕上可見時播放。為它們提供 ratio 屬性。

不該做的事

  • 不要添加會延遲內容顯示的介紹動畫、載入器、自訂游標或滾動效果。範本刻意設計為立即顯示第一個畫面。
  • 不要將專案標題隱藏在懸停效果之後。手機沒有懸停功能。
  • 不要移除「停靠欄」,即當聯絡區塊滾出畫面時出現的、包含姓名和電子郵件的小橫條。審閱者可能在瀏覽某個專案的中途決定寫信,而不是在頁面結尾。
  • 不要用過程照片(便利貼、人物誌)來填充薄弱的作品。一個明確陳述的決策,價值遠勝於此。
  • 不要手動編輯生成的 HTML:下一次建置會覆蓋它。請修改內容檔案,或者如果結構本身需要更改,則修改 assets/template/ 中的範本。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能