Communitygithub.com

chongdashu/cc-skills

智慧型 Open Graph 圖片產生技能,能研究你的程式碼庫、理解路由與品牌識別,然後使用 Playwright 與 React 元件建立脈絡適當的 OG 圖片。觸發詞:「create og images」、「generate social cards」、「add open graph images」。

cc-skills 是什麼?

這項技能專門為開發者與 AI 代理(如 Claude Code、Cursor)提供一種自動化且品牌導向的 Open Graph(OG)圖片生成方式。它會先深度分析你的程式碼庫,自動偵測路由結構(支援 Next.js、Astro、React 等框架)並提取品牌識別元素(如顏色、字型、商標與設計模式),然後根據每個頁面的類型(如首頁、文章、產品頁)設計對應的佈局,最後使用 Playwright 將 React 元件渲染成標準尺寸(1200x630)的 OG 圖片。這項技能能避免使用泛用模板,確保產出的圖片與網站風格一致,並提供自動化腳本進行批量生成與驗證,適合需要提升社群分享體驗的專案。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chongdashu/cc-skills/tree/HEAD/.claude/skills/og-image-creator

在你喜歡的 AI 中提問

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

說明文件

OG 圖片建立工具

透過理解你的程式碼庫,自動建立品牌一致、脈絡適當的 Open Graph(OG)圖片。它會分析你的專案,然後使用 Playwright 與現有元件,為每個路由產生符合情境的圖片。

理念:真實性勝於模板

在產生 OG 圖片前,請先確認:

  • 這個網站的品牌識別是什麼(顏色、字型、商標、設計語言)?
  • 存在哪些路由/頁面,它們的目的是什麼?
  • 有哪些元件與素材可以重複使用以確保一致性?
  • 哪些頁面類型需要不同的視覺處理?

核心原則:

  1. 先研究再產生:在建立任何內容前,先了解程式碼庫的結構、路由與品牌
  2. 真實性勝於模板:使用實際的品牌顏色、字型與元件,而非通用的社交卡片模板
  3. 脈絡感知設計:首頁、文章、產品與文件需要不同的視覺方法
  4. 智慧自動化:自動偵測路由並提取品牌資訊,同時允許使用者自訂

工作流程

1. 探索與分析

路由探索:

  • 分析專案結構以判斷框架(Next.js、Astro、React 等)
  • 根據框架慣例自動偵測路由:
    • Next.js:app/*/page.tsx 或 pages/*.tsx
    • Astro:src/pages/*.astro
    • React Router:分析路由設定
  • 從頁面中提取路由中繼資料(標題、描述)
  • 分類頁面類型(首頁、文章、產品、關於等)

品牌提取:

  • 尋找商標/圖示檔案(偏好 SVG)
  • 從 CSS/Tailwind 設定中提取色彩調色盤
  • 從樣式表或設定中識別主要字型
  • 從現有元件中捕捉設計模式

使用 scripts/analyze_codebase.py 自動探索。

2. 設計策略

根據頁面類型決定適當的佈局:

  • 首頁:大膽、簡潔,強調價值主張
  • 文章/部落格:標題 + 摘要,必要時包含日期/作者
  • 產品頁面:產品名稱、主要功能,如有視覺素材可加入
  • 文件:主題 + 描述,組織化/結構感
  • 關於/公司:品牌導向、專業

佈局原則:

  • 充足的留白(避免雜亂)
  • 高對比度以確保在分享時可讀
  • 品牌色彩作為點綴,而非壓倒性元素
  • 與網站相符的層級排版
  • 1200x630px(標準 OG 尺寸)

3. 產生圖片

基於元件的產生方式:

  • 盡可能重複使用 React 元件以確保一致性
  • 使用 Playwright 將元件渲染為圖片
  • 套用品牌顏色、字型與素材
  • 注入實際的頁面中繼資料(非佔位符)

技術方法:

  1. 建立包含品牌樣式的簡潔 HTML 模板
  2. 對每個路由,產生頁面專屬的標記
  3. 使用 Playwright 在 1200x630 解析度下截圖
  4. 儲存至 public/og/ 或適當的靜態目錄
  5. 更新頁面中繼資料以引用 OG 圖片

使用 scripts/generate_og_images.py 進行自動化。

4. 驗證與最佳化

  • 驗證 HTML 中的 OG 圖片中繼資料
  • 使用 OG 預覽工具(opengraph.xyz、linkedin inspector)進行測試
  • 確保檔案大小合理(建議 <200KB)
  • 檢查圖片在不同縮放比例下的顯示效果

各框架專屬指南

Next.js

App Router:

// app/page.tsx
export const metadata = {
  openGraph: {
    images: ['/og/home.png'],
  },
}

Pages Router:

// pages/index.tsx
<Head>
  <meta property="og:image" content="/og/home.png" />
</Head>

動態 OG 圖片:考慮使用 Next.js OG Image Generation(@vercel/og)處理動態內容,但為了品牌一致性,建議採用靜態產生。

Astro

---
// src/pages/index.astro
const ogImage = '/og/home.png';
---
<head>
  <meta property="og:image" content={ogImage} />
</head>

React SPA

在 public/index.html 中加入 OG 標籤,或使用 react-helmet:

<Helmet>
  <meta property="og:image" content="/og/home.png" />
</Helmet>

應避免的反模式

❌ 泛用模板:不要使用忽略網站品牌的現成社交卡片模板

  • 為何不好:會造成網站與社群分享體驗之間的斷層
  • 更好做法:提取實際的品牌顏色、字型,並一致使用

❌ 單一尺寸適用所有:不要對所有頁面類型使用相同的 OG 圖片設計

  • 為何不好:錯失了脈絡適當呈現的機會
  • 更好做法:針對首頁、文章、產品等採用不同的佈局

❌ 佔位符內容:不要使用「Lorem ipsum」或泛用文字

  • 為何不好:違背了預覽圖片的目的
  • 更好做法:使用來自中繼資料的實際頁面標題與描述

❌ 過度擁擠:不要塞入太多文字、圖片或複雜佈局

  • 為何不好:在社群動態中縮放後難以閱讀
  • 更好做法:聚焦 1-2 個關鍵元素,搭配充足的留白

❌ 忽略現有元件:不要從頭建立 OG 圖片,如果已有現成元件

  • 為何不好:破壞了與網站的視覺一致性
  • 更好做法:重複使用按鈕樣式、卡片佈局、元件的排版

❌ 手動產生:不要一個接一個手動建立 OG 圖片

  • 為何不好:無法擴展,難以維持一致性
  • 更好做法:將產生過程腳本化,處理所有路由

變化指引

重要:OG 圖片應根據頁面脈絡有所變化,而非收斂到單一設計。

可變化的維度:

  • 佈局:置中 vs 靠左、單欄 vs 雙欄、文字 vs 視覺焦點
  • 色彩強調:主要品牌色 vs 中性色、漸層 vs 純色
  • 內容層級:大標題 vs 平衡的標題+描述
  • 視覺元素:商標大小/位置、裝飾元素、圖示
  • 排版:字型大小比例、粗細分布、字型搭配

避免收斂到:

  • 所有地方都用相同的漸層背景
  • 相同的「標題 + 商標」佈局
  • 單一字型大小比例
  • 固定的商標位置

由脈絡驅動變化:

  • 技術文件 → 簡潔、有組織、以圖示為基礎
  • 行銷首頁 → 大膽、色彩豐富、以價值為焦點
  • 部落格文章 → 讀者友善、包含作者/日期脈絡
  • 產品頁面 → 強調視覺產品

技術需求

相依套件(視需要安裝):

npm install playwright sharp
# 或
pip install playwright Pillow

Playwright 設定:

playwright install chromium

檔案結構:

project/
├── public/og/          # 產生的 OG 圖片
│   ├── home.png
│   ├── about.png
│   └── ...
└── scripts/            # 產生腳本
    ├── analyze_codebase.py
    └── generate_og_images.py

切記

OG 圖片是品牌的延伸,而非泛用的社交卡片。

研究程式碼庫以了解設計語言。提取品牌識別。使用實際的元件與內容。建立看起來像網站原生部分的脈絡適當圖片。

當有人分享你的頁面時,OG 圖片應該像自然的預覽——而不是硬貼上去的模板。

你有能力建立精緻、品牌一致的 OG 圖片,強化而非削弱網站的身份認同。

相關技能