Communitygithub.com

oneconsciousness/job-hunt-with-hope

当用户想要生成一个作品集——他们的工作、他们的故事、他们的证据——作为一个自包含的品牌作品集文件夹(离线可用——本地服务或直接打开),他们可以发送给招聘人员、作为链接发布或保存为PDF。这是Hope的标志性技能。

job-hunt-with-hope 是什么?

该技能用于生成一个完全自包含、离线可用的品牌作品集文件夹,包含结构化的HTML、CSS和JavaScript文件。它从用户的职业图谱中提取数据,创建一份精心策划的作品展示,包括身份卡、时间线、精选经历、项目、技能、教育背景和联系方式。用户可以选择针对特定职位的作品集,此时技能会根据职位要求匹配合适的经历和技能进行优化排序;也可以生成一个通用的展示最强工作成果的作品集。 输出包含四个核心文件:`index.html`(SEO优化的外壳)、`portfolio.css`(完整样式表)、`portfolio.js`(运行时渲染引擎)和`data.js`(包含所有数据——无硬编码颜色或值)。此外,还会生成两个用于社交分享的卡片页面。整个文件夹只需一个浏览器即可完全运行,无需网络连接。 该技能的核心原则是:永不编造事实,所有内容必须源自用户的职业文件或聊天中的陈述。它采用Hope独特的视觉风格——温暖的奶油色和橙色主题、可切换的深色模式、六边形KPI徽章、网格纹理和扫描线叠加效果。每个经历卡片都围绕一个具体问题或时刻展开,展示改变和可衡量的影响,而非简单的职责列表。

兼容平台✓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 是通过安装、市场缓存还是 --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"   # 在读取捆绑文件之前进行 sanity-check

如果 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 元数据被标记的地方。
  • portfolio.css——完整的样式表;设计令牌(:root)仅存于此(包括 15 个 seg-tier / cat / integrity 令牌——见 design-tokens 规范)。
  • portfolio.js——完整的行为脚本以及完整的运行时渲染器——它根据 window.HOPE_DATA 构建整个可见的 <body>。
  • data.js——一个经典的脚本,定义一个全局变量 window.HOPE_DATA = {…}:整个页面的完整数据集(元数据 + confidence 映射、身份信息、概述、经历、项目、技能、教育背景、认证、简历、时间线、traveler、社交信息),仅包含语义值——不含十六进制颜色,照片以 data: URL 形式嵌入。模板的 data.js 承载了完整的字段级编写契约(window.HOPE_DATA 的 schema)——在输出前阅读它,并将其视为字段类型和可选性的权威来源。

——以及同一文件夹中的两个分享卡片页面(share-card.html 和 share-card-square.html)——见下面的“分享卡片和链接预览元数据”。

自包含的承诺是针对文件夹级别的:这个文件夹只需要一个浏览器——完全离线可用。 (打开方法:见“展示它”步骤——在 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 标签。
  • 连线(The Throughline)——身份卡底部的动态职业时间线条(id="throughline"):每个包含的经历/教育/项目/认证对应一个六边形节点,一个播放头在轨道上移动,悬停时显示迷你卡片,点击可导航到每个条目对应的卡片。此条的外观和动画归模板所有;你的工作是数据集和卡片锚点——见下面的“连线——时间线数据契约”。
  • 概述应用(可选)——一个章节网格标签,不是独立的条带:一个网格瓦片(data-section="overview",标签为“概述”,图标 insights,元计数“{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 元数据、分享卡片)。

如何选择内容

阅读用户的职业图谱。如果目标职位已命名(例如 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,以及他们的 traveler 选择 "timeline_traveler"(见下面的应用目录和 traveler 选择器——每个作品集的展示偏好,而非人员事实)。这意味着用户的图谱会记住针对哪个角色发出了哪份策划内容。

作品集文案中的语音风格

Hope 从不编造关于用户的事实。 你写的每一行——一个要点、一个评级、一个计划、一个声明——都必须追溯到职业文件或用户在此次聊天中的原话;一个你无法找到来源的声明就是一个你不该做出的声明。这是 Hope 网站上明确承诺的,每个技能都遵守它。

你不是在写简历。你是在用 Hope 的语音风格写一份设计性的工作陈述。

每个经历卡片应该:

  • 以一个具体的时刻或问题开始,而不是职位总结
  • 展示用户的行动带来了什么改变(带指标)
  • 避免使用“负责”之类的语言——用展示代替说教
  • 每个卡片 60-120 字,不要更长

示例转换:

❌ “Figma 高级产品设计师。负责设计系统、指导初级设计师、领导跨职能计划。”

✅ “当 Figma 的设计系统在 2023 年开始在不同产品团队间碎片化时,我领导了整合工作。八个月后,公司 37% 的表面区域统一到了新系统上,新设计师的入职时间从三周缩短到一周。困难的部分不是组件——而是让十二个产品团队就一个按钮达成一致。”

用户可以进行编辑,但初稿应该让人感觉是 Hope 写的。

视觉质量标准

这是可见的区分点。作品集令人 unmistakably 地看起来像 Hope 的产物——布局和质感是品牌,颜色是主题:

  • 默认浅色主题(温暖的奶油色+橙色)。通过切换按钮使用深色主题,布局保持一致。
  • 交互式章节网格——点击章节过滤下方内容;激活的标签为纯橙色,带有发光效果和 integrity 条。
  • 每个角色上的六边形 KPI 徽章(人员/组/监控)。
  • 贡献卡片分组为 IC vs 领导力;技能按类别分组,带有 4 级条状可视化;项目渲染为与经历相同的可展开 .item-card(见下面的项目循环契约),以便每个项目的完整故事得以展示。
  • LIVE 标签位于身份行内,右上角。
  • 卡片上的扫描线叠加效果 + 身份头部上的 32×32 网格纹理 + 微妙的发光效果。这些质感是签名——没有它们,设计看起来会很泛泛。
  • 正文使用 Inter,所有元数据使用 JetBrains Mono。Material Symbols Rounded 带内联 SVG 后备。
  • 通过 Google Favicon 获取真实组织 logo,并带有字母标记后备。
  • 文件夹级别自包含(见“该技能输出什么”)。除了可选的 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 的编写契约

构建契约(运行时数据驱动)

作品集不是通过将令牌替换到静态标记中来构建的。AI 代理输出一个结构化的数据集,然后随附的 portfolio.js 在运行时从该数据集渲染整个可见的 <body>。新模板中没有 {{…}} 内容令牌,也没有 <!-- HOPE:*_loop --> 标记——它们已被 window.HOPE_DATA 取代。按以下顺序执行步骤:

  1. 从图谱中策划(见下面的“如何选择内容”):身份信息、概述、经历(IC/领导力分组、角色发展形态)、项目、技能(按类别、级别 1-4+年限)、教育背景、认证、简历(带有附加 tag 的要点;Education = 仅学位)、时间线、社交信息以及每个部分的 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: 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)并在 index.html 中链接它们。它们共享同一个 window.HOPE_DATA——确保两个页面加载它。卡片使用 identity.photo(或备用图像)、身份信息、关键指标和调用动作按钮。index.html 的 <head> 在 og:image/twitter:image 中引用 share-card.html 的 URL(由发布技能填充)。

相关技能