作品集单页 (Portfolio One-Pager)
何时应用本技能
当Kene需要一个单一的公开页面来展示其工作成果时使用——例如用于申请中的链接、冷接触签名、社交媒体简介,或者某个职位明确要求提供作品集时。触发条件包括:“我需要一个作品集页面”、“当被要求提供工作样本时我该链接什么”、“为[职位]搜索构建一个单页”。
本技能所记录的决策 (A26/A27)
此决策在数次审查过程中一直悬而未决,并且是这个包中唯一产生面向用户的新交付物而非改进现有内容的增加。这正是它不断被推迟的原因,它值得得到一个明确的答案,而不是又一次延期。
答案:构建它,但要严格限定范围。
支持的理由:单页所需的一切都已包含在包中,并且已根据规则5得到确认。STAR故事库有故事,量化门有数字,09-risk-tactics-gate有主张验证环节,21-output-templates有结构系统,而17-cold-prospecting已经需要一个可链接的产物。不构建它意味着Kene需要手动从该管道维护的语料库中组装那个在求职中最具复用价值的工件。
反对的理由及其对范围的影响:作品集既是设计问题也是内容问题,而本管道不适合充当网站构建器。一个带有主题、画廊、分析功能和内容管理系统的“作品集系统”将是一个存在于求职管道中的第二产品。
因此,范围被刻意限制:一页,从已确认的记忆中生成,发布为静态HTML,针对每个目标职位进行版本化。 没有CMS,没有多页网站,没有主题系统,没有访客分析。如果Kene想要一个真正的个人网站,这会提供一个良好的起始文件,他可以另寻他处——本技能应明确说明这一点,而不是朝那个方向发展。
作品集与定制简历——各自的用途
最容易出错的方式是将作品集构建成一个更漂亮的简历。它们承担不同的任务,其区别不在于呈现方式。
定制简历 (05-resume-customizer) | 作品集单页 | |
|---|---|---|
| 到达读者手中的方式 | 推送式。针对一次招聘发送给一个雇主。 | 拉取式。读者点击链接后访问。 |
| 读者已经知道的信息 | 他们面前有职位描述。他们知道自己要匹配什么。 | 通常一无所知。可能是浏览的招聘人员、收到冷邮件的招聘经理、会议上的某人、刚在X上看到他回复的人。 |
| 职位是否存在 | 总是存在。 | 经常不存在——这正是冷接触的基础。 |
| 生命期 | 发送时冻结。一张快照。 | 实时。可更改,且永久公开。 |
| 证据 | 主张。 “部署时间从40分钟缩短到6分钟。” | 展示。 这里有仓库、运行中的东西、笔记本、文章。 |
| 格式限制 | ATS解析,一页,传统布局,无花哨格式。 | 无解析器。可包含截图、图表、较长的叙述、链接。 |
| 失败模式 | 漏掉关键词;不匹配职位描述。 | 死链接,过时内容,或泄露不应公开的信息。 |
最重要的一行是“证据”。 其他所有内容都是其后果。简历只能提出主张——格式没有空间提供证据,读者在浏览的90秒内也无法验证。作品集是工件层:是“部署时间从40分钟缩短到6分钟”变成带有前后CI配置历史的仓库的地方。
这就是构建它的全部原因。如果一个作品集页面不包含指向真实工件的链接,那它就是ATS兼容性更差的简历,不应发布——09-risk-tactics-gate的发布前检查强制执行这一点(见下方“工件链接”)。
各需要何时使用:
- 简历,始终需要。 每份申请。非可选项,本技能不会减少其需求。
- 作品集,当读者在无上下文的情况下访问时。 冷接触(
17-cold-prospecting)、社交简介中的链接、明确要求工作样本的职位、有人推荐他时的转介绍,或任何“你构建过什么”出现在“这是职位说明”之前的对话。 - 两者,需建立链接。 简历携带作品集URL;作品集不复制简历。它们之间的冗余是页面上的空间浪费,也是需要同步的另一件事。
关于当前雇主的考虑。 简历只发给一个收件人。作品集可由任何人发现,包括当前雇主,发布作品集是一个轻微可见的行为。16-career-pulse的谨慎模式处理适用:如果Kene正在低调求职,这是决定是否发布作品集的真实输入,技能在首次发布时提出此问题,而不是提前假设。
工件链接——首要内容,而非页脚
没有链接的作品集就是简历。链接是它的目的,因此应获得一等公民待遇,而不是放在底部的“精选作品”列表。
每个工作项可以携带一个或多个工件:
| 类型 | 备注 |
|---|---|
deployed | 运行中的东西。最有价值的链接——读者可以在10秒内使用它。 |
repo | GitHub/GitLab。链接到仓库根目录,除非某个特定文件是关键;深入链接到单个文件看起来像cherry-picking。 |
notebook | Colab, Jupyter, Kaggle。请参阅下方的可读性说明。 |
writeup | 博客文章、设计文档、事后总结。通常是代码不可共享的工作最有力的工件。 |
demo | 如果东西无法公开发布,则提供屏幕录制。两分钟,不需要旁白。 |
package | npm, PyPI, crates.io——一个已发布的、可安装的东西。 |
paper | arXiv或已发表的会议论文。 |
Notebooks需要比仓库更严格的可读性检查。 一个清除了输出的.ipynb文件对快速浏览的人来说是一堵代码墙,证明不了任何东西。应链接渲染后的形式——可运行的Colab链接,或nbviewer / GitHub自有渲染器且输出已提交——并确保顶部的单元格说明该Notebook的用途。一个第一眼看到的是import pandas as pd的Notebook是一个读者会关闭的链接。
仓库需要一个能撑过三十秒的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有三种模式,它们需要真正不同的页面,因为读者的问题不同:
| 推销模式 | 读者的问题 | 页面开头的内容 |
|---|---|---|
| 角色匹配 | “他能做我们已有的工作吗?” | 与应用程序变体形状相同。通常是相同的变体。 |
| 角色创造 | “这个职能值得在此创造吗?” | 该职能要解决的问题,并通过他解决该问题的工作来证明。角色是论点,而不是简历。 |
| 服务 | “我会为某件确定的工作聘请这个人吗?” | 范围、可交付成果和可比过往工作。最接近咨询页面——而面向角色的作品集会误读这一点。 |
角色匹配冷接触通常不需要单独的变体——它重用匹配的目标头衔变体。只有角色创造和服务推销通常需要自己的变体,并且仅在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使用自然语言添加、删除和重新排序——“删除第二个,将支付工作移到顶部,添加我为合作社做的那件事。”确认一次,写入manifest。
重新构建绝不会静默地重新选择。 每次都以现有选择为起点。Kene策划过的页面不应因为新的STAR条目出现而静默地重新排列。
新材料被提供,而非插入。 当有新条目进入库中,并且对现有变体排名很高时,季度刷新会提出一次——“这个非常适合金融科技变体,要添加吗?”这是一个问题,而不是代表他应用的差异。
发布
静态HTML,一个文件加资源,无需构建步骤,无需框架。输出内容可读且可手动编辑,因为Kene会想手动编辑它,而一个生成的、他无法触碰的文件比没有文件更糟糕。
关于托管位置的问题,以及如果他不在乎会怎样
首次发布时问一次。 不在生成...