尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

claude-cookbooks 自定义 Skill 实战:用 applying-brand-guidelines 让 Claude 输出自动遵守企业品牌规范

claude-cookbooks 自定义 Skill 实战:用 applying-brand-guidelines 让 Claude 输出自动遵守企业品牌规范 claude-cookbooks 自定义 Skill 实战用 applying-brand-guidelines 让 Claude 输出自动遵守企业品牌规范【免费下载链接】claude-cookbooksA collection of notebooks/recipes showcasing some fun and effective ways of using Claude.项目地址: https://gitcode.com/GitHub_Trending/an/claude-cookbooks本篇技术指南以 claude-cookbooks 仓库中 skills/custom_skills/applying-brand-guidelines/SKILL.md 为核心完整解读这个名为applying-brand-guidelines的自定义 Skill它把一套企业级品牌规范颜色、字体、版式、措辞结构化打包让 Claude 在生成 Excel、PowerPoint、PDF 等文档时自动套用统一视觉与语气标准。读完本文你将掌握该 Skill 的全部规范条目品牌色板、字体层级、Logo 用法、三类文档模板、文案指南、质检红线、配套脚本 apply_brand.py 与 validate_brand.py 的源码级实现原理并学会把它改造成属于自己组织的品牌 Skill。Skill 定位一份可执行的品牌规范在 Agent Skills 的体系里自定义 Skill 是以SKILL.md为核心的专业知识包。applying-brand-guidelines的 YAML frontmatter 定义了它的触发方式--- name: applying-brand-guidelines description: This skill applies consistent corporate branding and styling to all generated documents including colors, fonts, layouts, and messaging ---name技能的唯一标识目录名与之一致descriptionClaude 判断何时需要加载该技能的依据——只要任务涉及文档生成、且要求统一企业视觉风格与措辞这条描述就会命中。整套文件位于仓库skills/custom_skills/applying-brand-guidelines/目录下文件作用SKILL.md主规范文件Claude 读取的核心指令REFERENCE.md速查卡颜色代码表、模板样例、可访问性标准、命名规范apply_brand.py将品牌格式自动应用到文档配置validate_brand.py对内容做品牌合规性校验并打分这与 skills/CLAUDE.md 描述的自定义 Skill 推荐结构一致SKILL.md存放指令、可选脚本负责执行。仓库中 analyzing-financial-statements 等兄弟 Skill 也遵循同样模式。Brand Identity示例公司 Acme Corporation文档以虚构公司Acme Corporation为示范载体方便你照葫芦画瓢替换为自己的组织信息SloganTaglineInnovation Through Excellence行业IndustryTechnology Solutions这提示了一个关键设计思路品牌 Skill 应先固化我是谁、说什么话再延伸到长什么样。替换公司名、口号和行业即可完成主体定制。视觉标准从色板到字体的逐级约束颜色色板Color Palette主色与辅色全部以 Hex RGB 双重定义确保数字与印刷两种场景都可用层级颜色HexRGB用途主色Acme Blue#0066CC0, 102, 204标题、主按钮主色Acme Navy#0033660, 51, 102正文、点缀色主色White#FFFFFF255, 255, 255背景、反白文字辅色Success Green#28A74540, 167, 69正向指标辅色Warning Amber#FFC107255, 193, 7警示辅色Error Red#DC3545220, 53, 69负向数值辅色Neutral Gray#6C757D108, 117, 125次级文字在 apply_brand.py 中这些颜色被固化进BrandFormatter.COLORS字典并用primary/secondary两级分组——任何格式化方法都从这一单一事实源取值避免规范在代码里手抄走样。这也是规范写一次、处处引用的实现最佳实践。字体体系Typography主字体族Primary Font FamilySegoe UI, system-ui, -apple-system, sans-serif带系统回退栈跨平台稳定字号层级Font Hierarchy元素字号字重颜色H132ptBoldAcme BlueH224ptSemiboldAcme NavyH318ptSemiboldAcme NavyBody11ptRegularAcme NavyCaption9ptRegularNeutral Gray对应源码见 apply_brand.py 中的FONTS字典字号映射为{h1: 32, h2: 24, h3: 18, body: 11, caption: 9}字重使用标准数值regular400 / semibold600 / bold700。Logo 使用规则位置首页/首张幻灯片左上角尺寸宽度 120px保持宽高比留白四周至少 20px padding禁令不得拉伸、旋转或添加特效。三类文档规范与代码落点SKILL.md 对 PowerPoint、Excel、PDF 分别给出版面级要求而apply_brand.py的BrandFormatter类为每一种文档类型提供了与之完全对齐的格式化方法。PowerPoint 演示文稿幻灯片模板Slide Templates分四种Title SlideLogo 标题 日期 演讲人、Section Divider蓝色背景章节页、Content Slide蓝色标题栏 白色内容区、Data Slide图表沿用色板。布局规则Layout Rules四边边距 0.5 英寸标题位于幻灯片顶部 15% 区域项目符号每级缩进 0.25 英寸每页最多 6 条要点图表只用品牌色。源码落点在 format_powerpointmaster配置中title_area坐标为{x: 0.5, y: 0.15, ...}与顶部 15%规则对应标题栏title_bar使用 Acme Blue 底 白字bullet_style三级符号为• / ○ / ▪、缩进 0.25。Excel 电子表格格式标准Formatting Standards表头第 1 行、加粗、白字 Acme Blue 背景子表头加粗 Acme Navy 文字数据单元格常规 Acme Navy 文字边框细线 Neutral Gray隔行变色浅灰 #F8F9FA 提升可读性。图表默认值Chart Defaults主序列 Acme Blue、次序列 Success Green、网格线 Neutral Gray 0.5pt、禁用 3D 与渐变。源码 format_excel 逐项还原header_style为蓝底白字加粗、cell_style为 Acme Navy 左对齐、alternating_rows开启并使用 light_gray、chart_colors顺序为蓝→绿→琥珀→灰。此外类中还封装了 get_chart_palette可按数据系列数量默认 4取色超出主辅色时自动追加 Navy 与 Error Red。PDF 文档页面布局Page Layout页眉左 Logo、中文档标题、右页码页脚左版权声明、中日期的格式为Month DD, YYYY、右密级分类边距四周 1 英寸行距 1.15段后距 12pt。章节格式Section Formatting主标题 Acme Blue 16pt 加粗、副标题 Acme Navy 14pt semibold、正文 Acme Navy 11pt。源码 format_pdf 展示了最完整的实现页眉由logo / title / page_number三区拼合页码格式Page {page} of {total}页脚左版权右 Confidentialstyles字典为 H1/H2/H3/body/caption 各定义了字体、字号、颜色与间距页脚还支持通过 apply_watermark 生成 DRAFT / CONFIDENTIAL / SAMPLE 三类水印统一 45° 斜置、低透明度。统一入口模块级函数 apply_brand_to_document 接受excel/powerpoint(或pptx) /pdf三种文档类型字符串与配置字典分发到对应格式化方法传入未知类型会抛出ValueError属于可预期的防护性设计。内容指南语气、标准句式与数据呈现语气Tone of VoiceProfessional正式但不疏远Clear避免行话用平实语言Active多用主动语态与行动导向表述Positive聚焦解决方案与价值。标准句式Standard Phrases开场白At Acme Corporation, we...、Our commitment to innovation...、Delivering excellence through...结束语Thank you for your continued partnership.、We look forward to serving your needs.、Together, we achieve excellence.数据呈现Data Presentation千位用逗号分隔货币用$X,XXX.XX百分比保留一位小数XX.X%日期用Month DD, YYYY表格表头品牌蓝、隔行变色、数字右对齐、文本左对齐。以上数字格式在 apply_brand.py 的 format_number 中有可直接调用的实现currency输出$1,234.56percentage输出12.3%large_number自动缩写为1.2M / 3.4K——方法与规范保持一一对应。质量关卡质检清单、红线与自动化校验定稿前自查Before FinalizingLogo 放置位置与尺寸正确所有颜色与品牌色板完全一致全篇字体统一无拼写与语法错误数据准确呈现保持专业语气。禁用元素Prohibited Elements未经批准的剪贴画或库存照片Comic Sans、Papyrus 等装饰性字体彩虹色或渐变未经指定的动画/转场竞品品牌标识或引用。自动化合规校验validate_brand.py这是把人工质检清单变成可执行校验器的关键文件核心设计如下数据模型BrandGuidelinesdataclass 承载brand_name、primary_colors、secondary_colors、fonts、tone_keywords、prohibited_words、tagline等字段ValidationResultdataclass 输出passed / score / violations / warnings / suggestions。四项校验validate_colors用正则#[0-9A-Fa-f]{6}|#[0-9A-Fa-f]{3}与rgb(...)模式扫描文本中的颜色凡不在批准色板内的记为 violationvalidate_fonts匹配font-family/font:声明检查是否命中已批准字体validate_tone命中prohibited_words如 cheap、outdated、inferior记 violation正文超过 100 字却完全没有tone_keywords时给出 warningvalidate_brand_name以不区分大小写的方式匹配品牌名凡是大小写不一致的如 acme corporation均记为 violation。计分规则score max(0, 100 - violations×10 - warnings×3)任何 violation 都导致passedFalsegenerate_suggestions会根据违规类别给出改用批准色板/字体/语气关键词的修复建议。便捷入口get_acme_corporation_guidelines()返回与 SKILL.md 完全一致的 Acme 默认规范main()内置一段刻意含违规的演示文本#FF0000、Comic Sans MS、小写品牌名等运行python validate_brand.py即可看到带分数与修复建议的合规报告。应用流程把规范翻译成输出动作SKILL.md 给出的 6 步操作流程是 Claude 每次生成文档时都应执行的标准动作以品牌色与字体起步套用对应模板结构在首页/首张幻灯片放置 Logo全篇保持一致格式对照品牌标准复核确保呈现专业外观。将 Skill 投入使用的工程化路径在仓库的 Skills 体系中自定义 Skill 会先被打包上传再在请求中引用目录合法性可用 skill_utils.py 的 validate_skill_directory 预检——必须存在以---开头的 YAML frontmatter、含name与description字段、frontmatter 不超过 1024 字符、目录总大小不超过 8MB上传与测试参考仓库 skills/README.md 与 Notebook 3 03_skills_custom_development.ipynb 的演示创建后在client.beta.messages.create中把 Skill 放入container.skills注意携带skills-2025-10-02等 beta 头具体见 skills/CLAUDE.md组合使用applying-brand-guidelines本身只提供规范与校验脚本真正产出 xlsx/pptx/pdf 文件仍依赖 Anthropic 官方内置的xlsx、pptx、pdf技能协同——品牌 Skill 负责约束视觉与措辞内置技能负责排版输出二者叠加即可得到既符合品牌又可直接交付的文档。定制指南把 Acme 换成你的公司SKILL.md 在 Notes 部分明确了边界与演化机制这也是你做定制时的注意清单品牌规范适用于所有对外沟通内部文档可使用简化格式特殊项目需申请例外规范每季度更新SKILL.md 与配套文件同步升级REFERENCE.md 的 Version History 给出了 1.0 → 2.0 的演进示例便于跟踪变更定制时建议四件套同步修改①SKILL.md中的色板/字号/Logo 规则②REFERENCE.md中补充打印场景的 CMYK 与 Pantone 值、部门差异如 Finance 负数用括号、Legal 用编号章节加水印③validate_brand.py的get_acme_corporation_guidelines()默认值换成自有品牌色与禁用词④apply_brand.py的COMPANY与COLORS常量。小结applying-brand-guidelines展示了自定义 Skill 的正确打开方式把知识性规范SKILL.md REFERENCE.md与可执行校验/格式化逻辑Python 脚本打包在同一目录Claude 按需加载、脚本兜底执行。无论你要统一季度财报的 Excel 表头、董事会汇报的 PPT 风格还是对外 PDF 的页眉版权行把本 Skill 的 Acme 占位信息替换为你的品牌标识体系即可获得一套随叫随到的企业文档风格约束器。【免费下载链接】claude-cookbooksA collection of notebooks/recipes showcasing some fun and effective ways of using Claude.项目地址: https://gitcode.com/GitHub_Trending/an/claude-cookbooks创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表