Communitygithub.com

品牌指南建構工具

將現有品牌資產轉換為可重複使用的規則,區分記錄的事實與推斷的選擇,並根據品牌規格檢查提出的文件。

品牌指南建構工具 是什麼?

這個技能幫助開發者與AI代理將一組品牌資產文件夾轉換為結構化的品牌規則,讓代理在未經提示的情況下自動應用這些規則。它首先使用 `brand_audit.py` 對品牌資產進行審計,生成一個包含排序調色板、顏色角色、字體層級、標誌變體、圖像規則以及安全對比組合的 `brand-spec.json` 檔案。系統會清楚標記無法直接從已宣告值讀取的部分為「推斷」,並要求品牌擁有者透過十二個問題進行確認。最終,它產出可嵌入到其他技能中的規則區塊,並在交付前使用 `brand_check.py` 對任何文件進行品牌合規性檢查,確保品牌規則的完整性和一致性。此工具支援 Claude Code、Cursor、Codex 等平台,適合任何需要品牌治理的自動化工作流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byoverseas/knacco-free-skills/tree/HEAD/skills/kit-brand-guide-builder

在你喜歡的 AI 中提問

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

說明文件

品牌指南建構工具 是做什麼的?

一堆品牌資產的資料夾並不是一項品牌技能。一項品牌技能是一套書面規則,代理無需提問就能自動套用,而且只能從品牌實際行為的審計中建構出來。

狀態:v1.0 | 類別:技能 | 價格:免費

在執行審計之前,請先閱讀產品指南。從此產品資料夾中執行隨附的工具。將您的品牌檔案保留在自己的工作區中。

此技能的功能

  1. 接收一個品牌資產資料夾:樣式表、主題檔案、標誌檔案、圖像、備註。
  2. 在該資料夾上執行 tools/brand_audit.py,並寫入 brand-spec.json,其中包含排序調色板、命名顏色角色、字體層級、標誌變體和留白空間、圖像規則、安全對比組合以及反模式。
  3. 將無法從宣告中讀取的每個值標記為 "source": "inferred",並將其路徑列在 unconfirmed 中。
  4. 向品牌擁有者提出十二個問題,並記錄針對這些路徑的回答。
  5. 將 references/skill-rules.md 中的規則區塊交給您,讓您貼入建構的技能中,並在交付前使用 tools/brand_check.py 檢查每個輸出。

路徑

  • 審計一個資料夾 → python3 tools/brand_audit.py <folder> --out brand-spec.json --json,然後在信任任何值之前,閱讀 GUIDE.md 的第 4 節。
  • 詢問擁有者 → references/owner-questions.md。全部十二個問題都要問,即使審計只提出一個問題。
  • 建構技能 → references/skill-rules.md。將區塊貼入技能中,填入已確認的值,保留拒絕規則。
  • 檢查一個輸出 → python3 tools/brand_check.py brand-spec.json output-description.json。十二條規則,一個分數,失敗時 exit 2。
  • 檢查文字 → 將檢查器指向一個文字檔案。它會檢查調色板、字體大小和品牌名稱,並跳過文字無法承載的規則。

不可協商的規則

  • 審計優先於技能。 未經審計就從資料夾寫出的技能,只是一套帶有品牌詞彙的猜測。
  • 每個推斷的值都需經過擁有者確認。 基於未經確認的推斷而建立的規則,比沒有規則更糟。
  • 規格是顏色、字體和標誌的唯一來源。 建構的技能不攜帶自己的調色板副本。
  • 技能套用品牌。 它不會重新設計、改進或現代化品牌。
  • 從不重新繪製、重新拉伸或根據描述重建任何標誌。 檔案會按原樣使用,否則輸出就不含標誌。
  • 檢查器在交付前執行。 由擁有者發現的品牌違規,與由檢查器發現的品牌違規是不同層級的問題。

檔案

檔案用途
GUIDE.md完整方法:收集、審計、建構,以及為何順序不可逆轉
references/audit-fields.md品牌規格中的每個欄位:類型、如何推導、讀取或推斷
references/skill-rules.md可供貼入您建構的技能中的規則區塊
references/owner-questions.md十二個問題,以及跳過其中一個會出什麼問題
tools/brand_audit.py遍歷資料夾並寫入 brand-spec.json
tools/brand_check.py針對一個提議的輸出執行十二條規則,滿分100分

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能