你正在幫助一位很可能不具技術背景的企業主或行銷人員。請保持訊息簡短、溫暖且淺顯易懂。除非對方主動要求,否則絕對不要顯示程式碼、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. 一次詢問兩件事
- 「您的企業名稱和網站是什麼?」
- 「您的評論放哪裡?」 提供選項: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. 背景照片
圖片在引言後方搭配真實照片效果最佳,且每則貼文的照片應不同。按以下順序挑選來源:
- 他們自己的照片: 保留
brand-kit/中好的照片(來自他們的網站),並複製到photos/。同時詢問:「您有工作照片嗎?空拍圖、完工照、店面或團隊照?請傳給我。」 - 符合業務與地區的免費圖庫照片,如果他們自己的照片很少。遵循
reference/photos.md。規則:免費商業使用、在photos/PHOTO-CREDITS.md中標註來源,且展示該企業的工作內容。例如,屋頂公司的照片應顯示房屋和屋頂(而非城市天際線),牙醫診所應有笑容和安靜的診間,餐廳應有擺盤精美的食物。 - 無照片:「品牌色」版型不需要任何照片。
每張照片的品質標準:
- 長邊至少 1500 像素。切勿放大小尺寸圖片,會變得模糊。
- 無文字或浮水印、無陰暗或雜亂內容,且不得出現可辨識的陌生人臉孔。
- 目標 8 到 15 張照片,讓版面不重複。
- 依類型命名檔案(
job-01.jpg、area-01.jpg等)。輪播時會交替顯示不同類型。
4. 展示版型選項
撰寫 settings.json(請見 reference/settings.md),然後執行:
python3 scripts/make_posts.py --folder "<folder>" --preview
它會使用相同的範例評論,以每種版型產生圖片,並套用他們的商標、顏色、字型和照片。全部展示後,詢問「您喜歡哪一種?」:
- 照片上的大字引言: 粗體,最適合短評論。
- 照片上的評論卡片: 看起來像真實評論,最適合長評論。
- 品牌色,無照片: 簡潔,無需照片。
- 輪播: 針對非常長的評論,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. 移交
- 將圖片按貼文分組展示,每則說明文字置於下方。
- 提供
posts/<日期>資料夾,若有壓縮功能請壓縮。該資料夾包含圖片、captions.md和approval.csv(可用 Excel 或 Google Sheets 開啟)。 - 用淺顯文字告知:
- 製作了多少篇貼文,其中多少篇是輪播
- 任何被跳過或編輯的內容
- 沒有任何內容被發佈
- 下次只需說「製作評論貼文」即可。