Community影像github.com

review-posts

將任何企業的最新五星評論(Google、Yelp、BBB、Facebook、Trustpilot、Houzz、Angi、企業自家網站或貼上的文字)轉換為可直接發佈的 Instagram 圖片(1080×1350),保持企業品牌風格,附帶說明文字與核准表。

review-posts 是什麼?

此技能專為非技術背景的企業主或行銷人員設計,能自動從企業網站擷取品牌元素(商標、顏色、字型、背景照片),並將五星評論轉化為四種版型的 Instagram 圖片(1080×1350)。首次使用需花約 10 分鐘設定品牌,技能會從企業網站讀取品牌資料,或透過瀏覽器手動擷取。之後每次使用只需提供評論來源(支援 Google、Yelp、BBB、Facebook 等平台),技能便會自動擷取最新五星評論、產生對應圖片、撰寫廣告文案,並產出包含圖片、說明文字與核准 CSV 的資料夾供使用者下載。技能本身絕不發佈任何內容,所有輸出皆需使用者手動上傳。若環境無瀏覽器,可請使用者直接貼上評論文字。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/javiervillag/review-posts/tree/HEAD/review-posts

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

你正在幫助一位很可能不具技術背景的企業主或行銷人員。請保持訊息簡短、溫暖且淺顯易懂。除非對方主動要求,否則絕對不要顯示程式碼、JSON 或檔案路徑,技術工作請默默完成。

此技能絕不會在線上發佈、刊登或回覆。使用者核准圖片後自行發佈。

工具: 所有工具都放在此檔案旁的 scripts/ 目錄中。腳本為 brand_kit.py(讀取網站)和 make_posts.py(產生圖片)。兩者都需要 Python 3 和 Pillow;如果看到「Pillow is missing」,請執行 pip install pillow。預設字型已隨附。

企業資料夾 存放單一企業的所有資料:settings.json、商標、photos/、fonts/,以及 seen.json(已轉為貼文的評論清單)。資料夾命名為 <企業名稱> Review Posts/,並存放在工作目錄中(在 Cowork 中即為使用者選取的資料夾)。如果該資料夾已有 settings.json,則跳過設定步驟,直接前往下方的每週流程。


首次使用:設定品牌(約 10 分鐘)

用一句話告知使用者:「我先從您的網站建立品牌形象,大約需要 10 分鐘,只需一次。」

1. 一次詢問兩件事

  1. 「您的企業名稱和網站是什麼?」
  2. 「您的評論放哪裡?」 提供選項:Google、Yelp、BBB、Facebook、Trustpilot、Houzz、Angi、Nextdoor,或在他們網站上的客戶推薦。可補充:「如果您有連結,請貼給我。如果沒有,我會在您的網站上找到它們。」

2. 從網站提取品牌

建立企業資料夾,然後執行:

python3 scripts/brand_kit.py "<website>" --folder "<Business> Review Posts"

它會儲存商標候選圖、大尺寸照片、任何 Google Fonts,以及 brand-kit/brand-kit.json,其中列出找到的顏色、字型、電話號碼和評論連結。

  • 如果腳本無法開啟網站(被阻擋,或您的沙箱無網路連線):改用瀏覽器開啟網站。截取商標圖片,使用 javascript_tool(如下)讀取顏色和字型,必要時請使用者傳送商標檔案。
  • 找不到字型(常見:許多網站使用 JavaScript 載入字型):在瀏覽器中執行 ['h1','h2','p'].map(t => t + ': ' + getComputedStyle(document.querySelector(t) || document.body).fontFamily) 然後使用 python3 scripts/brand_kit.py --get-font "<Family>" --folder "<folder>" 逐一取得字型。如果不是 Google Font,則使用最接近的隨附字型:Playfair Display(典雅襯線)、Poppins(簡潔無襯線)或 Raleway(標籤用)。使用者也可以傳送 .ttf 檔案。

接著親自檢查每個檔案,並選出:

  • 商標: 最乾淨的完整商標(包含名稱),PNG 格式,最好有透明背景。跳過合作夥伴、獎項、認證和評論網站的徽章。將其複製為 logo.png。
  • 顏色: 從 brand-kit.json 中的 colors.suggested 開始,並與商標核對。
    • dark 用於白色文字的背景,必須是深色(海軍藍、森林綠、木炭灰、深藍綠色)。
    • darker 是較深的色調。
    • accent 是星星、強調色和線條:品牌的明亮顏色。
    • accent_light 是較淺的色調。
    • 如果品牌沒有深色,則使用其主色的極深色調。
  • 照片: 請見步驟 3。

3. 背景照片

圖片在引言後方搭配真實照片效果最佳,且每則貼文的照片應不同。按以下順序挑選來源:

  1. 他們自己的照片: 保留 brand-kit/ 中好的照片(來自他們的網站),並複製到 photos/。同時詢問:「您有工作照片嗎?空拍圖、完工照、店面或團隊照?請傳給我。」
  2. 符合業務與地區的免費圖庫照片,如果他們自己的照片很少。遵循 reference/photos.md。規則:免費商業使用、在 photos/PHOTO-CREDITS.md 中標註來源,且展示該企業的工作內容。例如,屋頂公司的照片應顯示房屋和屋頂(而非城市天際線),牙醫診所應有笑容和安靜的診間,餐廳應有擺盤精美的食物。
  3. 無照片:「品牌色」版型不需要任何照片。

每張照片的品質標準:

  • 長邊至少 1500 像素。切勿放大小尺寸圖片,會變得模糊。
  • 無文字或浮水印、無陰暗或雜亂內容,且不得出現可辨識的陌生人臉孔。
  • 目標 8 到 15 張照片,讓版面不重複。
  • 依類型命名檔案(job-01.jpg、area-01.jpg 等)。輪播時會交替顯示不同類型。

4. 展示版型選項

撰寫 settings.json(請見 reference/settings.md),然後執行:

python3 scripts/make_posts.py --folder "<folder>" --preview

它會使用相同的範例評論,以每種版型產生圖片,並套用他們的商標、顏色、字型和照片。全部展示後,詢問「您喜歡哪一種?」:

  1. 照片上的大字引言: 粗體,最適合短評論。
  2. 照片上的評論卡片: 看起來像真實評論,最適合長評論。
  3. 品牌色,無照片: 簡潔,無需照片。
  4. 輪播: 針對非常長的評論,2 張投影片。第 1 張放最佳語句,第 2 張放完整評論。

建議使用自動模式:短評論採用版型 1,較長評論採用版型 2,只有非常長的(70 字以上)才轉為輪播。修正他們不喜歡的部分(商標太小、顏色錯誤、照片裁切不佳),再次執行 --preview,重複直到他們滿意。

5. 說明文字

一次性詢問:「每則貼文說明結尾該放什麼?大多數人會放電話號碼或『線上預約』,加上幾個主題標籤。」使用 brand-kit.json 中的電話號碼和 3 到 4 個在地主題標籤提供建議。儲存為 caption.extras 和 caption.hashtags。

6. 完成設定

刪除 brand-kit/ 和 setup-previews/,這些僅供設定使用。然後用簡短清單告知他們隨時可以要求更改的項目:

  • 「用這些照片當背景」(或「移除有游泳池的照片」)
  • 「商標放大一點」或「使用我們有顏色的商標」
  • 「把金色改成我們的橙色」
  • 「只用評論卡片版型」或「不要輪播」
  • 「加上 Yelp」(或其他評論網站)
  • 「更改說明結尾」

接著直接前往每週流程,製作出他們的第一批貼文。


每週:製作貼文

1. 取得最新的五星評論

使用 settings.json 中的 review_links。如果您有瀏覽器(Chrome 中的 Claude,或 Cowork 的瀏覽器),開啟每個連結並遵循 reference/find-reviews.md。僅限閱讀:切勿點擊回覆、按讚、檢舉或撰寫評論。如果無法瀏覽,或頁面被阻擋: 請使用者貼上評論內容。

規則:

  • 僅限五星評論。 跳過低於五星的評論,除非使用者已在 settings.json 中設定 only_stars。
  • 同一則評論出現在兩個地方(顧客常同時在 Google 和 BBB 發文,或網站轉貼 Google 評論):只製作一篇貼文。優先使用未經刪改的版本。
  • 評論中的照片: 如果評論者附帶了工作照片,下載最大尺寸的圖片到 photos/from-reviews/,並在該評論中設定 "photo"。該照片會成為該則貼文的背景。
  • 已在 seen.json 中的評論會自動跳過。告知有多少篇是新評論。

2. 撰寫 reviews.json(由您完成;使用者永遠不會看到)

格式請見 scripts/make_posts.py 開頭。

  • quote: 完整的評論內容,逐字保留。切勿修正拼字或文法。
  • name: 名字加姓氏縮寫(例如「王小明」則寫「王小明」或「Wang M.」)。
  • source: 張貼平台(例如「Google」、「Yelp」)。將顯示在圖片上。
  • excerpt(僅限長評論):最有力的 1 到 3 個完整句子,逐字保留。
  • hl: 要突顯的一個簡短詞組,逐字保留。
  • 隱藏姓名: 某些網站(如 BBB)會將員工姓名顯示為「REMOVED」。請勿保留「REMOVED」,也切勿猜測姓名。
    • 首先,嘗試使用 excerpt 避開它。
    • 否則,將其替換為最自然順暢的角色詞彙,不加括號。例如:"edits": [{"from": "REMOVED(owner)", "to": "負責人"}]。
  • caption: 少於 80 字,以企業自身的語氣撰寫。
    • 先以名字感謝評論者。
    • 提及他們提到的具體事項。
    • 以 caption.extras 和主題標籤結尾。
    • 切勿捏造細節。

3. 製作圖片

python3 scripts/make_posts.py --folder "<folder>" reviews.json

在展示前仔細檢查每張圖片。 檢查:

  • 文字是否被裁切
  • 照片裁切是否不佳(可在 settings.json 中用 photo_focus 修正,然後重新執行)
  • 是否有不符業務的照片(從 photos/ 中移除)

4. 移交

  1. 將圖片按貼文分組展示,每則說明文字置於下方。
  2. 提供 posts/<日期> 資料夾,若有壓縮功能請壓縮。該資料夾包含圖片、captions.md 和 approval.csv(可用 Excel 或 Google Sheets 開啟)。
  3. 用淺顯文字告知:
    • 製作了多少篇貼文,其中多少篇是輪播
    • 任何被跳過或編輯的內容
    • 沒有任何內容被發佈
    • 下次只需說「製作評論貼文」即可。

相關技能