作品集建置器
為黑客松專案建立一個針對人資的單頁展示網站。這個網站本身就是最終成果,即使專案本身不是網頁應用程式:硬體作品、機器學習模型、命令列工具或研究專案,都能透過影片、圖表、照片和互動式副本來展示其成果。目標是達到這些案例研究網站的水準:dispatchai.art3m1s.me、talktuah.art3m1s.me、slugloop.com 和 adapted.art3m1s.me。每個網站的長相都截然不同,因為每個設計都源自專案本身的獨特世界。這種獨特性是核心重點,也是這個技能倚賴前端設計技能而非固定模板的原因。
步驟 1:讓設計引擎就緒
設計來自 Anthropic 的 frontend-design 技能,它能避免結果看起來像一般的 AI 生成頁面。在設計任何東西之前,必須先確保它已可用。
這是使用者的前提條件,而非代理程式能自行處理的事項,因為代理程式無法執行斜線命令。如果 frontend-design 已經出現在你可用的技能清單中,那就沒問題。如果沒有,請要求使用者在 Claude Code 中安裝外掛,執行以下兩個命令:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official
第一行只在尚未加入該市集時才需要。Claude 在處理前端工作時也會自動套用 frontend-design,因此其原則可能已在運作中,但請要求使用者確認,而非假設外掛已存在。步驟 3 中的每個設計決策都會透過它來執行。
步驟 2:收集事實
先偵測,再詢問。閱讀 AGENTS.md、PRD.md、README、package.json,以及儲存庫中已有的任何照片、螢幕截圖或圖表。然後只詢問缺少的資訊:
- 專案名稱和一個標語,要點出利害關係,而非技術本身。
- 專案類型:網頁應用程式、硬體或物聯網、機器學習模型、命令列工具或開發者工具、行動應用程式,或研究與數據。這將決定你在步驟 4 中如何展示它。
- 問題,需包含一個真實統計數據及其來源。
- 它的功能:三到五項核心能力。
- 運作方式:足以繪製架構圖的系統說明。
- 證明:展示影片 (YouTube)、線上網址、Devpost、GitHub、新聞報導,以及任何開源產出物(模型、數據集、Figma)。
- 活動媒體:黑客松活動中的現場照片和短片,這些幾乎從不在儲存庫中。明確要求團隊照片、開發中的進度照、展示日或舞台及獎項照片、白板或餐巾紙草圖,以及場地照片,還有這些檔案存放的位置(手機、共用雲端、Devpost 圖庫)。這些是讓網站感覺真實的關鍵,因此要主動請求,而非假設儲存庫中已有。如果沒有,則退而使用螢幕截圖、圖表和展示影片。
- 成果:獎項與名次、活動名稱與日期、規模與排名、開發時間、團隊規模,以及任何指標(提交次數、延遲、使用者數)。
- 團隊:姓名、角色、GitHub 帳號、LinkedIn 網址以及大頭照。
絕不虛構獎項、統計數據、獎金、排名或引言。如果在詢問後仍無法得知某項事實,則省略該章節,而非進行猜測。
步驟 3:透過前端設計進行設計
為 frontend-design 提供根據步驟 2 制定的簡報,並執行其完整流程:腦力激盪、探索、規劃、評論、建置,然後再次評論。其核心規則在此適用:從主題中衍生外觀,而非使用預設值。為此專案建立一個精簡的專屬標記系統:
- 色票:四到六個命名十六進位值,源自專案的世界。911 調度員讀起來是嚴重的紅色和琥珀色,搭配近乎黑色的背景;語音銀行讀起來是值得信賴的藍色;UCSC 腳踏車網狀網路建置則讀起來像一本破舊的「現場日誌」檔案色票。
- 字型:一款有特色的顯示字體,使用上需節制、一款互補的正文字體,以及一款用於數據的實用或等寬字體,需刻意搭配,而非每個專案都使用相同的字體家族。
- 版面:一個遵循步驟 5 框架的滾動敘事單頁設計。
- 動畫:一個服務於主題的精心編排動畫時刻,例如觸發滾動的架構揭示或遙測重播。分散的效果會顯得像是 AI 生成的,因此將動畫集中在一個地方。這與步驟 6 中減少動畫的無障礙基本要求是分開的。
- 簽名元素:這個網站最令人印象深刻的一個元素,具體體現了這個專案。Dispatch 有一個內嵌的、互動式的操作員控制台,運行在種子數據上;Slugloop 有其「接收器不再傳送訊號」的檔案框架;AdaptEd 有其編號的學習循環。
兩個從前端設計繼承而來的防護措施:
- 避免預設的 AI 外觀,除非專案的世界確實需要其中之一:(1) 奶油色背景,搭配高對比襯線字體和赭色強調色;(2) 近乎黑色,搭配單一的螢光綠或朱紅色強調色;(3) 報紙風格的細線規則,零邊框半徑和密集的欄位。如果你的色票和字型規劃反射性地落在其中之一,請修改它並說明原因。
- 結構即是資訊。僅在編碼真實資訊時使用編號標記、眉毛區塊和分隔線,例如真實的順序 (AdaptEd 的循環),絕不作為裝飾。步驟 5 的框架編號是創作的檢查清單,而非強制的視覺處理方式。
章節標籤本身也是設計的一部分。框架是底層結構;將其標題重新命名為專案自己的語調 (使用「現場日誌」而非「展示」,使用專案世界中的一句話而非「誠實限制」,如果適合主題則使用 01 到 0N 的編號)。在建置前執行規劃然後評論的閘門:如果任何選擇讀起來像是你為任何類似專案產生的頁面,則修改它。僅在計劃真正針對此簡報時才進行建置。
步驟 4:選擇如何展示作品
無論專案是哪種類型,網站都會展示它。最基本的展示內容是展示影片加上專案的主要產出物,無論那是什麼:影片片段、照片、遙測重播、評估圖表或終端機重播。然後根據專案類型選擇主要的展示手法:
- 網頁應用程式:一個內嵌的、互動式的小工具或控制台,運行在種子數據上 (Dispatch 的操作員控制台),僅在互動性不可行時才以唯讀檢視作為備案。
- 硬體或物聯網:建置照片、接線或系統圖表、現場影片,以及地圖或遙測重播 (Slugloop)。
- 機器學習模型:一個互動式推論小工具或前後對比,加上評估數字和 Hugging Face 連結。
- 命令列工具或開發者工具:一個終端機重播 (asciinema 風格) 或一個動畫化的命令序列。
- 行動應用:一個裝置框架內的影片或可點擊的螢幕流程。
- 研究或數據:關鍵圖表、圖表和方法論圖。
展示可以是多個。在有用的情況下提供兩種展示模式 (被動導覽加上互動模式,如 TalkTuah),或將早期原型片段與最終現場片段配對以展示迭代 (Slugloop)。僅在真實後端無法在靜態網站上運行時才模擬副本;當你這麼做時,使用真實數據作為種子,並清楚標示為副本。一個基於真實現場影片的硬體網站不需要模擬也不需要此類標示。
如果專案獲得了真實的新聞報導,將其視為信譽工具:以卡片或媒體標誌搭配引言和來源的方式呈現報導內容 (Slugloop),而非僅提供連結。
步驟 5:案例研究框架
一個單頁滾動、以人資為優先的設計。將其視為選單:僅在事實存在時才包含章節,並將其標題重新命名為專案自己的語調 (參見步驟 3)。這裡的編號是創作的檢查清單,而非強制的視覺風格。
- 重點區 (論點):以專案最具特色的部分開場,加上標語和主要行動呼籲 (展示、Devpost、GitHub)。保持最高獎項或證明可見。
- 信譽條:名次、獎金、排名、領域規模。
- 問題:利害關係和一個有來源的統計數據。
- 功能介紹:核心能力。能力卡片可以深層連結或滾動錨定到架構章節的對應部分,將「是什麼」與「如何運作」聯繫起來 (TalkTuah)。
- 運作方式:架構或系統圖表,展現工程深度。
- 展示:步驟 4 中選擇的裝置 (互動式小工具、單一或多個影片、照片、遙測重播)。在適用的情況下允許雙影片或迭代影片區塊。
- 數據一覽:一個由大字體數字和簡短標籤組成的醒目統計網格。它可以將團隊規模、開發時間、提交次數和排名融合成一個簽名區塊 (Slugloop:4 名學生、36 小時、500+ 次提交、前 10 名)。排名也可能出現在信譽條中。
- 新聞報導 (可選):以卡片或媒體標誌搭配引言和來源的形式呈現的真實報導。
- 團隊:包含角色、GitHub 和 LinkedIn 的個人簡介。
- 誠實限制:說明週末開發的作品能做什麼、不能做什麼。點出取捨會顯得成熟,而非弱點。
- 連結與來源:GitHub、Devpost、YouTube、模型或數據集、新聞。
- 頁尾:在活動中用 N 小時建成,附上儲存庫和線上連結。
步驟 6:開始建置
- 建立一個可靜態匯出且準備好部署到 Vercel 的獨立單頁網站,預設使用 Next.js (App Router)。如果專案已有堆疊,則與之匹配。將其放在自己的資料夾 (
site/或portfolio/) 或單獨的儲存庫中,以免與產品程式碼糾纏。 - 全程使用真實內容,沒有假文字。遵循前端設計的寫作指引:平實、具體、從讀者的角度出發。
- 維持一定的品質水準而無需特別聲明:響應式設計支援手機、可見的鍵盤焦點,以及尊重減少動畫設定。
- 涵蓋 SEO 基礎:包含關鍵字的標題與描述、標準網址、Open Graph 圖片、恰好一個
h1,以及語意化章節。 - 使用真實的螢幕截圖、照片和圖表,包括步驟 2 中收集的活動媒體,放置在展示、團隊和數據一覽章節中;如果你發布了模擬副本,請標記它;使用 YouTube 海報作為展示。
- 在渲染後再次評論,如同前端設計所指示:對頁面進行截圖,重新問自己「我會為一個無關的專案產生相同的外觀嗎?」,然後移除一個不符合簡報目標的裝飾元素。
驗證
frontend-design確實被使用,且結果看起來不像一般的 AI 預設值,也沒有落入三種預設外觀之一。在建置後應用其自我評論:你會為一個無關的專案產生相同的外觀嗎?- 一個
h1、語意化標題、行動響應式、可見的焦點狀態、尊重減少動畫設定。 - 每個獎項和統計數據都是真實的,任何模擬副本都有標記,每個連結都能解析,展示影片或影片已嵌入。
- 建置並在本機預覽;如果可行,檢查 Core Web Vitals 或進行 Lighthouse 測試。
最終輸出
- 網站:路徑或路由,以及如何運行它。
- 設計系統:色票、字型搭配、動畫時刻和簽名元素,並用一句話說明每個元素為何適合此專案。
- 展示裝置:你使用了哪個裝置以及它為何適合該專案類型。
- 使用與省略的事實:哪些被納入,以及哪些章節因缺乏真實事實而被跳過。
- 部署:將其部署到 Vercel 的步驟。
- 後續步驟:例如,自訂網域,以及在 README 和 LinkedIn 貼文中連結此網站。
邊界
- 先讓
frontend-design可用,且絕不發布模板化的預設設計。設計必須專屬於此專案。 - 絕不虛構獎項、統計數據或新聞報導,且務必標記模擬副本。
- 保持為一個專注的頁面。不要重建整個產品。
- 描述實際存在的內容。網站反映真實的專案,而非理想化的版本。