奇链 奇链
← 教程库
入门 约 20 分钟 2026-10-20 02:32:22 · 6 阅读

brand-guidelines 技能实操：给 AI 一份能执行的品牌配色规格

技能解决的是哪件事

同一份演示文稿大纲，人自己挑配色要来回试错，交给 AI 生成又常常花花绿绿各说各话。brand-guidelines 是 Anthropic 官方 skills 仓库里的一个技能，做法很直接：把 Anthropic 品牌的 7 个色值、2 款字体和几条使用规则写成一份 2.2KB 的规格文件，AI 加载之后产出的文档就统一套用这套视觉。技能本身属于 anthropics/skills 仓库（GitHub 上 181k+ stars），定位是官方示例——教你怎么把「公司设计规范」变成 AI 能直接执行的指令。

这篇文章把这份规格逐条拆开讲清楚，然后用 python-pptx 按规格实际写入一个演示文稿、再程序化读回验证。所有代码和读回结果都贴在文中，色值与原文逐字来自官方 SKILL.md，可以照抄复现。本篇属于 dbyun 的 AI 编程与 Agent 技能教程线，总站纲见 AI 教程总纲。

先装上：三条安装路径

官方 README 给了三条使用路径，按你常用的环境挑一条：

Claude Code：先把仓库注册为插件市场，再装技能包：

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

装完直接在对话里点名使用，README 的原话是 "you can use the skill by just mentioning it"。

Claude.ai：仓库里这批示例技能对付费计划已经全部内置，不用手动安装；要用仓库里的技能或自传技能，按官方支持文档「Using skills in Claude」操作即可。

Claude API：官方预置技能和自传技能都走 Skills API，入口在文档的 Skills Guide 一节。

brand-guidelines 属于 example-skills 技能包。它和 docx/pptx 那组文档技能不一样：后者是 source-available（源码可见但非开源），本技能所在的大部分示例技能是 Apache 2.0 开源，可以自由改造。

7 个色值，各管什么

SKILL.md 的 Brand Guidelines 一节给出了全部色值，一共 4 个主色加 3 个强调色：

brand-guidelines 官方 7 色色彩系统图

brand-guidelines 技能规定的 7 个官方色值与用途分工（数据逐字引自 SKILL.md）

主色原文是这么写的：

- Dark: #141413 - Primary text and dark backgrounds
- Light: #faf9f5 - Light backgrounds and text on dark
- Mid Gray: #b0aea5 - Secondary elements
- Light Gray: #e8e6dc - Subtle backgrounds

强调色三个：Orange #d97757（Primary accent）、Blue #6a9bcc（Secondary accent）、Green #788c5d（Tertiary accent）。分工在 Features 一节写死：强调色只上「非文本形状」，也就是色块、图形这类元素，并且按橙→蓝→绿的顺序轮换，原文是 "Cycles through orange, blue, and green accents"。文字颜色则根据背景明暗在 #141413 和 #faf9f5 之间自动选择，保证对比度。

字体的两条规则和一个回退

字体规则只有两条：标题（24pt 及以上）用 Poppins，正文用 Lora。规则看似简单，但 SKILL.md 在 Typography 和 Font Management 两节反复交代了一件事：这两款字体最好预先装在运行环境里，装不上也有兜底——标题回退 Arial，正文回退 Georgia，"No font installation required - works with existing system fonts"。也就是说技能不负责装字体，只负责声明字体名；缺字体时由打开文件的程序做近似替换。

brand-guidelines 字体与配色应用规则图

字体、形状配色、文字颜色的完整判定路径，右侧括号为官方规定的回退方案

技术实现上，SKILL.md 写明颜色经 python-pptx 的 RGBColor 类以 RGB 精确写入（"Uses RGB color values for precise brand matching"），这句话正好给了我们实测的抓手。

实测：按规格写入，再读回验证

下面这段代码在干净的 Python 3.11 环境跑通，依赖只有 python-pptx 1.0.2（uv venv && uv pip install python-pptx 即装）。逻辑是按官方规则造一页：浅色打底、40pt 标题、18pt 正文、三个色块按橙蓝绿轮换：

from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.dml.color import RGBColor

DARK   = RGBColor(0x14,0x14,0x13)  # 主深色
LIGHT  = RGBColor(0xfa,0xf9,0xf5)  # 主浅色
ORANGE = RGBColor(0xd9,0x77,0x57)  # 强调色 1
BLUE   = RGBColor(0x6a,0x9b,0xcc)  # 强调色 2
GREEN  = RGBColor(0x78,0x8c,0x5d)  # 强调色 3

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])  # 空白版式

bg = slide.shapes.add_shape(1, Inches(0), Inches(0),
                            Inches(13.333), Inches(7.5))
bg.fill.solid(); bg.fill.fore_color.rgb = LIGHT

title = slide.shapes.add_textbox(Inches(0.8), Inches(0.6),
                                 Inches(11), Inches(1.4))
r = title.text_frame.paragraphs[0].add_run()
r.text = "Sonic Playground"
r.font.size = Pt(40)        # ≥24pt → Poppins 规则
r.font.name = "Poppins"
r.font.color.rgb = DARK

for i, c in enumerate([ORANGE, BLUE, GREEN]):   # 橙→蓝→绿轮换
    sq = slide.shapes.add_shape(5, Inches(0.8 + i*1.1),
             Inches(4.2), Inches(0.7), Inches(0.7))
    sq.fill.solid(); sq.fill.fore_color.rgb = c

prs.save("demo_brand.pptx")

写完不能只看文件生成了就算数，再开一次文件把每个形状的真实属性读回来：

prs2 = Presentation("demo_brand.pptx")
for sh in prs2.slides[0].shapes:
    if sh.has_text_frame and sh.text_frame.text.strip():
        run = sh.text_frame.paragraphs[0].runs[0]
        print(sh.name, run.font.name, run.font.size.pt, run.font.color.rgb)
    else:
        print(sh.name, sh.fill.fore_color.rgb)

读回结果汇总成一张表：

python-pptx 实测读回表

demo_brand.pptx 全部 6 个形状的读回属性：标题 Poppins 40pt、正文 Lora 18pt、三个色块 D97757/6A9BCC/788C5D 依序轮换

标题命中 Poppins 规则（40pt ≥ 24pt 分界），三个色块严格按橙蓝绿出现，色值与 SKILL.md 逐字节一致。整份文件 28,674 字节，六个形状就是这页的全部内容。

两个要知道的边界

第一个边界是字体。实测机器 fc-list 列出 46 个字体族，Poppins 和 Lora 都不在其中。这种情况下 python-pptx 依然会把字体名如实写进 XML（读回值就是证明），但文件在没有这两款字体的机器上打开时，放映程序会自行替换近似字体——这正是官方规定回退 Arial / Georgia 的原因。想要像素级一致，得先把两款字体装进环境，SKILL.md 原文也写着 "Fonts should be pre-installed in your environment for best results"。

第二个边界是技能的作用范围。整个 SKILL.md 只有 2,235 字符，内容就是色板加字体规则，没有版式、没有图表规范、也没有图片处理。对比同仓库的 canvas-design（11,939 字符的设计哲学指令），它是纯粹的「规格型」技能。如果你的需求是让 AI 做整套品牌物料设计，这个技能只解决颜色和字体两件事，别指望更多。另外 README 的 Disclaimer 说得明白：这些技能用于演示与教学，"the implementations and behaviors you receive from Claude may differ from what is shown in these skills"，正式项目使用前要先在自己环境里充分测试。

来源与延伸

本文色值、字体规则、安装命令均引自 anthropics/skills 仓库的 brand-guidelines/SKILL.md 与仓库 README（经 GitHub API 抓取原文），实测代码与读回结果来自本机 python-pptx 1.0.2 实际运行。同仓库的 canvas-design 技能教程见站内姊妹篇。

评论 (0)