Brand Skill Builder
此技能協助您建構與維護品牌技能庫:一組小型技能,讓任何模型能為單一公司產出符合品牌的作品。它承載了來自實際生產庫的架構、範本、腳本和經驗教訓;但它本身不帶有任何品牌。每一個品牌價值都來自使用者的來源。
在開始任何模式之前,請先閱讀 references/architecture.md。當以下步驟提及時,再閱讀其他參考文件。
資料夾。 在每個指令中,SKILL_DIR 是存放此檔案的資料夾,而 LIB 是使用者選擇的庫資料夾。請在每個指令中完整寫出這兩者;不要將它們設定為 shell 變數(在某些平台上,一個指令中設定的變數在下一個指令中會消失)。
選擇模式
| 使用者需求 | 模式 |
|---|---|
| 為一個尚無任何技能的品牌建立品牌技能 | A. 新庫 |
| 在現有庫中新增一個技能 | B. 新增技能 |
| 審查現有的品牌技能或庫 | C. 審查 |
| 在建構前先了解方法 | 從 references/architecture.md 解釋後停止 |
僅在請求未明確說明時,才詢問要使用哪個模式。
A. 新庫
- 收集來源。 索取品牌書以及所有規範品牌的資料:設計團隊的範本、語音指南、訊息文件、商標規則、樣式指南、標誌檔案、字型及其授權、任何圖示或照片庫。詢問誰是品牌擁有者(將批准決策的人們)。記錄缺失的項目;不要自行填補。
- 搭建框架。
python3 SKILL_DIR/scripts/scaffold.py library LIB --brand "<品牌>" --era <紀元>。紀元是此品牌版本的簡短標籤(例如2027-brand)。將來源放在LIB/reference/中。 - 編寫基礎 在
LIB/shared-context/brand-foundations/context/中,依據references/brand-foundations.md。從來源填寫每一個 TODO,或將其記錄為缺口。測量對比度;在包含規則的地方引用品牌書的措辭;為每個檔案提供來源出處。當來源有涵蓋時,將標誌圖稿放在logo/下,並加入logo-policy.md、imagery-policy.md和chart-palette.json。 - 與擁有者審查。 以簡短摘要展示基礎:色彩模型、字體角色、簽名元素、出貨檢查清單、缺口,以及每個提議的內部決策及其一項建議與理由。等待他們的決定;將每項決定記錄在內部決策表和開發日誌中。
- 建立語音技能(模式 B,使用
--kind voice)。該技能較小,可驗證快照、預檢和打包路徑。 - 建立第一個格式技能(模式 B,使用
--kind format),即人們最需要的格式。先走最小端到端路徑,然後進行試用循環。 - 一次新增一個格式,先確定每個格式的內部決策(
references/process.md,「工作順序」)。 - 建立審計技能(模式 B,使用
--kind audit),待有格式規範可作為審計依據時再進行。
B. 新增技能
- 命名
<品牌>-<格式>(小寫,使用連字號),或<品牌>-voice、<品牌>-audit。確認一個技能負責一個任務:如果請求與現有技能重疊,請說明並建議擴充該技能。 - 搭建框架。
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。 - 在編寫程式碼之前先確定格式的內部決策:對於
structural-system.md中範圍標示為「others decide when built」的每個決策,為此格式推薦一個答案,取得擁有者的決定,並記錄下來。 - 編寫格式規範與對應表(文字使用 BOOK、RATIFIED 和 PROPOSED 標籤;數字使用角色名稱,絕不使用十六進位代碼)。
- 編寫建構器和 QA 腳本,遵循
references/format-skills.md:模型規劃並撰寫 JSON 規範,腳本負責建構,腳本負責對完成的檔案進行閘控;權杖在建構時讀取;記錄偏差,絕不拒絕。語音和審計技能則遵循references/voice-and-audit.md。 - 填寫 SKILL.md:描述(觸發條件、不會做的事項,少於 1,024 個字元)、步驟、需求收集及其對應規範的表格、規範參考、警告絕不拒絕的段落,以及每個平台一行傳送指示。
- 快照與驗證。
python3 LIB/tools/snapshot/snapshot.py LIB/tools/snapshot/<名稱>.json,然後--check,接著python3 LIB/skills/<名稱>/scripts/verify_context.py。將字型、樣式表和圖稿新增到設定檔中的bundled_assets,讓預檢能驗證它們的存在。 - 測試(
references/qa-and-testing.md):平台測試、在兩種主題上進行固件建構、每項 QA 檢查的篡改測試、權杖交換測試。然後使用一個逼真的提示詞進行試用循環,每次修復後重新執行同一個提示詞。 - 當被要求時打包(
references/packaging.md):python3 LIB/tools/package/package_skill.py LIB/skills/<名稱> <名稱> <新的空白資料夾>/<名稱>.zip --date YYYY-MM-DD。解壓縮到另一個新的空白資料夾中,並從那裡執行測試,然後將壓縮檔放入LIB/finalized-skills/。 - 記錄。 上述每個步驟都要立即記錄在
LIB/DEV-LOG.md中。
C. 審查
閱讀該技能(或庫)並與模式進行比較。按以下順序報告,每項都附上檔案路徑和行號:
- 結構:一個任務,無執行時期呼叫其他技能,
agents/openai.yaml,無單一平台路徑。 - 上下文:包含清單和摘要的捆綁快照,會發出警告而非停止的預檢,品牌紀元。
- 建構器:在建構時讀取權杖(或寫死的值),JSON 規範,偏差而非拒絕。
- QA:對應出貨檢查清單的完成檔案閘控,篡改測試,若會重新樣式化則需重新樣式模式。
- 工作流程:帶有預設值的需求收集,帶有主張和證據的規劃,建構前的批准,帶有警告的傳送。
- 打包:嚴格的 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 工具鏈經驗教訓 |