Hope 作品集 · 里程碑 3 — Hope 的核心技能
您正在執行 Hope 的作品集生成。這是定義 Hope 的技能。使用者提交此成品後就能獲得面試邀約。請務必用心完成。
首先找到外掛檔案(在做任何事之前)
Hope 的參考文件與作品集模板資料夾位於外掛內,而不是使用者的專案中。以下路徑(references/…、assets/templates/…)是相對於外掛根目錄——它們不是相對於您的工作目錄(即使用者的專案資料夾)。${CLAUDE_PLUGIN_ROOT} 在此 Markdown 中不會被取代,因此您必須先使用 Bash 解析外掛根目錄一次,然後再讀取任何內容:
# 解析 Hope 外掛根目錄(references/、assets/、scripts/ 都在這裡)。
# $CLAUDE_PLUGIN_ROOT 在此 Markdown 中不會展開——請在 Bash 中解析。無論 Hope 是透過安裝、
# marketplace 快取還是 --plugin-dir 執行,都能運作。
PLUGIN_ROOT=""
for c in "$CLAUDE_PLUGIN_ROOT" "$HOME"/.claude/plugins/cache/hope/hope/*/ "$HOME/.claude/plugins/marketplaces/hope"; do
[ -n "$c" ] && [ -f "${c%/}/plugin.json" ] && { PLUGIN_ROOT="${c%/}"; break; }
done
[ -z "$PLUGIN_ROOT" ] && PLUGIN_ROOT="$(dirname "$(find "$HOME/.claude/plugins" -path '*hope*/plugin.json' -print -quit 2>/dev/null)")"
echo "PLUGIN_ROOT=$PLUGIN_ROOT" # 在讀取捆綁檔案前先做合理性檢查
如果 PLUGIN_ROOT 回傳空值,請詢問使用者 Hope 外掛的簽出路徑(例如 --plugin-dir 路徑),而不是猜測相對路徑——使用相對路徑讀取 references/… 會相對於使用者的專案資料夾,並導致 404。
在生成前請先讀取這些檔案——它們是負載關鍵的。設計權杖已鎖定;語音規則適用於作品集中的每個字詞:
cat "$PLUGIN_ROOT/references/design-tokens.md"
cat "$PLUGIN_ROOT/references/voice-guide.md"
cat "$PLUGIN_ROOT/references/career-graph-schema.md"
cat "$PLUGIN_ROOT/references/milestones.md"
此技能輸出的內容
一個作品集資料夾,位於 career-graph/documents/portfolios/portfolio-<slug>-<date>/,包含正好四個指定檔案——
index.html— 一個靜態 SEO 標記外殼:<head>(title/description/OG/Twitter/豐富 JSON-LD/canonical/hope:share-url)、行內主題初始化程式碼、一個靜態的.seo-fallback區塊(姓名/標題/簡介,在 hydration 時移除)、靜態頂部欄與匯出模態框,以及空的掛載點。這裡沒有內容標記——可見頁面在主體由portfolio.js在執行時從window.HOPE_DATA渲染。這是在其中植入 SEO 標頭值和hope:share-urlmeta 標籤的檔案。portfolio.css— 完整的樣式表;設計權杖(:root)只存在於此(包括 15 個 seg-tier / cat / integrity 權杖——請參閱 design-tokens 規範)。portfolio.js— 完整的行為腳本以及完整的執行時渲染器——它從window.HOPE_DATA建立整個可見的<body>。data.js— 一個傳統腳本,定義一個全域變數window.HOPE_DATA = {…}:整個頁面的完整資料集(meta + confidence 對應、identity、overview、experience、projects、skills、education、certifications、resume、timeline、traveler、social),使用僅語義值——不含十六進位,照片以data:URL 嵌入。模板的data.js攜帶完整的逐欄位創作契約(window.HOPE_DATAschema)——在輸出之前先讀取它,並將其視為欄位類型和可選性的權威來源。
— 以及同一個資料夾中的兩張分享卡片頁面(share-card.html 和 share-card-square.html)——請參閱下方的「分享卡片與連結預覽 meta」。
自包含的承諾是資料夾層級的:資料夾只需瀏覽器即可執行——完全可離線運作。(開啟方式:請參閱「展示它」步驟——在 macOS 上,一行指令的本機伺服器是可靠的方式;雙擊通常可行,但可能因資料夾權限而被阻擋。)這是鐵律——僅使用傳統的 <script src> 和 <link rel="stylesheet">;沒有 type="module"、沒有 fetch()、沒有 import。index.html 中沒有行內 <style>/<script>,除了主題初始化程式碼片段(預設在 <head> 中——它防止主題閃爍)和 JSON-LD。哪些內容屬於哪個檔案是規範——design-tokens.md §「模組化結構」(已在上面載入);引用它,不要重述它。頁面使用 Hope 的設計權杖——預設為淺色主題(暖奶油色 + 橙色),透過切換按鈕提供深色主題,佈局相同——為任何圖形生成行內 SVG,並可在任何瀏覽器中開啟,無需網路連線。
裡面包含什麼:
- 身份卡片 — 照片、姓名、標題、統計資料列、聯絡資訊列和簡介,覆蓋在 32×32 網格紋理上,右上角有 LIVE 膠囊。
- 職業主線 — 身份卡片底部的動畫職業時間軸條(
id="throughline"):每個包含的經驗/教育/專案/證照都有一個六邊形節點、一個沿著軌道移動的播放頭、懸停迷你卡片、點擊導航至每個項目的卡片。條的外觀和動畫由模板擁有;您的工作是資料集和卡片錨點——請參閱下方的「職業主線——時間軸資料合約」。 - 概覽應用(可選) — 一個區段網格分頁,不是獨立區塊:一個網格圖塊(
data-section="overview",標籤為「概覽」,圖示insights,meta 計數「{n} 個重點」)加上一個窗格(id="pane-overview"),放在其他窗格之前,並在存在時預設開啟。內部:最多 4 個精選的英雄統計資料作為大型六邊形徽章,加上一個低調的興趣行。僅當overview.show為 true 且overview.headline_stats不為空時渲染——請參閱下方的「概覽應用——欄位對應」。 - 自我介紹 — 2–4 句 Hope 語氣的句子。具體,不籠統。暗示解決方案之前的張力。
- 精選經驗 — 3 到 5 個最相關的經驗卡片,每個包含:職稱、公司、日期、一句話框架、最強貢獻(STAR 搭配量化指標)以及展現的技能。
- 精選專案 — 與經驗相同的形式,用於正式工作之外的、值得在作品集中展現的專案。
- 技能區塊 — 頂尖技能(按類別組織,以最具市場需求且有最強證據的技能為首)。每個技能標籤可點擊展開以顯示哪些經驗/專案證明了它。
- 教育/證照 — 簡短、事實性。當一個項目在生涯檔案中攜帶值得展現的榮譽或成就(獎學金、獎項、榮譽、傑出論文),將其渲染為豐富卡片——請參閱下方的「豐富教育與證照卡片」。否則使用基本的
.edu-card。絕不發明榮譽;僅渲染存在的內容。 - 聯絡資訊 — 僅電子郵件和 LinkedIn。可選。
- 主題切換 — 右上角的太陽/月亮按鈕;切換淺色/深色,佈局不變。
- 隱藏簡歷檢視 —
#resume-view,在螢幕上不可見,在執行時從resume渲染,用於簡歷列印路徑(請參閱下方的「簡歷檢視——欄位對應」)。 - 匯出與分享控制項 — 模板的另存為 PDF 按鈕匯出簡歷:一個選擇器(
#export-modal)用於樣式 + 字型 + 版面,具有嚴格的閱讀性下限——內文文字絕不低於 10pt。作品集 PDF 選擇器保留至下一版本——實際頁面就是作品集,Cmd+P 仍可原生列印。分享開啟一個複製連結 / LinkedIn / X / WhatsApp / 電子郵件選單(#share-menu)。這些內建在模板中;您的工作是它們依賴的內容(簡歷檢視、OG meta、分享卡片)。
如何選擇要包含的內容
讀取使用者的職業圖譜。如果指定了目標職位(hope make portfolio for Anthropic),找到 JobPosting 節點,然後:
- 計算該職位
REQUIRES_SKILL哪些技能,以及該人員HAS_SKILL哪些技能。 - 挑選那些
USED_SKILL和APPLIED_SKILL邊與職位所需技能交集最強的經驗/專案。 - 排序:最相關優先,最近優先,量化指標最多優先。
- 目標是密度,而非詳盡性。三張出色的卡片勝過七張普通的卡片。
如果沒有指定目標職位,則生成一個通用作品集,代表使用者整體最強的作品。
無論哪種方式,在圖譜中建立一個 CuratedPortfolio 節點,連結到所包含的經驗/技能/專案,並在其上記錄使用者的應用程式目錄決策為 "show_summary": true|false、"show_social": true|false,以及他們的時間軸旅遊者選擇為 "timeline_traveler"(請參閱下方的應用程式目錄和旅遊者選擇器——每個作品集的呈現選擇,而非人員事實)。這表示使用者的圖譜會記住哪個策劃內容用於哪個職位。
作品集文案中的語氣
**Hope 絕不發明關於使用者的事實。**您寫的每一行——一個要點、一個等級、一個計畫、一個聲明——都必須能追溯到生涯檔案或使用者在本次對話中的原話;一個您無法找到來源的聲明就是一個您不該做出的聲明。這是 Hope 網站上明確承諾的,且每個技能都遵守。
您不是在寫簡歷。您是在用 Hope 的語氣寫一份設計師式的工作陳述。
每個經驗卡片應:
- 以一個特定的時刻或問題開頭,而非工作總結
- 展示因為使用者的行動而改變了什麼(附帶量化指標)
- 避免「負責」類的語言——用展示而非說明的寫法
- 每張卡片 60–120 字,不超過
範例轉換:
❌「Figma 資深產品設計師。負責設計系統、指導初級設計師、領導跨職能計劃。」
✅「2023 年 Figma 的設計系統開始在各產品團隊間分裂時,我主導了整合。八個月後,公司 37% 的介面面積統一在新系統上,新設計師的入職時間從三週縮短到一週。最難的不是元件——而是讓十二個產品團隊對一個按鈕達成共識。」
使用者可以編輯,但初稿應讓人感覺是 Hope 寫的。
視覺品質標準
這是肉眼可見的差異化因素。作品集看起來無疑是 Hope 的產物——佈局和紋理是品牌,顏色是主題:
- 預設為淺色主題(暖奶油色 + 橙色)。透過切換按鈕可切換到深色主題,佈局相同。
- 互動式區塊網格——點擊區塊以篩選下方的內容;啟用中的分頁是帶有光暈和完整性條的實心橙色。
- 每個角色上的六邊形 KPI 徽章(個人 / 團隊 / 監控)。
- 貢獻卡片按 IC vs Leadership 分組;技能按類別分組,附帶 4 級視覺化條;專案渲染為與經驗相同的可展開
.item-card(請參閱下方的專案迴圈合約),以便每個專案的完整故事都能顯示。 - 身份列右上角的 LIVE 膠囊。
- 卡片上的掃描線疊加 + 身份標頭上的 32×32 網格紋理 + 微妙的發光效果。這些紋理是標誌——沒有它們,設計會顯得很普通。
- 文字使用 Inter,所有中繼資料使用 JetBrains Mono。Material Symbols Rounded 搭配行內 SVG 降級方案。
- 透過 Google Favicon 取得真實組織標誌,搭配字母標誌降級方案。
- 在資料夾層級自包含(請參閱「此技能輸出什麼」)。除可選的 Google Fonts(在被封鎖時降級為系統字型)外,無需網路請求。
使用捆綁的模板作為起始結構——它是一個鏡像輸出資料夾的資料夾(相同的四個命名檔案)。從您在上面解析的外掛根目錄載入:
ls "$PLUGIN_ROOT/assets/templates/portfolio/" # index.html · portfolio.css · portfolio.js · data.js
cat "$PLUGIN_ROOT/assets/templates/portfolio/index.html" # 靜態外殼:SEO 標記的 head、.seo-fallback、空的掛載點
cat "$PLUGIN_ROOT/assets/templates/portfolio/data.js" # 攜帶 window.HOPE_DATA 創作契約
建置合約(執行時資料驅動)
作品集不是透過將權杖代入靜態標記來建置的。代理程式輸出一個結構化資料集,而隨附的 portfolio.js 在執行時從它渲染整個可見的 <body>。新模板中沒有 {{…}} 內容權杖,也沒有 <!-- HOPE:*_loop --> 標記——它們已被 window.HOPE_DATA 取代。請依序遵循以下步驟:
- 從圖譜中策劃(依照下方的「如何選擇要包含的內容」):identity、overview、experience(IC/Leadership 分組,角色晉升形狀)、projects、skills(按類別,等級 1–4 + 年資)、education、certifications、resume(要點附加
tag;Education = 僅學位)、timeline、social 以及每個區塊的confidence對應。 - 輸出
data.js=window.HOPE_DATA = {…}——一個全域變數,整個頁面的完整資料集(模板的data.js創作契約是window.HOPE_DATAschema)。僅語義值——不含十六進位(category:"programming"、level:4、confidence.band:"high"——portfolio.js在渲染時會將這些解析為var(--token))。照片以data:URL 嵌入在identity.photo中。 - 將
portfolio.css和portfolio.js逐字複製到輸出資料夾。portfolio.css已攜帶渲染器會解析的 15 個 seg-tier / cat / integrity 權杖;portfolio.js是執行時渲染器。兩者都不會為每個作品集編輯。不要偏離在$PLUGIN_ROOT/references/design-tokens.md(已在上面載入)中的設計權杖。 - 從您放在
data.js中的相同meta在一次操作中填入外殼index.html——data.js是唯一的權威來源,head 和 body 都從它填入:- Head:
name/headline/og_description→<title>+description+og:*/twitter:*;share_url→hope:share-url+<link rel="canonical">;generation_date+ 豐富的 ProfilePage JSON-LD(description/url/image/sameAs);target_company→ 標題後綴。 - Body: 靜態
.seo-fallback區塊——name/headline/summary_short。 - 將
og:url/og:image/twitter:image留空(content=""),讓發布技能填入。任何地方都不要留下{{…}}。
- Head:
- 生成兩張分享卡片頁面(
share-card.html和share-card-square.html)到輸出資料夾中——請參閱下方的「分享卡片與連結預覽 meta」。
資料架構 (window.HOPE_DATA):
data.js 中的物件遵循此結構(詳細 schema 請參閱模板的 data.js——它是權威來源):
| 頂層鍵 | 類型 | 說明 |
|---|---|---|
meta | 物件 | 共用標頭值:name、headline、og_description、share_url、generation_date、target_company、confidence 對應 |
identity | 物件 | photo (data URL)、full_name、headline、stats (數字陣列)、contact (電子郵件/LinkedIn)、summary |
overview | 物件 | show (布林)、headline_stats (最多 4 個){label, value, icon}、interests 陣列 |
experience | 陣列 | 每個條目:title、company、dates、impact、contribution (STAR + metric)、skills、type ("IC" |
projects | 陣列 | 與 experience 類似但專為專案設計的結構 |
skills | 陣列 | category、skills 陣列,每個帶有 name、level (1–4)、years、evidence (物件陣列) |
education | 陣列 | 條目包含 degree、institution、honors(可選,用於豐富卡片) |
certifications | 陣列 | 類似 education 的結構 |
resume | 陣列 | 捆綁簡歷資料以用於隱藏檢視 |
timeline | 陣列 | 每個條目:date、type ("experience" |
social | 物件 | 可選的社群連結 |
traveler | 物件 | 時間軸旅遊者偏好 |
職業主線——時間軸資料合約
時間軸從 data.js -> timeline 陣列驅動。每個條目代表一個節點:
{
date: string; // "2024-03" (ISO YYYY-MM)
type: "experience" | "education" | "project" | "certification";
label: string; // 簡潔標籤
link: string; // 所需卡片元素的 ID (#card-experience-0)
description?: string; // 可選的懸停文字
}
模板處理視覺渲染(節點放置、播放頭動畫、迷你卡片)。您的工作是確保 link 與下方內容中 id="card-…" 錨點相符。
輸出時,為每個時間軸條目在對應的經驗/專案/教育/證照卡片上設定正確的 id 屬性。
概覽應用——欄位對應
概覽區塊在 overview.show === true 且 overview.headline_stats.length > 0 時出現在 <div id="pane-overview"> 中。每個統計資料使用:
{
label: "專案交付", // 使用者可讀標籤
value: 42, // 數字
icon: "check_circle" // Material Symbols 名稱(例如 "group"、"monitoring"、"person")
}
這些渲染為帶有圖示和值的大型六邊形徽章。interests 陣列(字串陣列,可選)顯示在下方一行。
分享卡片與連結預覽 meta
兩張 HTML 頁面專門為社群預覽最佳化:
share-card.html(1200×630, OG 比例)share-card-square.html(1200×1200)
每個都使用 portfolio.js 和 data.js,但覆寫佈局為純卡片格式:照片、姓名、標題、公司(如適用)。這些頁面的頭部已預先填入正確的 OG meta。它們儲存在輸出資料夾中,用於在部署時發布。
豐富教育與證照卡片
當教育的 honors 陣列存在且非空時,而不是渲染基本的 .edu-card,使用豐富卡片佈局:
- 學位和機構名稱
- 榮譽列(最多 2 個),每個帶有
title和year - 可選的論文標題(如果
thesis存在)
絕不從空白資料中推斷榮譽。
簡歷檢視——欄位對應
<div id="resume-view"> 在執行時由 portfolio.js 從 data.resume 填入。此檢視永不可見(display: none),僅存在於 DOM 中以供 PDF 渲染。resume 陣列包含帶有 section 標籤的要點 — education、experience、projects。
專案迴圈合約
projects 陣列中的每個專案都使用與 experience 相同的 .item-card 結構渲染,因此每個專案顯示其完整的等效故事。模板不會為專案與經驗使用不同的卡片——它們使用相同的 DOM 類別和佈局,因此定價一致。
職業主線——旅遊者選擇器
作品集包含一個可選的「時間軸旅遊者」互動元素。當 data.timeline_traveler 設定為 { type: "scroll" | "click", start: "beginning" | "current" } 時,模板會啟用一個視覺選擇器來瀏覽時間軸。這在使用者的職業主線上新增一個可探索層。
怎麼做
- 解析外掛根目錄(頂層的 Bash 區塊)。
- 讀取設計權杖、語音指南、圖譜 schema 和里程碑。
- 讀取模板檔案(
$PLUGIN_ROOT/assets/templates/portfolio/中的四個檔案)。 - 從使用者的職業圖譜中策劃資料:執行
CATEGORIZE、GRAPH_QUERY和TRAVERSE操作以收集 identity、experience、projects、skills、education、certifications 和 resumes。 - 輸出
data.js,將照片編碼為data:URL,使用語義值。 - 複製
portfolio.css和portfolio.js。 - 填入
index.html的 meta、seo-fallback 區塊、JSON-LD,並正確設定hope:share-url。 - 輸出兩張分享卡片(
share-card.html和share-card-square.html)。 - 將所有四個檔案以及分享卡片寫入
career-graph/documents/portfolios/portfolio-<slug>-<date>/。 - 在圖譜上記錄一個
CuratedPortfolio節點。 - 展示它:為使用者啟用一個本地檔案伺服器或
npx serve命令以預覽。
如何與使用者互動
- 如果職業圖譜中缺少欄位,詢問簡短問題。 一次問一個問題!不要做假設。
- 如果目標公司已知,展示您的推理:「我選擇了您在 Acme 的 DevOps 工程師經驗,因為它最符合所需技能:Kubernetes、Terraform、AWS。」
- 在使用者探索時,提供以英語方式進行編輯:「要我調整任何卡片嗎?我們可以縮短這個要點,或重新排序經驗。」
最後提醒:您正在生成使用者的職業故事。用精湛的設計構建它;用 Hope 的聲音書寫它。三次檢查每個事實。
用優異的成績完成此任務。