Brand
AI Playbook 的品牌核心是「可被信任的 AI 協作規範」。它不是行銷品牌,而是一套讓人類與 AI Agent 在同一個脈絡下工作的操作系統。
品牌要傳達三件事:
- 清楚:任何規則都要能被快速理解。
- 可執行:文件要能直接轉成下一步行動。
- 可追溯:決策、限制與範例要能被回頭檢查。
Human、Coding Agent、Design Agent 與 Content Agent 會用不同方式讀取同一份文件。如果品牌語氣不一致,Agent 會開始自行推測規則,產出也會逐漸偏離專案標準。
Brand 文件的目的不是美化語言,而是降低誤解與重工。
AI Playbook 的語氣應該像一位清楚、務實、有經驗的 Technical Lead:
- 直接說明決策。
- 說清楚原因與取捨。
- 避免空泛形容詞。
- 避免過度鼓勵或行銷式語氣。
- 優先提供可驗證的標準。
推薦語氣:
第一版採用 Astro + Starlight,因為它符合文件優先、Markdown/MDX、靜態部署與低維護成本。避免語氣:
我們將打造一個非常強大、突破性、前所未有的 AI 知識平台。Identity
Section titled “Identity”AI Playbook 的識別應該低調、穩定、工具感明確。
- 主要識別:文字型品牌
AI Playbook。 - 視覺方向:文件系統、規範、索引、協作流程。
- 不需要吉祥物、炫技插畫或過度裝飾。
- 首頁第一屏應該讓讀者立刻知道這是 AI 協作規範入口。
- 享哥個人品牌是方法論來源,不是把 AI Playbook 變成個人履歷頁。
- 完整 CIS、Logo、色票、字體與圖像規則應以
design/brand-identity-system.md為準。 - 享哥個人品牌 Logo 的設計規格應以
brand/xiang-logo-design-brief.md為準。
第一版已建立可執行的品牌色票,並以 IDEA 橘、深色科技底、淺色文件底、成功綠、資訊藍與警示橘作為核心方向。
色彩原則:
- 背景保持乾淨,不使用重度漸層。
- 文字對比優先於品牌風格。
- 強調色只用於導覽、連結、狀態與必要 CTA。
- 深色模式必須維持同等可讀性。
- 詳細 token 與跨載體用法請參考品牌識別系統。
Typography
Section titled “Typography”字體策略以可讀性與跨平台穩定為優先。
- 文件標題要清楚區分層級。
- 內文行距要適合長篇閱讀。
- 程式碼、路徑、命令與檔名一律使用 monospace。
- 不使用過大的 hero-scale 字級,除非該頁真的是首頁入口。
- 使用清楚、直接、可操作的語氣。
- 優先提供規範、範例與檢查清單。
- 保持資訊密度與可掃讀性。
- 說明決策背後的取捨。
- 使用一致的章節格式。
- 讓範例可直接複製或改寫。
- 不要寫成行銷文案。
- 不要使用誇飾語氣。
- 不要建立與文件目的無關的裝飾性內容。
- 不要用隱喻取代明確規則。
- 不要把未決定事項寫成既定事實。
- 不要為了品牌感犧牲可讀性。
Checklist
Section titled “Checklist”- 定義品牌定位
- 定義語氣
- 定義識別方向
- 定義色彩原則
- 定義字體原則
- 建立享哥個人品牌定位
- 建立品牌識別系統
- 建立享哥 Logo 設計簡報
- 拆分 voice.md
- 拆分 identity.md
- 拆分 color.md
- 拆分 typography.md
Prompt Example
Section titled “Prompt Example”請依 AI Playbook 的品牌語氣,將下列內容改寫成清楚、可操作、適合 Agent 閱讀的文件。
要求:- 保留決策與限制- 補上 Why / Do / Don't / Checklist- 避免行銷語氣與誇飾形容