Communitygithub.com

oraekene/job-hunting-pipeline

為目標職位建立並發佈一份單頁式作品集。

job-hunting-pipeline 是什麼?

這項技能專為求職者設計,能自動從個人履歷資料庫中,為特定目標職位生成一份精煉的單頁式作品集(Portfolio One-Pager)。它與傳統客製化履歷表不同,更專注於「展示」具體的工作成果,而非僅是「陳述」經歷。作品集會從 STAR 事蹟庫中挑選 3 至 5 個與目標職位高度相關的工作項目,並直接附上原始程式碼倉庫、已部署的產品連結、筆記本或展示影片等「實物連結」,讓招聘方可以立即驗證能力。此技能支援多種應用場景,包括針對特定職位的標準版本、用於陌生開發的「角色建立」或「服務」模式,並透過 YAML 清單讓使用者手動挑選與排列內容,確保最終產出的作品集完全符合個人意向。它會以靜態 HTML 形式發佈,並內建連結有效性檢查、定期更新提醒,以及避免因不當連結洩露機密資訊的安全機制。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oraekene/job-hunting-pipeline/tree/HEAD/23-portfolio-onepager

在你喜歡的 AI 中提問

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

說明文件

Portfolio 單頁式作品集

適用時機

當 Kenechukwu 需要一個代表他工作成果的單一公開頁面時使用——無論是作為申請連結、陌生開發的簽名檔、社交檔案,或是應徵職位時明確要求提供的作品集。觸發詞:"我需要一個作品集頁面"、"當他們要求工作樣本時我該連結什麼"、"幫我為 [職位] 的求職打造一個單頁式作品集"。

此技能記錄的決策 (A26/A27)

這個決定在好幾次審查討論中被懸而未決,它是這個套件中唯一能產生「面向使用者的新成果」、而非改善現有成果的項目。正因如此它才一直往後延,而它理應得到一個明確的答案,而非再次被擱置。

答案是:就做,但要做得狹義。

贊成的理由是:一份單頁式作品集所需的一切,都已存在於這個套件中,並已在規則 5 下獲得確認。STAR 事蹟庫提供了故事,量化關卡提供了數字,09-risk-tactics-gate 提供了陳述驗證,21-output-templates 提供了結構系統,而 17-cold-prospecting 已經需要一個可以連結的對象。不做的話,就意味著 Kenechukwu 必須從這個流程維護的資料庫中,手動拼湊出那個在整個求職過程中「最具重複利用價值」的成果。

反對的理由(以及為何要限縮範圍)是:作品集不只有內容問題,還是個設計問題,而這個流程沒有理由成為一個網站建置工具。一個包含主題、畫廊、分析和內容管理系統的「作品集系統」,會變成一個寄生在求職流程中的第二個產品。

因此,範圍刻意設得很窄:一個頁面,從已確認的記憶中生成,以靜態 HTML 發佈,並根據目標職位設定版本。 沒有 CMS、沒有多頁網站、沒有主題系統、沒有訪客分析。如果 Kenechukwu 想要一個真正的個人網站,這個流程可以產出一個好的起始檔案,然後他再自行處理——而這項技能也應該清楚說明這點,而不是讓自己朝那個方向發展。

作品集 vs. 客製化履歷表——各自真正的用途

最常見的錯誤就是把作品集做成一份比較漂亮的履歷表。它們的功能不同,而且差異不在於呈現方式。

客製化履歷表 (05-resume-customizer)作品集單頁式頁面
如何觸及讀者推送。針對一個職缺發送給一個雇主。拉取。讀者點擊連結後造訪。
讀者已知資訊他們手上有職位描述,知道要匹配什麼。通常一無所知。可能是瀏覽中的招募人員、收到陌生郵件的人資主管、會議上認識的人、或是在 X 上看過他回覆的人。
是否有明確職缺總是。經常沒有——而這正是陌生開發的基礎。
生命週期發送時凍結。一個快照。活的。可變動,且永久公開。
證據陳述。 "將部署時間從 40 分鐘縮短到 6 分鐘。"展示。 這是程式碼倉庫、運行的產品、筆記本、報告。
格式限制ATS 解析、一頁、傳統版面、無特殊格式。無解析器。可使用截圖、圖表、較長的敘述、連結。
失敗模式錯過關鍵字;與職位描述不匹配。死連結、過時內容,或洩漏不該公開的資訊。

最重要的那一行是「證據」。 其他一切都只是其後果。履歷表只能提出主張——格式沒有空間容納證明,而讀者在花九十秒瀏覽時也無法驗證。作品集則是具體成果的層面:在那裡,「將部署時間從 40 分鐘縮短到 6 分鐘」會變成一個包含前後 CI 設定變更歷史的程式碼倉庫。

這就是為什麼要建立它的核心原因。如果一個作品集頁面沒有導向真實成果的連結,那它就是一份 ATS 相容性更差的履歷表,根本不該發佈——09-risk-tactics-gate 的發佈前檢查會強制執行這點(請參閱下方的「成果連結」)。

何時需要哪一種:

  • 履歷表,永遠都需要。 每份申請都需要。非選用項目,這項技能不會減少這個需求。
  • 作品集,當讀者在沒有背景資訊的情況下造訪時。 陌生開發 (17-cold-prospecting)、社交檔案中的連結、明確要求工作樣本的職位、他人轉介時,或者任何對話中先出現「你建過什麼」而非「這是職位說明」的情況。
  • 兩者應互相連結。 履歷表上應有作品集網址;作品集不應重製履歷表。兩者之間的冗餘只是浪費版面,並徒增一項需要同步維護的內容。

關於現任雇主的考量。 履歷表只寄送給一個收件人。作品集則可能被任何人找到,包括現任雇主,而出版作品集本身是一個輕微可見的行為。16-career-pulse 的謹慎模式處理方式適用於此:如果 Kenechukwu 正在低調地求職,這會是決定是否發佈作品的真實因素,而這項技能會在首次發佈時提出這個問題,而非預設任何立場。

成果連結——主要內容,而非頁尾

沒有連結的作品集就是履歷表。連結是作品集的核心目的,因此它們應獲得一級待遇,而非放在頁尾的「精選作品」清單中。

每個工作項目可以攜帶一個或多個成果:

類型備註
deployed正在運行的產品。這是價值最高的連結——讀者十秒內就能使用。
repoGitHub/GitLab。除非某個特定檔案才是重點,否則請連結到儲存庫根目錄;深入連結到某個檔案會被視為挑選性展示。
notebookColab、Jupyter、Kaggle。請參閱下方的可讀性說明。
writeup部落格文章、設計文件、事後檢討報告。對於程式碼無法分享的工作,這通常是最有力的成果。
demo螢幕錄影,適用於無法公開部署的專案。兩分鐘,不需要旁白。
packagenpm、PyPI、crates.io——已發佈的可安裝套件。
paperarXiv 或已發表的會議論文。

筆記本需要比儲存庫更嚴謹的可讀性檢查。 一個已清除輸出的 .ipynb 檔案對瀏覽者來說只是一堵程式碼牆,無法證明任何事。請連結到渲染後的版本——一個可以執行的 Colab 連結,或是有已提交輸出的 nbviewer / GitHub 渲染頁面——並確保最上方的儲存格說明了筆記本的用途。一個第一眼看到的是 import pandas as pd 的筆記本,讀者會直接關閉連結。

儲存庫需要一個能撐過三十秒的 README。 如果儲存庫的 README 沒有說明這是什麼、為何存在,那麼連結它比不連結更糟。這項技能會標記這個問題,但不會修正它,因為修正它是 Kenechukwu 必須做的實際工作。

連結失效會被檢查,因為這種失敗是無聲且徹底的。 帶有死連結的作品集比完全沒有連結更糟:它在你想證明的面向上看起來顯得很粗心。每個成果 URL 都會在發佈時和每季更新時被檢查(請參閱 shared/applications_db_schema_addendum_18.sql 中的 portfolio_artifacts)。404 錯誤、已設為私有的儲存庫,或現在需要權限的 Colab 都會透過 URL 被回報——絕不會默默地從頁面上移除,因為默默地移除一個成果意味著頁面會悄悄地變弱,而沒有人會注意到。

什麼可以安全地連結——硬性邊界。 只有 Kenechukwu 擁有的、或是已獲得許可公開的成果才能連結。雇主擁有的程式碼、內部文件、任何受 NDA 保護的內容,以及包含第三方資料的內容,都不得出現在公開頁面上。這會在新增時和發佈時進行檢查,而且是這項技能中唯一沒有「Kenechukwu 可以覆寫」路徑的檢查——失敗的後果是發佈了不屬於他的東西,這不僅會丟掉工作,更會終結職業生涯。

當基礎工作無法展示時,writeup 和 demo 類型的存在正是為了解決這個問題:以不洩露機密的抽象層次描述他建立的系統,這是合理且通常比原始碼更具可讀性的做法。

頁面結構

六個區塊,按順序排列。每個區塊都來自已確認的記憶;這項技能不會產生任何新的事實(規則 5)。

  1. 定位語 — 一句話,說明他的身份和服務對象。源自 target-profile.yaml 的當前目標職稱和 content-model-overlap.md 的框架,在發佈前需經 Kenechukwu 確認。這是頁面上最難寫的一行,也是最值得反覆修改的一行。
  2. 三到五個工作項目 — 來自 STAR 事蹟庫,根據目標職位進行挑選,方式與 05-resume-customizer 相同。每個項目包含:情境 → 他做了什麼 → 數字。每個數字都需通過與履歷表項目相同的量化關卡。 作品集不應因為是自出版就降低證據標準;事實上,永久存在於公開頁面上的主張,理應比只發送一次的文件中的主張更值得謹慎對待。
  3. 能力摘要 — 將技能分組並附上證據,來自 domain-knowledge.md。應分組呈現,而非一堆標籤。
  4. 每個工作項目的成果連結 — 附加於項目 2,而非單獨列在頁尾。放在主張旁邊的連結才能發揮作用;放在「精選作品」附錄中的連結,讀者只會跳過。請參閱上方的「成果連結」。
  5. 聯絡方式 — Kenechukwu 已選擇公開的任何資訊。在他另行指定前,預設為不顯示。
  6. 最後更新日期 — 一個真實的日期。帶有過時日期的作品集,比沒有日期的更糟——這說明了為什麼需要下方的更新提示,而非反對顯示日期。

變體——兩個軸向,而非一個

這項技能最初的版本說的是「每個目標職稱群組一個變體」。這對於求職申請是對的,但對於陌生開發來說是錯的,因為那是不同的情境和讀者。

軸向 1 — 目標職稱群組(求職申請導向)。 相同的基礎素材,根據不同職位家族進行不同的挑選和排序。與客製化履歷表的原理相同。在有多個職涯規劃時,19-career-path-planner 的當前跳板是預設值:頁面應為他現在正在申請的職位而呈現,而非兩步之後的職位。

軸向 2 — 推銷模式(陌生開發導向)。 17-cold-prospecting 有三種模式,它們需要完全不同的頁面,因為讀者的問題不同:

推銷模式讀者的問題頁面應以什麼為重點
角色匹配"他能否勝任我們現有的工作?"與求職申請變體形狀相同。通常就是同一個變體。
角色建立"這個職能值得在這裡建立嗎?"該職能所要解決的問題,並以他解決過此問題的工作成果作為證據。角色本身就是論點,而非履歷。
服務"我會雇用這個人來完成一項定義明確的工作嗎?"範圍、可交付成果,以及可比擬的過往工作。最接近顧問頁面——而這是角色型作品集最容易誤讀的模式。

角色匹配的陌生開發通常不需要單獨的變體——它可以直接重用對應目標職稱的變體。只有角色建立和服務這兩種模式通常值得擁有自己的變體,而且前提是 Kenechukwu 經常以這種方式進行開發,值得維護。

無需為每次陌生開發建立變體,也能達到相關性。 與其為每個潛在對象建立一個頁面,不如在已發佈的頁面上為每個工作項目建立一個穩固的錨點(例如 #credit-scoring-pipeline),然後 17-cold-prospecting 直接深層連結到相關項目。一個變體可以服務多次陌生開發,每次都將讀者引導到觸發該郵件的那個項目。這才是不要過度增生變體的真實原因:重要的客製化是他們先看到哪個項目,而一個錨點就能免費做到這點。

設定上限。 兩個軸向加起來共四到五個變體已經很多了。每個變體都是一個可能獨立過時的頁面,而作品集最糟的情況就是過時。如果要求建立第六個,通常更值得問的問題是:是否已有兩個現有變體趨於一致了。

變體存放在 shared/portfolio/{variant_slug}/ 目錄下,每個目錄都記錄了它為何而建、選取了什麼內容,以及建立時間。

選擇頁面上的內容——由 Kenechukwu 挑選

這項技能提出建議,他再進行調整。與此處所有其他流程一樣,遵循「提議-確認-儲存」的形狀,而不是在事後才發現的頁面。

shared/portfolio-manifest.yaml 包含三項內容:

  1. 合格候選池 — 記憶庫中每個已確認的 STAR 條目、能力和成果,都附有一行摘要和一個 ID。由系統掃描產生;Kenechukwu 從不需手動輸入。這是選單,也是「頁面上可以放什麼」的答案。
  2. 全域規則 — always_include 用於一兩個無論目標為何都應出現在所有變體中的旗艦項目;never_include 用於他完全不想公開的任何事物。never 的優先級高於一切,包括每個變體的選擇,而且是存放那些技術上可分享、但他寧可不優先展示的工作的正確位置。
  3. 每個變體的選擇 — 一個有序的 ID 清單。順序是有意義的,頁面會完全按照給定的順序呈現,因為在單頁式頁面上,第一個項目決定了一半的印象。

對話流程如何進行。 對於一個新的變體,這項技能會從候選池中提出一份選擇,並附上每個項目的理由,並根據該目標進行排序。Kenechukwu 可以用自然語言新增、刪除和重新排序——例如「刪掉第二個,把支付相關的工作移到最上面,加上我為合作社做的那件事」。確認一次後,就會寫入清單中。

重建時絕不會默默地重新選擇。 每次都以現有的選擇作為起點。Kenechukwu 策劃過的頁面,不應該因為新的 STAR 條目出現就悄悄地重新排列。

新材料會以提問方式提出,而非直接插入。 當有新的材料進入資料庫,且對於某個現有變體會排名很高時,每季的更新會提出一次問題——「這個項目非常適合金融科技變體,要加入嗎?」這是一個問題,而不是一個自動套用的變更。

發佈

靜態 HTML,一個檔案加上素材,不需要建置步驟或框架。輸出的內容可由人直接閱讀和編輯,因為 Kenechukwu 會想要手動編輯它,而一個他無法觸及的生成檔案比沒有檔案更糟。

存放位置

…

[此處原文截斷,其餘內容保留原文狀態以利翻譯]

相關技能