Communitygithub.com

donotdonuts/claude-workflow-skills

從 donotdonuts.github.io 模板引導建立個人作品集網站。收集使用者的姓名、照片、履歷、社交連結與視覺偏好,從履歷生成時間軸/專案卡片/聊天機器人知識,並套用匹配的色板。可選用 DeepSeek 聊天機器人 (後端為 Cloudflare Worker);使用者命名機器人,AI 代理會提議相符的表情符號頭像。靜態網站部署至 GitHub Pages。

claude-workflow-skills 是什麼?

此技能引導使用者建立個人作品集網站,網址為 `https://<使用者名稱>.github.io`。它使用固定的架構,但會根據使用者的履歷、照片、社交連結和視覺風格偏好進行客製化。網站包含英雄區、專案時間軸、可摺疊的專案卡片,以及可選的 DeepSeek 聊天機器人 (後端為 Cloudflare Worker)。該技能會自動從履歷生成內容,並根據使用者選擇的參考 URL 或文字描述來調整 CSS 變數 (色彩、字體)。此代理程式支援 Claude Code、Cursor 與 Codex 等平台,提供逐步自動化流程:建立 GitHub 儲存庫、複製模板、套用視覺主題、生成內容、調整頭像、設定聊天機器人,以及部署至 GitHub Pages。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/donotdonuts/claude-workflow-skills/tree/HEAD/skills/random-skills/personal-site-setup

在你喜歡的 AI 中提問

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

說明文件

個人網站設定

引導新使用者建立他們自己的作品集,網址為 https://<他們的使用者名稱>.github.io。架構是固定的;外觀、文案和聊天機器人角色會根據特定使用者進行客製化。

他們會得到什麼

  • 單頁靜態網站,無需打包工具。GitHub Pages 從 main 分支提供服務,儲存庫根目錄即為網站根目錄。
  • 英雄區 — 他們的頭像 + 姓名 + 一行位置 + 一行標語。
  • 專案區,包含部分標題區的淡出垂直時間軸 (扳手圖示代表工作、書本圖示代表教育、火花圖示代表氛圍/ side-project;每個節點顯示公司、角色、日期、地點) 和主要區域的專案卡片網格 — 兩者皆從使用者的履歷生成。
  • 時間軸 ↔ 卡片篩選 — 懸停或鍵盤聚焦時間軸節點可隱藏不相關的專案卡片;點擊可固定篩選 (再次點擊清除)。只有擁有 ≥1 張關聯卡片的節點才會變為可互動;其他節點保持靜態。
  • 可摺疊卡片 — 預設情況下,每張專案卡片只顯示其類別 + 標題 + 工具標籤;摘要段落和指標行在懸停/聚焦時顯示,保持網格易於掃視。
  • 聊天機器人 (可選) — 浮動的右下角啟動按鈕 + 彈出面板 (非行內頁面區塊),後端由 DeepSeek 的 OpenAI 相容 API 支援,背後有一個 Cloudflare Worker 持有 API 金鑰。使用者選擇機器人名稱;代理程式提議相符的表情符號頭像。機器人回覆會渲染 Markdown。雙層速率限制。
  • 聯絡區 — 電子郵件 + 使用者的社交連結。

先決條件

需要於工具安裝方式
所有功能git通常已安裝
所有功能GitHub 帳戶 + gh CLIbrew install gh 然後 gh auth login
所有功能python3 (本機預覽)通常已安裝
聊天機器人Cloudflare 帳戶 (免費方案)https://dash.cloudflare.com
聊天機器人wrangler CLInpm install -g wrangler 然後 wrangler login
聊天機器人DeepSeek API 金鑰https://platform.deepseek.com/ → API keys
頭像調整Node.jsbrew install node

逐步說明

1. 收集使用者的輸入

在觸碰任何檔案之前執行此步驟。 一次收集所有資訊,以便後續步驟可以自動化編輯。對於多選題使用 AskUserQuestion,對於自由文字使用直接提示。

從使用者取得以下每個項目:

輸入如何詢問範例
GitHub 使用者名稱直接提示jane (儲存庫將是 jane.github.io)
顯示名稱直接提示Jane Doe 或 Jane "JD" Doe
位置短語直接提示,簡短NYC metropolitan, Remote, Tokyo
標語直接提示,一句話I build ML systems and love shipping.
履歷貼上文字或檔案路徑完整的履歷 — 用於填充時間軸、專案卡片、聊天機器人知識
照片磁碟上的正方形圖片路徑/Users/jane/Desktop/headshot.jpg。使用者可以在 clone 後將其放在儲存庫根目錄,命名為 raw.jpg。
社交連結直接提示,每個皆為選填LinkedIn / GitHub 個人檔案 / Medium / 個人電子郵件
聊天機器人?AskUserQuestion是 / 否
聊天機器人名稱 (如果是)直接提示Pot, Nova, Echo 等
視覺風格AskUserQuestion"貼上我喜歡的 URL" 或 "用文字描述"

收集聊天機器人名稱後,提議 2-3 個主題匹配的表情符號頭像,讓使用者選擇。範例:

名稱提議的頭像
Pot🫖 (茶壺) · 🍲 · 🎨
Nova🌟 · 💫 · 🌠
Echo📣 · 🔊 · 🌀
Ember🔥 · 🪵 · ✨
Atlas🗺️ · 🧭 · 🌍
Bit💾 · 🔢 · 🤖
Sage🌿 · 📖 · 🦉

如果沒有明顯適合的,提供中性選項:🤖, 💬, 🪄。儲存所選的表情符號 + 名稱 — 稍後你會將它們寫入程式碼。

2. 建立 GitHub 儲存庫

gh repo create <username>.github.io --public --description "Personal website"

GitHub Pages 使用者網站必須位於 <username>.github.io。

3. 複製模板

git clone https://github.com/donotdonuts/donotdonuts.github.io my-site
cd my-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<username>/<username>.github.io.git

4. 選擇視覺風格

模板預設為奶油色 + IBM Plex Mono 美學。根據使用者在步驟 1 的回答覆寫它。

4a. 如果使用者提供了 URL

抓取頁面的 CSS 並提取 token:

curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<css-path>" -o /tmp/ref-1.css

# 實際應用於 body 的字型
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# 所有 CSS 自訂屬性定義
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60

尋找:背景十六進位色、前景/墨色十六進位色、邊框十六進位色、強調色十六進位色、應用於 body 的 font-family、@font-face URL。

4b. 如果使用者提供了描述

將描述轉換為具體的 token。啟發式規則:

詞語含義
"minimal", "editorial", "paper"奶油色 / 米白色背景,深色墨色,細分隔線
"dark", "terminal", "IDE"近黑色背景 (#0f1115),淺色墨色,微妙的灰色邊框
"warm", "analog"略帶黃色的奶油色 (#faf5e8),棕黑色墨色
"brutalist"純白或純黑,2px+ 實心邊框
"techy", "data"等寬字型 (IBM Plex Mono, JetBrains Mono),冷灰色
"magazine", "editorial"襯線字型 (EB Garamond, Fraunces),寬鬆行距
"playful"一種飽和的強調色,其餘柔和

4c. 提議 + 套用

編譯 13 個 token + 一個字型堆疊。在編輯檔案之前,將提議的色板顯示為程式碼區塊並取得批准。

:root {
  --bg:             <hex>;   /* 頁面背景 */
  --bg-soft:        <hex>;   /* 子面板 — 通常是 --bg 混合約 3% 的 --ink */
  --bg-hover:       <hex>;   /* 標籤/晶片懸停 */
  --card-bg:        <hex>;   /* 不透明卡片填充 (淺色主題則為白色) */
  --ink:            <hex>;   /* 主要文字 */
  --ink-soft:       <hex>;   /* 約 80% 的 --ink */
  --ink-mute:       <hex>;   /* 約 60% */
  --ink-faint:      <hex>;   /* 約 40% */
  --border:         <hex>;   /* 微妙分隔線 */
  --border-strong:  <hex>;   /* 承重分隔線 */
  --up:             <hex>;   /* 正面指標 (預設為偏綠色) */
  --down:           <hex>;   /* 負面指標 (預設為偏紅色) */
  --accent-ink:     <hex>;   /* 連結 */
  --font-mono:      "<Family>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

然後:

  1. 開啟 css/styles.css,找到 :root 區塊,替換數值。
  2. 開啟 index.html,更新 <head> 中的 Google Fonts <link>,使用新的字型系列 + 字重。

5. 從履歷 + 輸入生成內容

使用步驟 1 的履歷和其他輸入來填充 index.html:

  1. <head> — <title> = <顯示名稱> — <履歷中的第一個角色>;<meta name="description"> 來自標語。

  2. 英雄區:

    • <h1 class="hero-title"> ← 顯示名稱
    • <p class="hero-location"> ← 位置短語
    • <p class="hero-tagline"> ← 標語
  3. 時間軸 — 將履歷解析為節點。每個角色、每個學位以及每個使用者想要展示的正在進行的個人 side-project 類別各一個 <li class="tl-stop">。順序為現在 → 最早 (DOM 中由上到下)。 為每個節點選擇一個簡短的 data-experience slug (例如 mars, vibe, coach, gatech) — 這是篩選器用來連結節點和卡片的。僅在擁有 ≥1 張關聯專案卡片的節點上添加 tabindex="0" (其他節點保持靜態)。

    <li class="tl-stop tl-stop-work" data-experience="<slug>" tabindex="0">
      <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe   (選擇一個) -->
      <svg class="tl-icon tl-icon-work" aria-hidden="true">
        <use href="#icon-wrench"/>       <!-- #icon-wrench | #icon-book | #icon-sparkle -->
      </svg>
      <div class="tl-info">
        <strong>公司 / 學校</strong>
        <span>角色 / 學位</span>
        <em>開始 — 結束</em>
        <i class="tl-loc">城市, 州</i>
      </div>
    </li>
    

    在沒有關聯專案卡片的教育/舊角色節點上去掉 tabindex="0" — js/main.js 會在載入時自動偵測這些節點並讓它們保持非互動。

  4. 專案 — 約六個 <article class="project-card"> 區塊,從履歷中顯著的專案/成就生成。每張卡片必須攜帶一個 data-experience slug,與其來源的節點匹配,否則它將不參與篩選:

    <article class="project-card" data-experience="<slug>">
      <header class="project-head">
        <span class="project-tag">類別</span>
        <h3>專案標題</h3>
      </header>
      <p>1–2 句摘要,取自履歷要點。</p>
      <dl class="project-metrics">
        <div><dt>指標</dt><dd class="up">+數值</dd></div>
        <div><dt>指標</dt><dd>數值</dd></div>
      </dl>
      <ul class="tag-list small"><li>工具</li><li>工具</li></ul>
    </article>
    

    使用 <dd class="up"> / <dd class="down"> 為指標上色。卡片預設渲染為摺疊狀態 — 僅標籤、標題和工具標籤可見,直到懸停 / focus-within 揭示摘要 + 指標。保持摘要簡潔;它們存在的唯一目的是獎勵懸停行為。

  5. 聊天問候語 — 機器人的開場訊息是 index.html 中 #chat-panel 內的行內 HTML (在面板的 <div class="chat-log"> 內部),這樣當使用者首次開啟彈出視窗時它會立即渲染。使用所選的機器人名稱 + 頭像表情符號重新編寫。格式:

    <div class="chat-msg chat-msg-bot">
      <span class="chat-avatar" aria-label="<機器人名稱>">表情符號</span>
      <div class="chat-bubble">
        <p>嗨,我是 <strong><機器人名稱></strong> — <顯示名稱> 的 AI 助手,從他/她的履歷中 <動詞變化> 而來。</p>
        <p>你可以問我關於:</p>
        <ul>
          <li>公司 / 角色</li>
          <li>方法 / 途徑</li>
          <li>專案 / 技能 / 學歷</li>
        </ul>
        <p>你想了解什麼?</p>
      </div>
    </div>
    
  6. 聯絡區 — 電子郵件 + 每個提供的社交連結作為 .connect-list 中的 <li>。刪除任何未提供平台的行。

6. 添加頭像

詢問他們的照片在哪裡。將其複製到儲存庫根目錄,命名為 raw.jpg,然後調整大小:

cp <使用者照片路徑> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg

如果照片的背景與新的 --bg 不匹配,使用捆綁的腳本進行調整:

cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <此技能目錄>/scripts/shift-portrait.js \
  /path/to/my-site/raw.jpg \
  /path/to/my-site/assets/portrait.jpg \
  "#<你的背景十六進位色>"

如果省略第三個參數,預設為 #fbf7eb。raw.jpg 已被 .gitignore 忽略。

7. 設定聊天機器人 (如果使用者說不則跳過)

7a. Worker

cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY

worker/wrangler.toml:

ALLOWED_ORIGIN = "https://<username>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL          = "deepseek-chat"

worker/worker.js → SYSTEM_PROMPT — 從使用者的履歷重新編寫。保持段落結構 (關於 / 目前角色 / 過去角色 / 學歷 / 工具箱)。也使用機器人的名稱 + 頭像重新編寫開場角色句子:

const SYSTEM_PROMPT = `You are "<機器人名稱>" <表情符號> — a friendly, concise AI assistant embedded on <顯示名稱>'s personal website. …`;

部署:

wrangler deploy

7b. 客戶端

js/config.js:

window.SITE_CONFIG = {
  chatWorkerUrl: "https://<worker>.workers.dev",
};

js/chatbot.js — 更新頂部的常數:

const AVATAR = "<表情符號>";
const AVATAR_LABEL = "<機器人名稱>";

8. 預覽 + 推送

python3 -m http.server 8000       # http://localhost:8000

點擊每個部分進行檢查。測試聊天功能。調整為行動裝置寬度。然後:

git add .
git commit -m "initial: personal site"
git push -u origin main

網站位於 https://<username>.github.io/,約 60 秒內上線。

模板架構 (請勿更改)

區塊佈局

每個區塊都使用 .section-grid: 280px 1fr。280px 欄位容納最長的時間軸標籤。如果所有標籤都很短,則縮小為 240px;如果較長,則放大為 320px。

時間軸

  • 位於專案「section-head」內,就在標題下方,opacity: 0.45。懸停、聚焦或啟用篩選時會提高到 0.95。
  • DOM 順序 = 視覺由上到下順序。 現在 → 最早。不是按時間比例 — 透過 flex gap 均勻分佈。
  • 開箱即用三種圖示類型:#icon-wrench (工作, .tl-stop-work)、#icon-book (教育, .tl-stop-edu)、#icon-sparkle (氛圍 / side-project, .tl-stop-vibe)。所有三個 <symbol> 定義都位於 <header> 之後的 SVG sprite 中。要新增圖示類別:
    1. 使用你的 SVG 路徑新增一個 <symbol id="icon-foo">
    2. 新增 .tl-icon-foo { color: var(--ink-mute); }
    3. 使用 <svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg> 引用
  • 每個節點都帶有 data-experience="<slug>";其 slug 與至少一張專案卡片匹配的節點也會獲得 tabindex="0",以便 js/main.js 可以讓它們成為篩選互動式節點。

專案篩選 (點擊 + 懸停)

完全由 js/main.js 驅動,無需配置 — 它在載入時掃描 DOM,僅在適用的地方連接處理常式。

  • 載入時,其 data-experience slug 存在於至少一個 .project-card 上的每個節點都會獲得 .tl-stop-has-projects + role="button" + aria-pressed="false"。沒有關聯卡片的節點保持靜態。
  • 懸停 / 聚焦 一個互動節點 → 臨時篩選:不匹配的卡片變成 .is-dim (網格添加 .is-filtering,CSS 將其轉換為對變暗的卡片使用 display: none — 它們會從佈局中移除,而不僅僅是淡出)。
  • 點擊 (或 Enter / Space) → 鎖定:節點獲得 .is-locked,不透明度全滿,墨色圖示,底線公司名稱。再次點擊同一個節點可清除;點擊另一個可切換。
  • 鎖定時,懸停不同的節點會預覽其卡片;從軌道上 mouseleave (或 focusout 離開它) 會恢復到鎖定的節點。懸停時不會清除鎖定。

相關技能