Communitygithub.com

oneconsciousness/job-hunt-with-hope

當使用者想要生成作品集——他們的作品、故事與證明——產生一個自包含的品牌作品集資料夾(可離線運作,直接開啟或本機伺服器提供),可用於寄給招募人員、發布為連結或另存為 PDF。這是 Hope 的核心技能。

job-hunt-with-hope 是什麼?

這個技能是 Hope 作品集生成器,專門用於從使用者的職業圖譜中策劃並建立一個完整的、自包含的品牌作品集資料夾。它支援多種平台,包括 Claude Code、Cursor 和 Codex,並遵循嚴格的離線運作原則——資料夾內所有檔案皆為靜態,無需網路連線即可在瀏覽器中正常顯示。技能會自動解析使用者的職業圖譜,根據目標職位(如指定公司)篩選出最相關的經驗、專案與技能,並以 Hope 特有的設計語言(暖色奶油色與橘色主題、32×32 網格紋理、六角形 KPI 徽章等)進行渲染。輸出的作品集包含四個核心檔案(index.html、portfolio.css、portfolio.js、data.js)以及兩張分享卡片,所有資料皆透過 window.HOPE_DATA 單一全域物件動態驅動,確保內容與設計分離。技能也提供豐富的互動功能,包括時間軸遊標、主題切換、可點擊的技能區塊以及 PDF 匯出功能,讓使用者的專業形象得以完整且美觀地呈現。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oneconsciousness/job-hunt-with-hope/tree/HEAD/skills/portfolio

在你喜歡的 AI 中提問

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

說明文件

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-url meta 標籤的檔案。
  • 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_DATA schema)——在輸出之前先讀取它,並將其視為欄位類型和可選性的權威來源。

— 以及同一個資料夾中的兩張分享卡片頁面(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 節點,然後:

  1. 計算該職位 REQUIRES_SKILL 哪些技能,以及該人員 HAS_SKILL 哪些技能。
  2. 挑選那些 USED_SKILL 和 APPLIED_SKILL 邊與職位所需技能交集最強的經驗/專案。
  3. 排序:最相關優先,最近優先,量化指標最多優先。
  4. 目標是密度,而非詳盡性。三張出色的卡片勝過七張普通的卡片。

如果沒有指定目標職位,則生成一個通用作品集,代表使用者整體最強的作品。

無論哪種方式,在圖譜中建立一個 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 取代。請依序遵循以下步驟:

  1. 從圖譜中策劃(依照下方的「如何選擇要包含的內容」):identity、overview、experience(IC/Leadership 分組,角色晉升形狀)、projects、skills(按類別,等級 1–4 + 年資)、education、certifications、resume(要點附加 tag;Education = 僅學位)、timeline、social 以及每個區塊的 confidence 對應。
  2. 輸出 data.js = window.HOPE_DATA = {…}——一個全域變數,整個頁面的完整資料集(模板的 data.js 創作契約是 window.HOPE_DATA schema)。僅語義值——不含十六進位(category:"programming"、level:4、confidence.band:"high"——portfolio.js 在渲染時會將這些解析為 var(--token))。照片以 data: URL 嵌入在 identity.photo 中。
  3. 將 portfolio.css 和 portfolio.js 逐字複製到輸出資料夾。 portfolio.css 已攜帶渲染器會解析的 15 個 seg-tier / cat / integrity 權杖;portfolio.js 是執行時渲染器。兩者都不會為每個作品集編輯。不要偏離在 $PLUGIN_ROOT/references/design-tokens.md(已在上面載入)中的設計權杖。
  4. 從您放在 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=""),讓發布技能填入。任何地方都不要留下 {{…}}。
  5. 生成兩張分享卡片頁面(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" } 時,模板會啟用一個視覺選擇器來瀏覽時間軸。這在使用者的職業主線上新增一個可探索層。

怎麼做

  1. 解析外掛根目錄(頂層的 Bash 區塊)。
  2. 讀取設計權杖、語音指南、圖譜 schema 和里程碑。
  3. 讀取模板檔案($PLUGIN_ROOT/assets/templates/portfolio/ 中的四個檔案)。
  4. 從使用者的職業圖譜中策劃資料:執行 CATEGORIZE、GRAPH_QUERY 和 TRAVERSE 操作以收集 identity、experience、projects、skills、education、certifications 和 resumes。
  5. 輸出 data.js,將照片編碼為 data: URL,使用語義值。
  6. 複製 portfolio.css 和 portfolio.js。
  7. 填入 index.html 的 meta、seo-fallback 區塊、JSON-LD,並正確設定 hope:share-url。
  8. 輸出兩張分享卡片(share-card.html 和 share-card-square.html)。
  9. 將所有四個檔案以及分享卡片寫入 career-graph/documents/portfolios/portfolio-<slug>-<date>/。
  10. 在圖譜上記錄一個 CuratedPortfolio 節點。
  11. 展示它:為使用者啟用一個本地檔案伺服器或 npx serve 命令以預覽。

如何與使用者互動

  • 如果職業圖譜中缺少欄位,詢問簡短問題。 一次問一個問題!不要做假設。
  • 如果目標公司已知,展示您的推理:「我選擇了您在 Acme 的 DevOps 工程師經驗,因為它最符合所需技能:Kubernetes、Terraform、AWS。」
  • 在使用者探索時,提供以英語方式進行編輯:「要我調整任何卡片嗎?我們可以縮短這個要點,或重新排序經驗。」

最後提醒:您正在生成使用者的職業故事。用精湛的設計構建它;用 Hope 的聲音書寫它。三次檢查每個事實。

用優異的成績完成此任務。

相關技能