作品集单页
何时应用此技能
当Kenechukwu需要一个代表他工作的单一公开页面时使用——用于申请中的链接、冷外联签名、社交资料,或者当一个职位明确要求提供作品集时。触发条件:“我需要一个作品集页面”、“当被要求提供工作样本时该链接什么”、“为[职位]搜索构建一个单页”。
此技能记录的决策(A26/A27)
这个决策在多次审查中一直悬而未决,并且它是此套件中唯一产生面向用户的新交付物的补充,而不是改进现有内容。这正是它一直被推迟的原因,而它值得一个明确的答案,而不是又一次推迟。
答案是:构建它,但范围要窄。
支持的理由:单页所需的一切已在套件中,并已根据规则5确认。STAR库有故事,量化门有数字,09-risk-tactics-gate有声明验证环节,21-output-templates有结构系统,17-cold-prospecting已经想要一个链接目标。不构建它意味着Kenechukwu要从这个管线维护的语料库中手动组装——而这正是跨应用程序最可复用的那个工件。
反对的理由,以及它如何塑造范围:作品集既是设计问题也是内容问题,而这个管线不应该是网站构建器。一个带有主题、图库、分析工具和CMS的“作品集系统”将是一个活在求职管线内部的第二产品。
因此范围故意很窄:单个页面,从已确认的记忆中生成,作为静态HTML发布,按目标岗位版本控制。 没有CMS,没有多页面网站,没有主题系统,没有访客分析。如果Kenechukwu想要一个真正的个人网站,这会产生一个好的起始文件,然后他可以将它带到别处——这个技能应该明确说明这一点,而不是朝着那个方向生长。
作品集与定制简历——各自的实际用途
最常见的错误是构建一个更像美化版简历的作品集。它们执行不同的工作,而区别不在于呈现方式。
定制简历 (05-resume-customizer) | 作品集单页 | |
|---|---|---|
| 如何到达读者手中 | 推送。针对一个职位发送给一个雇主。 | 拉取。读者点击链接访问。 |
| 读者已知信息 | 他们手头有职位描述(JD)。他们知道自己要匹配什么。 | 通常什么都不知道。可能是浏览的招聘人员、收到冷邮件的招聘经理、会议上认识的人、刚刚看到他在X上回复的人。 |
| 职位是否存在 | 总是。 | 通常不存在——这正是冷外联的全部基础。 |
| 有效期 | 发送时冻结。快照。 | 实时的。可变的,并且永久公开。 |
| 证据 | 断言。 “将部署时间从40分钟缩短到6分钟。” | 展示。 这里是仓库,正在运行的程序,笔记本,技术文章。 |
| 格式限制 | ATS解析,一页,传统布局,无花哨格式。 | 无解析器。截图、图表、较长叙述、链接。 |
| 失败模式 | 遗漏关键词;与JD不匹配。 | 死链接、内容过时、或泄露不应公开的信息。 |
关键区别在于“证据”一行。 其他一切都是它的结果。简历只能做出声明——格式没有空间提供证据,读者在浏览的90秒内也无法验证。作品集则是工件层:在这里,“将部署时间从40分钟缩短到6分钟”变成了一个仓库,其历史记录中有变更前后的CI配置。
这就是构建它的全部理由。如果一个作品集页面没有指向真实工件的链接,那就是一个ATS兼容性更差的CV,不应该发布——09-risk-tactics-gate的发布前检查强制执行这一点(请参阅下面的“工件链接”)。
何时需要每个:
- 简历,总是需要。 每次申请。不可选,并且这个技能不会减少这一点。
- 作品集,当读者在无上下文的情况下访问时。 冷外联(
17-cold-prospecting)、社交简介中的链接、明确要求工作样本的职位、有人推荐他的姓名时,或者任何“你构建过什么”先于“这是职位说明”的对话。 - 两者,相互链接。 简历携带作品集URL;作品集不复制简历。两者之间的冗余是页面上的空间浪费,也是另一个需要同步的地方。
关于当前雇主的考量。 简历发给一个收件人。作品集任何人都能发现,包括当前雇主,而发布它是一个略微可见的行为。16-career-pulse的谨慎模式处理适用:如果Kenechukwu在悄悄寻找工作,这将是决定是否发布作品集的真实输入,该技能在首次发布时提出一次,而不是假设任何一种情况。
工件链接——主要内容,不是页脚
没有链接的作品集就是简历。链接是它的存在意义,因此它们获得一流待遇,而不是底部的“精选工作”列表。
每个工作项可以携带一个或多个工件:
| 类型 | 注释 |
|---|---|
deployed | 正在运行的程序。最有价值的链接——读者可以在10秒内使用它。 |
repo | GitHub/GitLab。链接到仓库根目录,除非特定文件才是重点;深入链接到一个文件看起来像摘樱桃。 |
notebook | Colab, Jupyter, Kaggle。请参阅下面的可读性说明。 |
writeup | 博客文章、设计文档、事后分析。通常是最强的工件,适用于代码不可共享的工作。 |
demo | 屏幕录制,当程序无法公开部署时。两分钟,无需旁白。 |
package | npm, PyPI, crates.io — 已发布、可安装的东西。 |
paper | arXiv或已发表的会议。 |
笔记本需要仓库不需要的可读性检查。 一个清除了输出的.ipynb是一堵代码墙,对于浏览的人来说证明不了什么。链接渲染后的形式——一个可运行的Colab链接,或带有已提交的输出的nbviewer / GitHub自有渲染——并确保顶部单元格说明笔记本的用途。第一个可见内容是import pandas as pd的笔记本是一个读者会关闭的链接。
仓库需要能存活30秒的README。 如果仓库的README没有说明它是什么以及为什么存在,链接它比不链接更糟。这个技能会标记这一点;但不会修复它,因为修复是Kenechukwu必须做的实际工作。
链接失效会被检查,因为失败是无声且彻底的。 带有死链接的作品集比没有链接的更糟:它看起来粗心大意,而这正是页面存在的目的。每个工件的URL在发布时检查,并在季度刷新时重新检查(shared/applications_db_schema_addendum_18.sql, portfolio_artifacts)。404错误、变为私有的仓库、或现在需要权限的Colab都会通过URL报告——绝不会从页面上静默删除,因为静默删除的工件意味着页面在无人注意的情况下逐渐变弱。
什么可以安全链接——硬边界。 只有Kenechukwu拥有或已公开且获得许可的工件。雇主拥有的代码、内部文档、任何受NDA约束的内容以及任何包含第三方数据的内容都不会放在公开页面上。这在添加时和发布时都会检查,并且这是此技能中唯一没有“Kenechukwu可以覆盖”路径的检查——失败模式是发布了他不拥有的东西,而这会结束职业生涯,而不仅仅是工作。
在基础工作无法展示的情况下,writeup(技术文章)和demo(演示)类型正是为此存在:在一个不泄露任何信息的抽象层次上描述他构建的系统是合法的,并且通常比代码本身更具可读性。
页面内容——六个区块,按顺序
所有内容均来自已确认的记忆;此技能不创造任何事实(规则5)。
- 定位语 — 一句话,说明他做什么以及为谁做。源自
target-profile.yaml的当前目标职位和content-model-overlap.md的框架,在发布前由Kenechukwu确认。这是页面上最难写的一行,也是最值得反复迭代的一行。 - 三到五项工作实例 — 来自STAR库,为目标岗位选择,方式与
05-resume-customizer相同。每个都有情境 → 他做了什么 → 数字。每个数字都带有与简历要点相同的量化门槛。 作品集不会因为是自发布就成为低证据标准的内容;恰恰相反,一个永久存在于公开页面上的声明比一次性发送的文档中的声明更值得谨慎对待。 - 能力总结 — 按技能分组,并附有来自
domain-knowledge.md的证据。分组,而不是标签墙。 - 每项工作的工件链接 — 附加到第2项,而不是单独列在底部。放在其证明的声明旁边的链接是有效的;而放在“精选工作”附录中的同一链接则是读者会跳过的列表。请参阅上面的“工件链接”。
- 联系方式 — Kenechukwu已选择公开的任何方式。默认为无,直到他另行说明。
- 最后更新 — 真实日期。带有过时日期的作品集比没有日期的看起来更糟,这支持了下面的刷新提示,而不是反对显示日期。
变体——两个轴,不是一个
这个技能的第一个版本说“每个目标职位系列一个变体”。这对于申请来说是对的,但对于冷外联来说却不对,后者是截然不同的情况,面对的是不同的读者。
轴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 包含三件事:
- 合格池 — 已确认记忆中的每个STAR条目、能力和工件,每个都带有一行摘要和一个ID。通过扫描构建;Kenechukwu从不手动输入。这是菜单,也是“什么可以放到页面上”的答案。
- 全局规则 —
always_include(始终包含)用于一两个旗舰项目,无论目标如何,它们都应属于每个变体;以及never_include(绝不包含)用于他根本不想公开的任何内容。never(绝不)胜过其他所有规则,包括按变体的选择,并且它是技术上可分享但他宁愿不以此为首要展示的工作的正确归宿。 - 按变体的选择 — 一个有序的ID列表。顺序有意义,并且页面按给定的顺序渲染,因为在单页上,第一项占据了大部分印象。
对话如何进行。 在新建变体时,此技能从池中提出一个选择,并附上每个项的理由,按该目标排名。Kenechukwu用自然语言添加、删除和重新排序——“删除第二个,将支付工作移到顶部,添加我为合作社做的那件事。”确认一次,写入清单。
重建永远不会静默地重新选择。 每次都以现有选择为起点。一个由Kenechukwu策划的页面不应该因为一个新的STAR条目出现而静默地重新排列。
新内容是被提供的,而非被插入的。 当有东西进入库中,且会与现有变体高度相关时,季度刷新会提出一次——“这个非常适合金融科技变体,要添加吗?”一个问句,而不是替他应用的差异。
发布
静态HTML,一个文件加资源,无需构建步骤和框架。输出内容可读且可手动编辑,因为Kenechukwu会想要手动编辑它,而一个他无法触碰的生成文件比没有文件更糟。
托管位置
…