Communitygithub.com

tangshengming/personal_website

根据简历或个人资料源文件生成个人网站:提取结构化内容、编写可审阅的Markdown源文件、确认隐私/受众/设计决策、规划网站结构、搭建 Astro 项目并在本地验证。用户请求生成网站、从简历构建个人网站、将PDF/LaTeX简历转换为作品集、或复现简历转网站的流程时使用。

personal_website 是什么?

该技能实现了一个严谨的简历到网站的转化工作流,核心原则是先创建可审阅的源材料,再生成页面。它支持多种简历源格式(PDF、LaTeX、DOCX、Markdown),自动提取结构化内容到 `content/cv_extracted.md` 文件中。在搭建网站前,该技能会与用户确认隐私设置(如是否公开电话、地址、生日等敏感信息)和受众偏好(行业、学术、混合),并生成网站结构草案(`WEBSITE_STRUCTURE_DRAFT.md`)。它默认使用 Astro 框架搭建内容型个人网站,将内容与页面代码分离,并自动运行本地构建和预览以验证页面效果、隐私合规性和资源加载。该技能适用于 Claude Code、Cursor 等支持自定义技能的 AI Agent 平台,尤其适合需要从 CV 快速生成专业个人网站的场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangshengming/personal_website/tree/HEAD/.codex/skills/generate-website

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

生成网站

概述

使用此技能复现一个从简历到网站的精心工作流。关键原则是在生成页面之前先创建可审阅的源材料:先将简历提取为 Markdown,然后决定哪些内容公开,最后从结构化内容构建网站。

工作流

1. 检查工作空间

在编辑前检查当前项目文件:

  • 查找工作流/状态文件,如 WEBSITE_WORKFLOW.md、PROJECT_STATUS.md 或类似文件。
  • 查找简历/个人资料源文件:通常是 .pdf、.tex、.docx 或文本/Markdown 简历。
  • 检查网站是否已存在:package.json、astro.config.*、src/、public/、dist/。
  • 在有必要时,使用 git status --short 轻量检查 Git 状态。

不要假设项目为空。

2. 读取并检查简历

如果源文件是 PDF:

  • 使用 PDF 技能。
  • 使用 pdfplumber 或其他可靠的 PDF 文本提取工具提取文本。
  • 尽可能将页面渲染为图像并进行视觉检查,以避免误读布局和章节边界。
  • 预计 PDF 文本提取会产生间距/图标伪影;在结构化输出中手动清理这些内容。

如果源文件是 LaTeX:

  • 直接读取 .tex 源文件。
  • 将章节命令、宏和列表视为结构信息。
  • 除非用户要求重新生成 PDF,否则不需要本地 LaTeX 编译。

如果源文件是 .docx:

  • 使用文档技能提取结构和内容。

3. 提取为可审阅的 Markdown

在构建网站页面之前,先创建一个 Markdown 源文件。推荐使用:

content/cv_extracted.md

包含结构化章节,例如:

  • 身份
  • 公开联系方式
  • 私人或隐藏的联系方式/详细信息
  • 个人简介
  • 语言能力
  • 技术专长
  • 专业技能
  • 工作经验
  • 教育背景
  • 出版物
  • 项目
  • 每个项目的网站展示潜力

保持此文件的事实性。它是源材料,不是最终的营销文案。

4. 询问或确认公开/隐私决策

在将个人信息放到公开网站上之前,确认:

  • 公开邮箱
  • 是否显示电话号码
  • 是否显示出生日期
  • 是否显示完整地址
  • 是否显示居住地/签证/驾照详细信息
  • 哪些链接是公开或隐藏的:GitHub、LinkedIn、Google Scholar、ORCID、ResearchGate 等
  • 目标受众:行业、学术、混合、客户、招聘人员、合作者
  • 视觉偏好:简约、学术、表现力强的技术作品集等

默认隐私策略:

  • 隐藏出生日期、电话号码、完整地址、居留许可证、驾驶执照以及类似的敏感信息,除非用户明确希望公开。
  • 优先公开邮箱、城市/国家和选定的专业链接。

5. 起草网站结构

在搭建或大量编辑页面之前先创建结构草案。推荐使用:

WEBSITE_STRUCTURE_DRAFT.md

包括:

  • 设计方向
  • 目标受众
  • 导航
  • 页面列表
  • 页面用途
  • 每个页面的建议内容
  • 未解决的问题或决策
  • 技术建议

一个好的初始结构:

  • 首页
  • 关于
  • 简历
  • 项目
  • 联系方式

对于研究背景浓厚的个人资料,为后续的学术网络展示页面留出空间。

6. 搭建网站

默认使用 Astro 搭建内容丰富的个人网站,除非用户要求其他技术栈。

建议的结构:

src/
  pages/
    index.astro
    about.astro
    cv.astro
    projects.astro
    contact.astro
  content/
    profile.ts
    projects.ts
  layouts/
    BaseLayout.astro
  styles/
    global.css
public/

从结构化源文件构建网站内容,而不是到处硬编码简历文本。

推荐的内容文件:

  • src/content/profile.ts:用于身份、个人简介、专业技能、经验、教育背景、出版物。
  • src/content/projects.ts:用于项目条目以及后续的展示说明。

将公共资源复制到 public/:

  • 简历 PDF(如果用户希望提供可下载的简历)。
  • 头像图片(如果可用且已批准)。
  • 项目图片或图表(后续添加)。

7. 设计首个版本

对于第一个个人网站:

  • 首页直接展示身份和个人简介,而非营销着陆页。
  • 尽可能使用真实的视觉资源。
  • 联系方式注重隐私保护。
  • 构建的页面应能快速浏览,同时为后续扩展留有余地。
  • 对于行业受众,强调工程实用性、研发工作流、技术深度和可迁移能力。
  • 对于学术受众,强调研究问题、方法、出版物和展示流程。

避免过度设计第一个版本。为后续的项目展示页面留出明确的位置。

8. 本地验证

运行:

npm.cmd install
npm.cmd run build
npm.cmd run dev

在 Windows/PowerShell 上,若 npm 被脚本执行策略阻止,优先使用 npm.cmd。

如果 Astro 遥测尝试写入工作空间之外,在 package.json 中设置脚本,例如:

"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"

验证:

  • 构建成功。
  • 本地路由返回 200。
  • 公共资源加载正常。
  • 没有意外显示敏感信息。
  • 尽可能进行浏览器视觉质量检查,或者由用户手动审查。

9. 更新状态和 Readme 文件

如果项目使用了状态/看板文件,请更新它,例如:

PROJECT_STATUS.md

有用的辅助文件:

  • readme_website.txt:如何编辑、预览、构建和提交网站。
  • readme_git.txt:Git 设置和常用命令。
  • WEBSITE_WORKFLOW.md:长期工作流。

保持状态简洁。除非用户要求,否则不要添加多余的 Git 详细信息。

输出预期

在首次构建完成后,项目应包含:

  • 提取的简历源 Markdown 文件。
  • 网站结构草案。
  • 一个可运行的 Astro 网站。
  • 内容与页面/布局代码分离。
  • 成功的构建。
  • 本地预览 URL。
  • 关于待办事项的清晰说明。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能