Communitygithub.com

品牌技能建構器

為任何公司從其品牌書建立品牌技能庫:語音技能、能產出符合品牌的檔案(PDF、Word、PowerPoint、社交圖片、HTML、動畫)的格式技能,以及能對資產進行品牌審查的審計技能。將品牌書轉換為結構化基礎(色板、字體、結構系統、無障礙性、語調),並以摘要驗證的上下文快照、預檢、平台測試和打包器來搭建每個技能,從需求收集到品質保證再到發布,最終一個壓縮檔即可在 Claude 和 ChatGPT 上運作。當有人要求「為我們的品牌建立品牌技能」、「將品牌指南轉換為技能」、「建立符合品牌的簡報或 PDF 技能」、「為品牌庫新增格式技能」或「檢視我們的品牌技能是否符合最佳實踐」時使用。注意:此技能本身不是品牌技能;它不製作任何品牌檔案,也不持有任何品牌的規則;它絕不會虛構來源未提供的品牌價值。

品牌技能建構器 是什麼?

Brand Skill Builder 是一個元技能,旨在協助開發者與 AI 代理從公司品牌指南(品牌書)建構一套完整的品牌技能庫。它將品牌書內容拆解為結構化的品牌基礎(如色板、字體、結構系統、無障礙性和語調),並自動產生三類技能:語音技能(規範品牌語調)、格式技能(產生符合品牌的 PDF、Word、簡報、社交圖片、HTML 或動畫檔案)、以及審計技能(檢查既有資產是否符合品牌規則)。此技能支援 Claude 與 ChatGPT 平台,其工作流程包含需求收集、建立快照、預檢、平台測試和打包發布,確保每個技能在任何環境中都能可靠運作。關鍵規則是絕不虛構品牌價值:所有顏色、字體、規則和決策都必須來自使用者提供的來源;空缺部分會記錄為待決項目,並由品牌擁有者決定。整個建構過程透過 `SKILL_DIR`(技能自身資料夾)和 `LIB`(使用者選擇的庫資料夾)來管理,並提供三種操作模式:建立全新庫(A)、為現有庫新增技能(B)、以及審查既有技能是否符合模式(C)。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/yuckier/brand-skill-builder/tree/HEAD/skills/brand-skill-builder

在你喜歡的 AI 中提問

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

說明文件

Brand Skill Builder

此技能協助您建構與維護品牌技能庫:一組小型技能,讓任何模型能為單一公司產出符合品牌的作品。它承載了來自實際生產庫的架構、範本、腳本和經驗教訓;但它本身不帶有任何品牌。每一個品牌價值都來自使用者的來源。

在開始任何模式之前,請先閱讀 references/architecture.md。當以下步驟提及時,再閱讀其他參考文件。

資料夾。 在每個指令中,SKILL_DIR 是存放此檔案的資料夾,而 LIB 是使用者選擇的庫資料夾。請在每個指令中完整寫出這兩者;不要將它們設定為 shell 變數(在某些平台上,一個指令中設定的變數在下一個指令中會消失)。

選擇模式

使用者需求模式
為一個尚無任何技能的品牌建立品牌技能A. 新庫
在現有庫中新增一個技能B. 新增技能
審查現有的品牌技能或庫C. 審查
在建構前先了解方法從 references/architecture.md 解釋後停止

僅在請求未明確說明時,才詢問要使用哪個模式。

A. 新庫

  1. 收集來源。 索取品牌書以及所有規範品牌的資料:設計團隊的範本、語音指南、訊息文件、商標規則、樣式指南、標誌檔案、字型及其授權、任何圖示或照片庫。詢問誰是品牌擁有者(將批准決策的人們)。記錄缺失的項目;不要自行填補。
  2. 搭建框架。 python3 SKILL_DIR/scripts/scaffold.py library LIB --brand "<品牌>" --era <紀元>。紀元是此品牌版本的簡短標籤(例如 2027-brand)。將來源放在 LIB/reference/ 中。
  3. 編寫基礎 在 LIB/shared-context/brand-foundations/context/ 中,依據 references/brand-foundations.md。從來源填寫每一個 TODO,或將其記錄為缺口。測量對比度;在包含規則的地方引用品牌書的措辭;為每個檔案提供來源出處。當來源有涵蓋時,將標誌圖稿放在 logo/ 下,並加入 logo-policy.md、imagery-policy.md 和 chart-palette.json。
  4. 與擁有者審查。 以簡短摘要展示基礎:色彩模型、字體角色、簽名元素、出貨檢查清單、缺口,以及每個提議的內部決策及其一項建議與理由。等待他們的決定;將每項決定記錄在內部決策表和開發日誌中。
  5. 建立語音技能(模式 B,使用 --kind voice)。該技能較小,可驗證快照、預檢和打包路徑。
  6. 建立第一個格式技能(模式 B,使用 --kind format),即人們最需要的格式。先走最小端到端路徑,然後進行試用循環。
  7. 一次新增一個格式,先確定每個格式的內部決策(references/process.md,「工作順序」)。
  8. 建立審計技能(模式 B,使用 --kind audit),待有格式規範可作為審計依據時再進行。

B. 新增技能

  1. 命名 <品牌>-<格式>(小寫,使用連字號),或 <品牌>-voice、<品牌>-audit。確認一個技能負責一個任務:如果請求與現有技能重疊,請說明並建議擴充該技能。
  2. 搭建框架。 python3 SKILL_DIR/scripts/scaffold.py skill LIB <名稱> --kind format|voice|audit --format "<PDF>"。這會寫入 SKILL.md 範本、agents/openai.yaml、預檢腳本、平台測試,以及快照設定檔 LIB/tools/snapshot/<名稱>.json;對於格式技能,還會產生 LIB/shared-context/<名稱>/context/format-spec.md 和 format-map.json。
  3. 在編寫程式碼之前先確定格式的內部決策:對於 structural-system.md 中範圍標示為「others decide when built」的每個決策,為此格式推薦一個答案,取得擁有者的決定,並記錄下來。
  4. 編寫格式規範與對應表(文字使用 BOOK、RATIFIED 和 PROPOSED 標籤;數字使用角色名稱,絕不使用十六進位代碼)。
  5. 編寫建構器和 QA 腳本,遵循 references/format-skills.md:模型規劃並撰寫 JSON 規範,腳本負責建構,腳本負責對完成的檔案進行閘控;權杖在建構時讀取;記錄偏差,絕不拒絕。語音和審計技能則遵循 references/voice-and-audit.md。
  6. 填寫 SKILL.md:描述(觸發條件、不會做的事項,少於 1,024 個字元)、步驟、需求收集及其對應規範的表格、規範參考、警告絕不拒絕的段落,以及每個平台一行傳送指示。
  7. 快照與驗證。 python3 LIB/tools/snapshot/snapshot.py LIB/tools/snapshot/<名稱>.json,然後 --check,接著 python3 LIB/skills/<名稱>/scripts/verify_context.py。將字型、樣式表和圖稿新增到設定檔中的 bundled_assets,讓預檢能驗證它們的存在。
  8. 測試(references/qa-and-testing.md):平台測試、在兩種主題上進行固件建構、每項 QA 檢查的篡改測試、權杖交換測試。然後使用一個逼真的提示詞進行試用循環,每次修復後重新執行同一個提示詞。
  9. 當被要求時打包(references/packaging.md): python3 LIB/tools/package/package_skill.py LIB/skills/<名稱> <名稱> <新的空白資料夾>/<名稱>.zip --date YYYY-MM-DD。解壓縮到另一個新的空白資料夾中,並從那裡執行測試,然後將壓縮檔放入 LIB/finalized-skills/。
  10. 記錄。 上述每個步驟都要立即記錄在 LIB/DEV-LOG.md 中。

C. 審查

閱讀該技能(或庫)並與模式進行比較。按以下順序報告,每項都附上檔案路徑和行號:

  1. 結構:一個任務,無執行時期呼叫其他技能,agents/openai.yaml,無單一平台路徑。
  2. 上下文:包含清單和摘要的捆綁快照,會發出警告而非停止的預檢,品牌紀元。
  3. 建構器:在建構時讀取權杖(或寫死的值),JSON 規範,偏差而非拒絕。
  4. QA:對應出貨檢查清單的完成檔案閘控,篡改測試,若會重新樣式化則需重新樣式模式。
  5. 工作流程:帶有預設值的需求收集,帶有主張和證據的規劃,建構前的批准,帶有警告的傳送。
  6. 打包:嚴格的 frontmatter,描述長度和觸發條件,發布記錄。

按影響程度推薦修復順序。除非被要求,否則不進行任何變更。

每個模式的規則

  • 絕不虛構品牌價值。 任何顏色、字型、尺寸、規則、主張、人物或客戶都不能來自一般知識。缺口需記錄並由擁有者決定,否則該元素就留空。
  • 品牌書是權威規則;擁有者的設計檔案填補其未明之處;每一次偏離都是一項內部決策,需記錄其範圍、偏離的品牌書原文、其狀態以及決策者。
  • 在您建立的技能內部:警告,絕不拒絕;修復並報告,傳送標記為失敗的檔案,僅在物理上不可能時才停止。沒有語音檔案的語音技能即為此種不可能情況。
  • 對每個屬於擁有者的選擇,先推薦,再詢問。 只有在他們決定後才進行建構。
  • 測量,不要猜測:對比度、文字寬度、行數、渲染效果。
  • 在真實渲染器中查看輸出,然後再宣布完成。

傳送

  • 在 Claude 上:摘要說明已建立或變更的內容(附上路徑),並從輸出資料夾分享任何已打包的壓縮檔。
  • 在 ChatGPT 上:摘要說明已建立或變更的內容(附上路徑),並連結任何已打包的壓縮檔以供下載。

然後列出仍待辦的事項、每個等待擁有者決定的缺口,以及每個 PROPOSED 狀態的決策。

參考資料

檔案閱讀目的
references/architecture.md技能類型、工作區、技能資料夾、快照優先的上下文、平台中立性
references/brand-foundations.md將品牌書轉換為資料:檔案、色彩與字型架構、內部決策、狀態標籤
references/format-skills.md格式技能內部的工作流程、警告絕不拒絕、規範、建構器、QA 閘控、各格式注意事項
references/voice-and-audit.md語音技能與審計技能
references/qa-and-testing.md測試、渲染、試用、互動規則的除錯
references/packaging.md嚴格的 frontmatter、描述、發布步驟、上傳失敗
references/process.md決策、動態記錄、工作順序、安全工作、Office 工具鏈經驗教訓

相關技能