Communitygithub.com

tangshengming/personal_website

根據 CV 或個人檔案來源,生成第一個個人網站:提取結構化內容、撰寫可審閱的 Markdown 原始檔、確認隱私/受眾/設計決策、規劃網站結構、搭建 Astro 網站,並在本機進行驗證。

personal_website 是什麼?

這個技能專為 AI 代理(如 Claude Code、Cursor、Codex 等)設計,實現「從 CV 到個人網站」的自動化與審慎流程。其核心原則是:在產出網頁之前,先將 CV 提取為可審閱的 Markdown 格式,與使用者確認哪些資訊要公開,再據此搭建網站。支援 PDF、LaTeX、DOCX 等多種來源格式,預設使用 Astro 框架,並可根據產業或學術受眾調整設計方向。工作流程包含檢查工作區、讀取 CV、提取結構化內容、隱私決策、草擬網站結構、搭建 Astro 網站、設計第一版、本機驗證以及更新狀態檔。能有效避免將敏感資訊意外公開,並確保網站具備可擴充的內容結構。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

生成網站

概述

使用此技能來重現一個謹慎的 CV 轉網站工作流程。關鍵原則是先建立可審閱的原始材料,再產生頁面:首先將 CV 提取為 Markdown,接著決定哪些內容公開,最後根據結構化內容建立網站。

工作流程

1. 檢查工作區

在編輯前檢查目前的專案檔案:

  • 尋找工作流程/狀態檔案,例如 WEBSITE_WORKFLOW.md、PROJECT_STATUS.md 或類似檔案。
  • 尋找 CV/個人檔案來源檔案:通常是 .pdf、.tex、.docx,或純文字/Markdown CV。
  • 檢查網站是否已存在:package.json、astro.config.*、src/、public/、dist/。
  • 在必要時使用 git status --short 快速檢查 Git 狀態。

不要假設專案是空白的。

2. 讀取與檢查 CV

如果來源是 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

包含:

  • 設計方向
  • 目標受眾
  • 導覽列
  • 頁面列表
  • 頁面用途
  • 每個頁面的建議內容
  • 待解決問題或決策
  • 技術建議

一個良好的初始結構:

  • 首頁
  • 關於我
  • CV
  • 專案
  • 聯絡方式

對於研究型個人檔案,保留未來加入學術網頁呈現頁面的空間。

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/

從結構化原始檔案建立網站內容,而不是將 CV 文字四處寫死在頁面中。

建議的內容檔案:

  • src/content/profile.ts:用於身份、個人簡介、專業領域、經歷、教育、著作。
  • src/content/projects.ts:用於專案條目及後續呈現備註。

將公開資產複製到 public/:

  • CV PDF(如果使用者想要可下載的 CV)。
  • 頭像圖片(如果可用且已批准)。
  • 之後的專案圖片或圖表。

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 詳細資料。

輸出期望

在第一個迭代結束時,專案應包含:

  • 提取出的 CV 原始 Markdown。
  • 網站結構草稿。
  • 一個可運作的 Astro 網站。
  • 內容與頁面/佈局程式碼分離。
  • 成功的建置。
  • 本機預覽 URL。
  • 關於待辦事項的明確備註。

Individual skills in this repo

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

相關技能