Resume2Site
使用此技能引导编程智能体从简历素材生成一个精致的、可部署到 GitHub Pages 的个人网站。
此技能并非 CLI、解析器、爬虫、SaaS 应用、Python 包、npm 包或完整的自动化系统。请使用智能体环境可用的文件读取、写入和开发工具。
默认情况下,不需要浏览器、Playwright、截图捕获、本地开发服务器或视觉回归环境。生成静态 HTML/CSS 站点后,运行轻量级基于文件的检查,然后将 output/site/index.html 路径提供给用户,以便其本地预览。浏览器或截图检查仅当用户明确要求或环境明确支持且无需额外设置时才执行。
始终将生成的 HTML、CSS、JSON、Markdown 和资产信用文件写为 UTF-8 编码。每个生成的 HTML 页面必须在 <head> 中包含 <meta charset="utf-8">。
必要工作流程
- 从提供的路径读取用户的简历和可选素材。
- 如果 PDF 或 DOCX 提取不可靠,询问
resume.txt。 - 不要直接根据原始简历生成网站。
- 首先使用
prompts/extract-profile.md创建work/profile.json。 - 如果简历包含头像,请遵循
avatar-rules.md,并在提取可靠时保留它。 - 使用
mode-rules.md选择学术或落地页模式。 - 如果用户尚未选择风格变体和需求,暂停并提出下面的风格录入问题。
- 使用
prompts/plan-site.md、profile-schema.md和information-architecture.md创建work/site-plan.md。 - 在决定哪些内容公开之前,先应用隐私规则。
- 从
style-pack.md和design-token-rules.md中应用所选的内置风格变体。用户提供的截图是可选的补充,而非必要的风格研究。 - 当有用且智能体具备浏览/网络能力时,搜索免费/开源/授权视觉资产。
- 按需生成
output/site/index.html、output/site/styles.css、output/site/README.md、output/site/.nojekyll和资产文件。 - 如果推荐或使用了资产,创建
work/asset-recommendations.md和output/site/ASSET_CREDITS.md。 - 仅基于文件运行轻量级最终质量检查清单,必要时改进页面一次,然后报告本地预览路径。
风格录入
在 work/profile.json 存在后,从 style-pack.md 中推荐一种风格变体,然后在生成网站前提出一个简洁的问题,除非用户已经做出了明确选择。
使用此菜单:
我已阅读简历。推荐风格:<变体>。理由:<一个简短理由>。
请选择主页风格,或回复“使用推荐”:
1. academic-editorial:学术主页风格,适用于论文、研究和以教育为先的个人简介
2. academic-lab:学术实验室风格,适用于 AI、工程、数据或应用研究
3. engineering-commercial:工程商务风格,适用于开发者、算法和数据岗求职
4. business-polished:精致商务风格,适用于产品、咨询、运营、金融或企业简介
5. creative-portfolio:创意作品集风格,适用于设计、媒体、写作、创作者或客户项目
6. minimal-resume-site:简约单页风格,适用于正式或内容简洁的简历
您也可以添加需求,例如语言、是否公开邮箱、是否使用头像、是否搜索背景图片、或浅色/深色偏好。
尽可能使用用户的语言提出此问题。
如果用户回复“使用推荐”、“自动”或类似回答,则继续使用推荐的变体,并在 work/site-plan.md 中记录此假设。
输入
建议但不强制使用以下结构:
input/
resume.pdf 或 resume.docx 或 resume.txt
avatar.png
github_links.txt
paper_links.txt
website_links.txt
style_preference.txt
references/
根据需要创建文件夹。如果用户已经提供了具体的文件路径,则无需要求用户准备此结构。
输出
work/
profile.json
site-plan.md
asset-recommendations.md
final-review.md
output/site/
index.html
styles.css
assets/
README.md
.nojekyll
ASSET_CREDITS.md
切勿将原始简历、私人笔记、隐藏映射或内部提取日志复制到 output/site/ 中。
模式选择
- 学术主页:阅读
academic-layout-rules.md和prompts/generate-academic.md。 - 个人落地页:阅读
landing-layout-rules.md和prompts/generate-landing.md。 - 如果不确定,阅读
mode-rules.md。当证据平衡时,询问用户。 - 风格变体:阅读
style-pack.md并一致使用所选变体。
核心参考资料
workflow.md:完整序列。profile-schema.md:严格的字段、链接和度量范围协定。information-architecture.md:内容优先级和章节顺序规则。privacy-rules.md:公开/私有数据处理。content-rules.md:事实性语言和改写。asset-rules.md:免费/开源/授权资产搜索、验证和信用说明。avatar-rules.md:头像提取优先级和回退规则。style-pack.md:内置学术和落地页视觉风格指南。design-token-rules.md:字体排印、布局、颜色、圆角和反 AI 视觉标记。bad-smell-checklist.md:需要修复的最终内容、设计和资产问题。quality-checklist.md:最终审查标准。
不可妥协项
- 先提取事实,再改写。
- 不得编造缺失的经历、出版物、指标、奖项、隶属关系、顾问、推荐信或凭证。
- 将数字证据保留在其来源上下文中。项目或经验中的数字(如延迟、API 数、测试用例、基准测试结果或成本变化)不得重复用作个人/档案指标。
- 对于缺失的档案字段,使用空字符串或空数组。
- 尽可能保持用户提供的事实可追溯到来源。
- 在公开包含电话号码或敏感个人详细信息之前,先询问用户。
- 不要在 HTML 注释中隐藏原始简历文本。
- 使页面看起来像个人网站,而不是原始简历。
- 不要因为需要截图、浏览器自动化、Playwright 或本地预览工具而阻塞完成。
- 不要默默丢弃已有的简历头像;提取它或记录无法提取的原因。
- 将风格变体名称视为内部实现细节。在
work/site-plan.md中记录所选变体,但不要将诸如academic-editorial、engineering-commercial或“学术编辑风”之类的名称作为可见的页面标题、英雄文本、导航标签、标题或页脚显示,除非用户明确要求。 - 对生成的文本文件使用 UTF-8 编码,并在生成的 HTML 中包含
<meta charset="utf-8">。