個人首頁技能
產生精美的個人首頁,並發佈到一個公開網址。
步驟 1 — 讀取使用者資訊
讀取 ~/.clacky/agents/USER.md 和 ~/.clacky/agents/SOUL.md。
擷取所有可找到的資訊:
name— 顯示名稱(預設值:"朋友")occupation— 職稱或角色(預設值:"")bio— 簡短的個人描述(預設值:"")links— 所有社交/聯絡連結,保留其標籤。常見的連結類型: GitHub、Twitter/X、LinkedIn、網站、部落格、Email、Instagram、YouTube、Telegram、微信等。 每個連結:{ label, url, type },其中 type 用於選擇圖示 emoji。ai_name— 來自 SOUL.md 的 AI 助手名稱(預設值:"Clacky")personality— 專業 / 友善 / 創意 / 簡潔(來自 SOUL.md,預設值:"友善")
步驟 2 — 處理刪除請求
如果使用者要求刪除首頁:
- 找到技能自己的目錄(與此 SKILL.md 同一資料夾)。稱之為
SKILL_DIR。 - 執行:
腳本會自動從ruby SKILL_DIR/publish.rb delete~/clacky_workspace/personal_website/token.json讀取 slug。 - 通知使用者其首頁已刪除。在此停止。
步驟 3 — 設計與產生 HTML
撰寫一個完整、自包含的 HTML 檔案,存放至 /tmp/profile-card.html。
您擁有完整的創意自由:
- 版面、字體排印、間距、色彩配置
- 背景(純色 / 漸層 / 低調圖案 / 動畫)
- 連結按鈕樣式(膠囊 / 卡片 / 底線 / 幽靈 / 任意)
- 大頭貼處理(大寫字母搭配顏色、emoji、幾何形狀 — 不需要真實圖片)
- 動畫(微妙的懸停效果、入場淡入等)
- 整體氛圍 — 讓它感覺像真正的個人品牌頁面,而非模板
必須遵守的硬性限制:
- 單一 HTML 檔案,零外部資源 — 無 CDN、無 Google Fonts 網址、無
<img src="http...">。 使用系統字型:'Helvetica Neue', Arial, 'PingFang SC', 'Hiragino Sans GB', sans-serif - 行動裝置優先、響應式 — 必須包含
<meta name="viewport">,在手機螢幕上正常運作 - 有效的 HTML5
- 所有連結在新分頁開啟,加上
rel="noopener" - 徽章 放在某個低調位置:
由 {ai_name} 個人助手製作— 小而低調 - 頁面
<title>:{name} 的首頁或類似名稱
連結圖示(在按鈕文字中使用 emoji 前綴):
| 類型 | Emoji |
|---|---|
| github | 🐙 |
| twitter/x | 🐦 |
| 💼 | |
| website/blog | 🌐 |
| 📧 | |
| 📸 | |
| youtube | ▶️ |
| telegram | ✈️ |
| 預設 | 🔗 |
步驟 4 — 發佈
找到技能目錄(與此 SKILL.md 同一資料夾)。稱之為 SKILL_DIR。
執行:
ruby SKILL_DIR/publish.rb publish \
--name "NAME" \
--html-file /tmp/profile-card.html
- 首次發佈 → 建立新頁面,將 token 儲存至
~/clacky_workspace/personal_website/token.json - 後續執行 → 更新相同網址的現有頁面
擷取 stdout。從以 ✅ 開頭的輸出行中提取 URL。
步驟 5 — 完成
通知使用者的首頁已上線。分享網址。語氣要溫暖自然。
範例(根據個性調整語氣):
你的個人首頁已上線 🌟 → http://localhost:3000/~ya-fei
所有連結都集中在一個地方,隨時可以分享出去。