公司品牌 / Marca da Empresa

Marca da Empresa 是做什麼的？

您是品牌守門員：每一份交付物都帶著公司的外觀與語調離開，而不是 Claude 的——且不延誤主要請求。

語言

• 以使用者書寫的語言與其交談。
• 以使用者的語言（language / idioma 在公司設定檔中，或對話語言）撰寫品牌手冊。使用 assets/marca.template.md 中的英文或葡萄牙文範本。
• 許多美國小型企業服務英文及葡萄牙文（或西班牙文）使用者。手冊定義品牌在企業與客戶互動時所使用的每種語言中的樣貌，而非逐字翻譯。

1. 屬於哪種情況？

透過 CLAUDE.md 中的資料夾對照 / Mapa de pastas 尋找品牌檔案；否則尋找 00-company/brand.md + brand.json 或 00-empresa/marca.md + marca.json。

• 手冊已存在：讀取並套用（第 4 節）。不要重新進行訪談。
• 無手冊且使用者要求品牌/手冊（視覺識別、顏色、標誌、語調）：建立手冊（第 2 節及第 3 節）。如果沒有公司資料夾，詢問儲存位置，或建議先執行 onboarding-empresa 技能。
• 無手冊且請求是文件、提案、貼文等：不要進行訪談。以中性、穩重的樣式交付（文字 #1F2937 配白色背景，標題使用 #1E3A5F，系統字型如 Arial/Calibri，不使用刺眼顏色；僅在使用者提供時才使用標誌），並在結尾附上一行：「若您需要，我可以建立您的品牌手冊，讓未來交付物都能使用您的顏色與語調。」 / 「Se quiser, crio o manual da marca para as próximas entregas saírem com as suas cores e o seu tom.」

2. 建立：簡短訪談

最多在兩則訊息內詢問：

1. 提供標誌（PNG/JPG/SVG）或 Instagram/網站截圖。是否有現有品牌指南或 HEX 色碼？有哪些標誌版本（橫式、圖示、深色背景）？
2. 三個形容品牌的詞語（例如：溫暖、手工、可靠）。
3. 您與誰交談，使用哪些語言（英文、葡萄牙文、西班牙文）？正式程度：名字、「您」vs.「先生/女士」、「você」vs.「o senhor/a senhora」？表情符號？俚語？行話？
4. 企業經常使用（標語、產品名稱）與絕不使用的詞語與片語——每種語言分開列出。
5. 您視覺上欣賞的品牌（僅供參考，非抄襲）。
6. 目前使用的字型（若已知）。

使用標誌/截圖：檢視圖片，從主要顏色中建議調色盤（提供近似 HEX 色碼並標明為近似值；使用者若有設計師則由其確認）。

3. 建立手冊

在儲存前提出並獲得同意：

• 調色盤：主要色、次要色、強調色（按鈕/CTA/價格）、深色中性色（文字）、淺色中性色（背景）。
• 對比度（WCAG 2.x）：針對實際使用的每一組配對計算——文字/背景、標題（主要色）在背景上、強調色（價格、行動呼籲）在背景上、白色文字在主要色與強調色上（頁首、按鈕）。公式：每種顏色的相對亮度 L（線性化 sRGB 頻道，L = 0.2126R + 0.7152G + 0.0722B）；對比度 = (L1 + 0.05) / (L2 + 0.05)，L1 為較亮者。一般文字最低 4.5:1，大字型（≥ 18 pt，或 ≥ 14 pt 粗體）最低 3:1。使用簡短 Python 腳本計算，而非估算。
• 若品牌顏色失敗：建立一個通過檢驗的深色變體（「主要色用於文字」），僅對背景、色塊與細節使用原色。若白色在其上失敗，則在該頁首上使用深色文字。顯示配對表並附上結果。
• 無障礙（網站）：美國企業的網站越來越常成為 ADA 訴訟目標；WCAG 2.1/2.2 AA 是常見基準。除色彩對比外：圖片替代文字、不單以顏色傳達意義、可讀字型大小、連結/按鈕的可見焦點。提及此點；不承諾法律合規。
• 字型：從 Google Fonts 選用一種標題字型與一種內文字型（在 SIL 開放字型授權或 Apache 下免費——可用於商業用途，包括標誌與印刷；在字型頁面上檢查授權）。對於 Word/PowerPoint，提供電腦內建的備用字型（例如 Montserrat → Arial；Lora → Georgia）。商業字型需要授權。
• 標誌：可用的版本、淺色/深色背景、保留空間、何處不使用。
• 語調，每種語言：3 項原則，每項附英文及葡萄牙文（若兩種語言皆使用）的「要做/不要做」範例。說明稱呼方式的差異（英文用名字與「you」；葡萄牙文「você」vs.「o senhor/a senhora」），以及是否混合語言（例如保留產品名稱英文，絕不在同一句中混合）。
• 詞彙，每種語言：品牌用詞、禁用詞、如何書寫企業名稱（是否包含「LLC」/「Inc.」）。
• 應用：文件、簡報、試算表、貼文、電子郵件及文字/WhatsApp 的快速規則。

使用 assets/marca.template.md 中的範本（英文或葡萄牙文段落）儲存至資料夾對照中的品牌路徑——00-company/brand.md（英文資料夾）或 00-empresa/marca.md（葡萄牙文資料夾）——並將權杖儲存至同一資料夾的 brand.json / marca.json，務必使用英文鍵名：

{"name": "…", "language": "en|pt", "customer_languages": ["en", "pt"],
 "colors": {"primary": "#…", "primary_text": "#…", "secondary": "#…", "accent": "#…", "text": "#…", "background": "#…", "header_text": "#FFFFFF|#…"},
 "fonts": {"headings": "…", "body": "…", "office_headings": "…", "office_body": "…"},
 "logo": "<brand folder>/logo.<png|jpg|svg>", "three_words": ["…", "…", "…"],
 "voice": {"en": {"principles": ["…"], "use": ["…"], "avoid": ["…"]}, "pt": {"principles": ["…"], "use": ["…"], "avoid": ["…"]}},
 "business_name_spelling": "…"}

• logo：使用者傳送的檔案的實際副檔名，位於品牌資料夾內。若主要色通過對比度，primary_text 重複該值。若使用者同意，將標誌複製到資料夾中。若不使用該語言，則省略 voice.pt 或 voice.en。
• 向後相容：若找到舊版 marca.json（含葡萄牙文鍵名），使用此對應讀取，並在儲存時寫入英文鍵名（在覆寫前詢問）：nome→name、cores→colors（primaria→primary、primaria_texto→primary_text、secundaria→secondary、destaque→accent、texto→text、fundo→background）、fontes→fonts（titulos→headings、texto→body、alternativa_office_titulos→office_headings、alternativa_office_texto→office_body）、tres_palavras→three_words、principios_tom→voice.<language>.principles。

提供給員工與廠商的一頁品牌簡報：一個自包含的 HTML 檔案（內嵌 CSS，brand.json 權杖作為 CSS 變數 --color-primary、--color-text 等，顏色色票附 HEX、字型、標誌及語調規則），儲存在手冊旁邊，命名為 brand-sheet.html（或在葡萄牙文資料夾中命名為 manual-da-marca.html）；若要 PDF，若技能「pdf」可用則使用該技能（或在瀏覽器中將 HTML 列印為 PDF）。

4. 套用（每份公司交付物）

• 文件（docx/pdf）：標題使用手冊中指定的字型與「主要色用於文字」顏色，內文使用深色中性色，頁首放置標誌，僅在行動呼籲與價格上使用強調色（且僅在通過對比度時）。
• 簡報（pptx）：封面使用主要色背景或圖片 + 標誌；內頁淺色；每張投影片最多使用 3 種顏色。
• 試算表（xlsx）：表頭使用主要色，並使用手冊中指定的表頭文字顏色（白色或深色），加總以粗體呈現，無隨機顏色。
• 貼文與圖像：使用手冊中的調色盤與字型；小且一致的標誌。
• 網頁與 HTML 電子郵件：brand.json 權杖作為 CSS 變數；維持對比度與替代文字。
• 文字（提案、貼文、訊息、WhatsApp）：遵循交付物語言的語調與詞彙。交付前檢查：是否有禁用詞？該語言是否聽起來像品牌風格？
• 若使用者要求手冊中未涵蓋的內容，請執行，但詢問這是例外情況還是需要更新手冊。

5. 注意事項

• 請勿複製其他公司的標誌、名稱或識別。參考僅供啟發；切勿重製他人品牌。
• 請勿聲稱名稱已受保護。向州政府註冊 LLC 或 DBA/虛構名稱並不給予商標權。在投入新名稱之前，建議搜尋 USPTO 資料庫（uspto.gov 的商標搜尋）、州的商標與企業名稱紀錄、網域與社群帳號，並諮詢商標律師以進行聯邦註冊。
• 字型：偏好 Google Fonts（開放授權）。商業字型需要涵蓋使用範圍（網頁、印刷、標誌）的授權。
• 圖片：使用企業擁有的照片或已授權的圖庫；不從 Google 拉取圖片。