Portfolio One-Pager
何時使用此技能
當 Kene 需要一個公開的單一頁面來展示他的工作成果時使用——例如用於求職申請中的連結、冷接觸郵件的簽名檔、社群媒體個人檔案,或當一個職位明確要求提供作品集時。觸發條件:"我需要一個作品集頁面"、"當他們要求工作範例時,我該連結什麼?"、"為我建立一個針對 [職位] 搜尋的單頁作品集。"
此技能記錄的決策 (A26/A27)
這個決定在多次審查迭代中懸而未決,並且是此套件中唯一產生全新面向使用者交付成果的項目,而非改進既有項目。這正是它不斷被推遲的原因,而它值得一個明確的答案,而不是又一次的延宕。
答案是:建立它,但範圍要窄。
贊成理由:單頁作品集所需的一切都已存在於此套件中,並已根據規則 5 獲得確認。STAR 銀行提供了故事,量化關卡提供了數字,09-risk-tactics-gate 提供了聲明驗證流程,21-output-templates 提供了結構系統,而 17-cold-prospecting 早已需要一個可供連結的目標。不建立它意味著 Kene 必須手動拼湊——從此流程維護的資料庫中——那個在求職應用中最具重複使用價值的單一產出物。
反對理由,以及它如何形塑範圍:作品集既是設計問題也是內容問題,而此流程不該成為網站建置工具。一個包含主題、畫廊、分析工具和 CMS 的「作品集系統」將會是存在於求職流程內的第二個產品。
因此,範圍刻意狹窄:單一頁面,從已確認的記憶中生成,以靜態 HTML 發布,並針對每個目標職位進行版本控制。 沒有 CMS、沒有多頁面網站、沒有主題系統、沒有訪客分析。如果 Kene 想要一個真正的個人網站,這份技能會產出一個好的起始檔案,然後他再帶去別處——而此技能應該直白地說明這一點,而不是朝著那個方向發展。
作品集與客製化履歷——各自的真正用途
最常見的錯誤是建立一個如同美化版履歷的作品集。它們扮演不同的角色,而這個差異不在於呈現方式。
客製化履歷 (05-resume-customizer) | 單頁作品集 | |
|---|---|---|
| 如何到達讀者手中 | 被推送。針對一個職缺發送給一位雇主。 | 被拉取。讀者點擊連結後到達。 |
| 讀者已知資訊 | 他們手邊有職位描述。他們知道自己要匹配什麼。 | 通常一無所知。可能是瀏覽中的招募人員、收到冷郵件的人資經理、會議上認識的人、或只是在 X 上看見他回覆的人。 |
| 職缺是否存在 | 總是存在。 | 通常不存在——這正是冷接觸的基礎。 |
| 壽命 | 發送時凍結。一個快照。 | 即時更新。可變動,且永久公開。 |
| 佐證 | 主張。 "部署時間從 40 分鐘縮短到 6 分鐘。" | 展示。 這裡是儲存庫、正在運行的東西、筆記本、文章。 |
| 格式限制 | ATS 解析、單頁、傳統版面、無特殊格式。 | 無解析器限制。可包含截圖、圖表、較長的敘述和連結。 |
| 失敗模式 | 遺漏關鍵字;與職位描述不匹配。 | 連結失效、內容過時,或洩漏不應公開的資訊。 |
關鍵的差異在「佐證」。 其他一切都只是其後果。履歷只能提出聲明——格式沒有空間容納證明,讀者在他們審視的九十秒內也無從驗證。作品集是產出層:是「部署時間從 40 分鐘縮短到 6 分鐘」變成一個擁有前後 CI 設定歷史紀錄的儲存庫的地方。
這就是為何要建立它的原因。如果一個作品集頁面沒有攜帶任何指向真實產出的連結,它就是一個 ATS 相容性更差的履歷,不應該被發布——09-risk-tactics-gate 的發布前檢查會強制執行此點(參見下方的「產出連結」)。
何時需要各項:
- 履歷,永遠需要。 每次申請。非選項,且此技能不會減少它的必要性。
- 作品集,當讀者在沒有背景資訊的情況下到訪時。 冷接觸 (
17-cold-prospecting)、社群個人檔案中的連結、明確要求工作範例的職位、他人轉介他的姓名時,或任何「你建立了什麼」先於「這是職位說明」的對話。 - 兩者都需,並相互連結。 履歷上放作品集連結;作品集不重複履歷內容。兩者之間的重疊是頁面上的空間浪費,也是另一個需要保持同步的東西。
關於現任雇主的考量。 履歷只發送給一位收件人。作品集則可被任何人找到,包括現任雇主,發布它是一個稍微可見的行為。16-career-pulse 的離職模式處理邏輯適用:如果 Kene 正在秘密求職,這是決定是否發布此頁面的真實輸入項。此技能會在首次發布時提出一次,而非預設任何立場。
產出連結——主要內容,而非頁尾
沒有連結的作品集就是一份履歷。連結是它的目的所在,因此它們應獲得頭等地位的處理,而不是放在底部的「精選作品」列表。
每個工作項目可以攜帶一個或多個產出:
| 類型 | 備註 |
|---|---|
deployed | 正在運行的東西。最有價值的連結——讀者能在十秒內使用它。 |
repo | GitHub/GitLab。連結到儲存庫根目錄,除非特定檔案是重點;深入連結到一個檔案看起來像在挑選。 |
notebook | Colab, Jupyter, Kaggle。請參閱下方的可讀性說明。 |
writeup | 部落格文章、設計文件、事後分析報告。對於程式碼無法分享的工作,這通常是最強的產出。 |
demo | 螢幕錄影,適用於無法公開部署的情況。兩分鐘,無需旁白。 |
package | npm, PyPI, crates.io——一個已發布、可安裝的東西。 |
paper | arXiv 或已發表的場所。 |
筆記本需要進行儲存庫所沒有的可讀性檢查。 一個輸出被清除的 .ipynb 檔案是一面程式碼牆,對快速瀏覽的人來說毫無證明力。連結到渲染後的形式——一個可運行的 Colab 連結,或 nbviewer / GitHub 自己的帶有已提交輸出的渲染——並確保第一個儲存格說明此筆記本的用途。一個第一個可見內容是 import pandas as pd 的筆記本,是一個會被讀者關閉的連結。
儲存庫需要一個能經得起三十秒考驗的 README。 如果儲存庫的 README 沒有說明這是什麼東西以及它為何存在,那麼連結它比不連結更糟。此技能會標記此問題;但不會修復它,因為修復它是 Kene 必須做的實際工作。
連結失效會受到檢查,因為失敗是無聲且徹底的。 一個帶有失效連結的作品集比完全沒有連結更糟:它在你頁面存在的關鍵維度上顯得粗心大意。每個產出 URL 在發布時會被檢查,並在季度刷新時重新檢查 (shared/applications_db_schema_addendum_18.sql, portfolio_artifacts)。404 錯誤、設為私有的儲存庫、或現在需要權限的 Colab,都會透過 URL 被回報——絕不會默默地從頁面上移除,因為默默移除一個產出意味著頁面悄悄變弱而無人注意。
什麼東西可以安全連結——嚴格的界限。 只有 Kene 擁有的產出,或已經獲得許可且公開的產出。雇主擁有的程式碼、內部文件、任何受 NDA 約束的內容,以及任何包含第三方資料的內容,都不能放在公開頁面上。這會在新增時和發布時被檢查,並且是此技能中唯一沒有「Kene 可以覆寫」路徑的檢查——失敗模式是發布他不擁有的東西,而這會終結職業生涯,而不僅僅是工作。
當底層工作無法展示時,writeup 和 demo 類型的存在正是為了解決此問題:描述他建立的系統,以不洩漏任何資訊的抽象層級來描述,是正當的,而且通常比原始碼更容易閱讀。
六個區塊,按順序排列。每一個都來自現有已確認的記憶;此技能不創造任何事實(規則 5)。
- 定位語——一句話,說明他做什麼及為誰而做。衍生自
target-profile.yaml的當前目標職位和content-model-overlap.md的框架,在發布前由 Kene 確認。這是頁面上最難寫的一行,也是最值得反覆迭代的一行。 - 三到五個工作項目——來自 STAR 銀行,根據目標職位選擇,方式與
05-resume-customizer相同。每個都是情境 → 他做了什麼 → 數字。每個數字都帶有與履歷項目相同的量化標準。 作品集不會因為是自行發布就享有較低的佐證標準;如果真要說,一個永久放置在公開頁面上的聲明,理應比一份僅發送一次的文件的相關陳述更需謹慎。 - 能力摘要——分組的技能,附帶來自
domain-knowledge.md的佐證。以群組呈現,而不是一堆標籤。 - 每個工作項目的產出連結——附屬於項目 2,而不是單獨列在底部。一個放在其所佐證的聲明旁邊的連結正在發揮作用;同一個連結放在「精選作品」附錄中則是一個讀者會跳過的列表。參見上方的「產出連結」。
- 聯絡資訊——Kene 已選擇公開的任何資訊。在他另行指示之前,預設為空白。
- 最後更新日期——一個真實的日期。一個帶有過時日期的作品集比沒有日期的更糟,這也是下方定期刷新提示的論據,而非反對顯示它的理由。
變體——兩個軸,而非一個
此技能的第一個版本說「每個目標職位集群一個變體。」這對求職申請是正確的,但對冷接觸則不然,後者是一種不同的情況,面對不同的讀者。
軸 1——目標職位集群(面向求職申請)。 相同的底層材料,但根據職位家族進行不同的選擇和排序。與客製化履歷的原則相同。在多跳躍計畫中,19-career-path-planner 的當前跳躍是預設值:頁面應將他呈現為他現在正在申請的職位,而不是兩個跳躍之後的職位。
軸 2——推銷模式(面向冷接觸)。 17-cold-prospecting 有三種模式,它們需要完全不同的頁面,因為讀者的問題不同:
| 推銷模式 | 讀者的問題 | 頁面以什麼為重點 |
|---|---|---|
| 職位匹配 (Role-fit) | "他能勝任我們現有的職位嗎?" | 與求職申請變體相同的形狀。通常是同一個變體。 |
| 職位創造 (Role-creation) | "這個職能值得在這裡設立嗎?" | 此職位要解決的問題,並以他解決過此問題的工作為證。職位是論點,而非履歷。 |
| 服務 (Service) | "我會僱用這個人來完成一項明確定義的工作嗎?" | 範圍、交付物,以及可比較的過往工作。最接近顧問頁面——而一個以職位為形的作品集會完全誤讀此模式。 |
職位匹配的冷接觸通常不需要單獨的變體——它會重複使用對應的目標職位變體。只有職位創造和服務推銷通常會證明其各自變體存在的合理性,而且前提是 Kene 經常以這種方式推銷,值得維護。
無需為每個接觸對象建立變體,即可實現每次接觸的相關性。 與其為每個潛在客戶建立一個頁面,已發布的頁面會為每個工作項目攜帶一個穩定的錨點 (#credit-scoring-pipeline),而 17-cold-prospecting 會深度連結到相關的項目。一個變體服務多次接觸,每次都能讓讀者直接看到觸發該郵件的項目。這正是不要擴散變體的真實原因:重要的客製化在於他們首先看到哪個項目,而一個錨點可以免費實現這一點。
設定上限。 跨兩個軸的四到五個變體已經很多。每個都是一個可能獨立過時的頁面,而作品集最糟糕的失敗就是內容過時。如果要求第六個,更好的問題通常是兩個現有變體是否已經收斂。
變體存放在 shared/portfolio/{variant_slug}/ 中,每個都記錄了它為何而建、它選擇了什麼,以及何時建立。
選擇頁面上的內容——Kene 決定
此技能提出建議,他進行調整。與此處所有其他內容一樣的「提出-確認-儲存」模式,而不是一個他事後才發現的頁面。
shared/portfolio-manifest.yaml 包含三件事:
- 符合資格的素材庫——記憶中已確認的每個 STAR 條目、能力和產出,每個都帶有一行摘要和一個 ID。透過掃描建立;Kene 無需手動輸入。這是菜單,也是「什麼東西可以放在頁面上」的答案。
- 全局規則——
always_include用於一個或兩個無論目標為何都應出現在每個變體中的旗艦項目,以及never_include用於他完全不希望公開的任何東西。never勝過一切,包括每個變體的選擇,並且它是那些技術上可分享但他寧可不優先展示的工作的正確歸宿。 - 每個變體的選擇——一個有序的 ID 列表。順序是有意義的,頁面會按照給定的順序渲染,因為在一個單頁作品集中,第一個項目決定了大部分印象。
對話如何進行。 在一個新的變體上,此技能會從素材庫中提出一個選擇,每個項目附帶理由,並根據該目標進行排序。Kene 使用白話文進行新增、刪除和重新排序——「刪掉第二個,把支付相關的工作移到最上面,加入我為合作社做的那個。」確認一次後,寫入清單。
重建永遠不會默默地重新選擇。 現有的選擇每次都是起點。一個 Kene 策劃過的頁面不應該因為一個新的 STAR 條目出現就悄悄地重新排列。
新材料會被提供,而非插入。 當有東西進入資料庫,且該東西對某個現有變體排名很高時,季度刷新會提出一次——「這對金融科技變體來說會是一個強項,要加入嗎?」一個問題,而不是一個代其應用的差異。
發布
靜態 HTML,一個檔案加上資產,無建置步驟,無框架。輸出結果可讀且可手動編輯,因為 Kene 會想要手動編輯它,而一個他無法觸碰的生成檔案比沒有檔案更糟。
關於主機代管的提問,以及如果他不在乎會發生什麼事
在首次發布時,只問一次。 不是在生成時問⋯⋯
[因內容截斷,其餘部分省略]