Communitygithub.com

品牌技能构建器

根据品牌手册为任意公司构建品牌技能库:创建语音技能、格式技能(可生成符合品牌的 PDF、Word、PPT、社交媒体图片、HTML 和动效文件)以及审计技能(用于检查资产是否符合品牌规范)。将品牌手册转化为结构化的基础规范(调色板、排版、结构体系、无障碍性、语音),并逐步构建每个技能,包括基于摘要验证的上下文快照、预检、平台测试和打包器。

品牌技能构建器 是什么?

品牌技能构建器是一个 AI 智能体技能,用于根据公司的品牌指南创建和维护一个“品牌技能库”。该技能库包含一组小型、可组合的技能,使得 AI 模型能够为指定品牌生成一致、合规的内容。其核心理念是将品牌手册转化为结构化、机器可读的“基础规范”,如颜色、字体、版式和语音指南,然后基于这些基础构建专门的输出技能。 支持的技能类型包括:**语音技能**(定义品牌语调与措辞)、**格式技能**(例如,生成符合品牌 PDF、Word、PPT 或 HTML 文件)、以及**审计技能**(根据既定的品牌规则检查现有资产)。构建流程极其严谨:从资料收集开始,随后进行底层框架搭建、基础规范编写、与品牌所有者进行确定,最后逐步构建各个技能。 该技能严格遵守品牌资料,绝不自行编造任何品牌价值;每个决策都必须记录来源和理由。它提供了一个完整的工具链,包括用于生成代码框架、验证上下文、打包和交付的脚本。最后,用户可以在 Claude 和 ChatGPT 等平台上交付符合品牌的成果。 此技能本身并非一个直接的品牌技能;它不生成任何品牌文件,也不存储任何品牌的规则。它只是一个构建和管理此类技能的工具。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/yuckier/brand-skill-builder/tree/HEAD/skills/brand-skill-builder

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

品牌技能构建器 是做什么的?

此技能帮助您构建和维护一个品牌技能库:一组小型技能,使任意模型能够为特定公司生成符合品牌的 作品。它承载了来自生产库的架构、模板、脚本和经验教训;它本身不携带任何品牌。所有品牌价值均来源于用户的资料。

在开始任何模式之前,请先阅读 references/architecture.md。当以下步骤中提及其他参考资料时,请阅读它们。

文件夹。 在每个命令中,SKILL_DIR 是存放此文件的文件夹,LIB 是用户选择的库文件夹。 在每个命令中都要完整写出两者;不要将它们设置为 shell 变量(在某些平台上,一个命令中设置的变量在下个命令中会消失)。

选择模式

用户想要模式
为一个尚无任何品牌技能的品牌创建技能A. 新建库
在现有库中再添加一个技能B. 添加技能
审查现有的品牌技能或库C. 审查
在构建前先了解方法从 references/architecture.md 中解释并停止

只有当请求未明确说明模式时才询问。

A. 新建库

  1. 收集资料。 索要品牌手册以及任何规范品牌的文件:设计团队的模板、语音指南、 消息文档、商标规则、样式指南、logo 文件、字体及其许可、任何图标或 照片库。询问谁拥有该品牌(将批准决策的人员)。标记缺失内容;不要自行补充。
  2. 搭建框架。 python3 SKILL_DIR/scripts/scaffold.py library LIB --brand "<Brand>" --era <era>。era 是 此版本品牌的简短标签(例如 2027-brand)。将资料放入 LIB/reference/。
  3. 编写基础规范 根据 references/brand-foundations.md,基于资料将内容写入 LIB/shared-context/brand-foundations/context/。 填写每个 TODO(来自资料)或将其记录为空白。测量对比度;引用手册中包含规则的措辞; 为每个文件注明来源。当资料涵盖时,在 logo/ 下添加logo 图稿,以及 logo-policy.md、 imagery-policy.md 和 chart-palette.json。
  4. 与所有者一起审查。 以简短摘要形式展示基础规范:颜色模型、字体角色、标志性元素、发布检查清单、空白项,以及每个提议的“内部决策”及其一个建议和理由。等待 他们的决定;将每个决策记录在“内部决策”表和开发日志中。
  5. 构建语音技能(使用 --kind voice 的模式 B)。它很小,可以验证快照、预检和打包路径。
  6. 构建第一个格式技能(使用 --kind format 的模式 B),即人们最需要的格式。先走最小的端到端路径,然后进行试点循环。
  7. 一次添加一个格式,首先确定每个格式的“内部决策”(references/process.md,“工作顺序”)。
  8. 构建审计技能(使用 --kind audit 的模式 B),一旦存在可供审计的格式规范。

B. 添加技能

  1. 命名为 <brand>-<format>(小写,连字符),或 <brand>-voice,<brand>-audit。确认一个技能只做一件事:如果 请求与现有技能重叠,请明确指出并建议扩展该技能。
  2. 搭建框架。 python3 SKILL_DIR/scripts/scaffold.py skill LIB <name> --kind format|voice|audit --format "<PDF>"。这会 写入 SKILL.md 模板、agents/openai.yaml、预检脚本、平台测试脚本以及快照配置文件 LIB/tools/snapshot/<name>.json;对于格式技能,还会写入 LIB/shared-context/<name>/context/format-spec.md 和 format-map.json。
  3. 在编写代码之前确定格式的内部决策:对于 structural-system.md 中范围标注为“构建时由其他人决定”的每个决策,为此格式推荐一个答案,获取所有者的决策,然后记录下来。
  4. 编写格式规范和 map(带 BOOK、RATIFIED 和 PROPOSED 标签的文字描述;带角色名称的数字,从不使用十六进制)。
  5. 编写构建器和 QA 脚本,遵循 references/format-skills.md:模型规划并编写 JSON 规范, 脚本负责构建,脚本负责对完成文件进行检查;构建时读取令牌,记录偏差, 从不拒绝。语音和审计技能则遵循 references/voice-and-audit.md。
  6. 填写 SKILL.md:描述(触发器、它不会做什么,1,024 个字符以内)、步骤、带有“查看-规范-表”的输入处理、规范参考、“警告-绝不-拒绝”部分,以及每个平台的一条交付说明。
  7. 快照和验证。 python3 LIB/tools/snapshot/snapshot.py LIB/tools/snapshot/<name>.json,然后 --check,接着 python3 LIB/skills/<name>/scripts/verify_context.py。将字体、样式表和图稿添加到配置中的 bundled_assets, 以便预检脚本能验证它们。
  8. 测试(references/qa-and-testing.md):平台测试、在两种主题下进行固定结构构建、针对每个 QA 检查项的篡改测试、 令牌交换测试。然后使用一个现实的提示词进行试点循环,每次修复后重新运行相同的提示词。
  9. 应要求打包(references/packaging.md): python3 LIB/tools/package/package_skill.py LIB/skills/<name> <name> <一个干净的临时文件夹>/<name>.zip --date YYYY-MM-DD。 解压到另一个干净的文件夹中,并在将 zip 文件放入 LIB/finalized-skills/ 之前从那里运行测试。
  10. 记录日志。 上述每一步都应该在发生时记录到 LIB/DEV-LOG.md 中。

C. 审查

读取技能(或库)并与模式进行比较。按以下顺序报告,每个条目均包含文件和行号:

  1. 结构:一个技能只做一件事,无运行时调用其他技能,存在 agents/openai.yaml,无单平台路径。
  2. 上下文:包含清单和摘要的捆绑快照,返回警告而非停止的预检,品牌时期。
  3. 构建器:构建时读取令牌(或硬编码值)、JSON 规范、偏差而非拒绝。
  4. QA:与发布检查清单关联的对完成文件的检查,篡改测试,如果技能包含重新样式化模式则需测试。
  5. 工作流:带默认值的输入,带声明和证据的计划,批准后再构建,以警告先行的交付。
  6. 打包:严格的前置元数据、描述长度和触发器、发布记录。

按影响顺序推荐修复。除非被要求,否则不要更改任何内容。

适用于所有模式的规则

  • 绝不编造品牌价值。 任何颜色、字体、尺寸、规则、声明、图形或客户都不得来自常识。 空白项应被记录并由所有者决定,或者该元素被省略。
  • 品牌手册是记录规则;所有者的设计文件填补其空白;每个偏离都是“内部决策”,需记录 其范围、所偏离的手册原文、状态以及决策者。
  • 警告,绝不拒绝,在您构建的技能内部:修复并报告,交付带有标记的失败文件, 仅当物理上不可能时才停止。没有语音文件的语音技能就是那种不可能。
  • 建议,然后询问,针对每个属于所有者的选择。只有在其做出决定后才开始构建。
  • 测量,而非猜测:对比度、文本宽度、行数、渲染效果。
  • 在真实的渲染器中查看输出之后才能说完成。

交付

  • 在 Claude 上:总结已创建或更改的内容及其路径,并从输出文件夹分享任何已打包的 zip 文件。
  • 在 ChatGPT 上:总结已创建或更改的内容及其路径,并提供任何已打包 zip 文件的下载链接。

然后列出仍然待办的事项、每个等待所有者的空白项,以及每个 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严格的前置元数据、描述、发布步骤、上传失败处理
references/process.md决策、活记录、工作顺序、安全工作、Office 工具链的经验教训

相关技能