Brand System Forge

Brand System Forge 是一个面向 Codex 的品牌视觉系统生成技能。它从用户提供的 Logo 出发，以可追溯证据、置信度标记和 fail-closed 质量门禁为核心，生成同版的 16:9 HTML 与 PDF 品牌规范手册。

本项目只覆盖“品牌标识”和“品牌视觉系统”。它不会生成包装、社交传播、数字产品、办公物料、空间导视、应用场景、物料模型或落地效果图。

生成效果预览

以下图片由实际 HTML/PDF 生成与 QA 流程输出，用于展示手册的规则页、Logo 间距和色彩系统版式。

安全区域与最小尺寸	Logo 在不同背景上的用法

灰度适配测试	主色系统

核心能力

• 对 SVG、PDF、AI、PNG、JPG Logo 进行分析与质量评分
• 记录 verified、extracted、derived、recommended 四类证据来源
• 为所有可执行规范数据记录 source 与 confidence
• 根据证据充足度动态删页，不用虚构内容填充手册
• 生成 Logo 安全区域、比例、最小尺寸、色彩、排版与辅助图形规范
• 从同一份规范数据生成可编辑 HTML 与同版 PDF
• 自动检查页数、画幅、字体、图片、证据状态、唯一封面和末页 Thanks
• QA 失败时阻止最终交付目录输出

必要输入

运行生成流程前必须确认以下信息：

1. 品牌名称 brand.name
2. 品牌 Logo brand.logo
3. 所属行业 brand.industry
4. Logo 是否为最终版本 brand.logo_final

行业值仅接受：

technology、food、finance、education、medical、culture、fashion、consumer

Logo 优先使用 SVG、PDF 或可解析的 AI 文件；没有矢量文件时，使用最高分辨率的透明 PNG。

Logo 质量门禁

Logo 分析会生成包含分辨率、背景、边缘质量和格式的综合评分：

• < 60：停止生成，并要求更换 SVG 或透明 PNG
• 60–80：允许继续，但必须显示精度风险提示
• > 80：正常进入规范生成流程

栅格 Logo 必须另存为净图资产，并在白、黑、50% 灰和棋盘格背景上通过 400%–800% 边缘检查。源文件不会被覆盖。

安装

将整个目录复制到 Codex skills 目录：

cp -R brand-system-forge ~/.codex/skills/brand-system-forge

请保留 SKILL.md、references/、scripts/、assets/ 和 agents/ 的相对目录结构。

Python 脚本主要依赖：

python3 -m pip install Pillow pypdf

PDF 导出与渲染 QA 还需要：

• Chrome、Chromium 或兼容的无头浏览器
• Poppler 提供的 pdftoppm

在 Codex 环境中，脚本也会尝试使用随工作区提供的 PDF 运行时。

使用方式

在 Codex 中调用：

使用 $brand-system-forge，根据我提供的最终版 Logo 制作品牌视觉规范。

技能会先验证品牌名称、行业、Logo 最终版状态与 Logo Quality Score。缺少必要输入或质量门禁失败时，流程会停止，不会直接生成手册。

1. 分析 Logo

python3 scripts/analyze_logo.py path/to/logo.svg \
  --output logo-analysis.json

栅格图需要生成独立净图时：

python3 scripts/analyze_logo.py path/to/logo.png \
  --output logo-analysis.json \
  --normalized-output assets/logo-normalized.png

2. 创建品牌规范数据

从示例开始：

cp assets/brand-spec.example.json brand-spec.json

按照 references/brand-spec-schema.md 填写规范数据。所有可执行数据都必须带有证据来源和置信度。

3. 执行硬门禁校验

python3 scripts/validate_spec.py \
  --spec brand-spec.json \
  --report evidence.json

校验未通过时不得生成 HTML。

4. 一次生成并验收完整项目

python3 scripts/build_project.py \
  --spec brand-spec.json \
  --output Brand_Project

构建器会先在临时目录生成内容，只有 PDF QA 通过后才移动到最终输出目录。

交付结构

Brand_Project/
├── Brand_Guidelines.html
├── Brand_Guidelines.pdf
├── assets/
│   ├── logo.svg
│   └── logo-white.svg       # 仅在已提供并验证时存在
├── source/
│   └── brand-spec.json
└── report/
    └── evidence.json

HTML 是可编辑源文件，PDF 必须来自同一份最新 HTML 和规范数据。两者页数、内容与 16:9 画幅必须一致。

证据模型

每项规范数据使用以下结构：

{
  "value": "#FA0F00",
  "source": "extracted",
  "confidence": "high"
}

允许的证据来源：

• verified：用户明确提供或正式文件确认
• extracted：从用户素材中可重复提取
• derived：根据 Logo 可见几何或测试推导
• recommended：设计建议，不代表官方规范

允许的置信度为 high、medium、low。低置信度数据不能进入手册正文，只能记录在证据报告的省略项中。

内容边界

每本手册最多包含一个封面，并且必须以唯一的 Thanks 页结束。手册中不会加入：

• 品牌视觉应用章节
• 包装、服装、导视或办公物料
• 数字产品或社交传播页面
• 联合标志、摄影或复杂插画系统，除非存在已验证或可提取的真实素材
• 只有口号、渐变、光斑或装饰图形的纯氛围页面
• 未经品牌方确认的口号、商标、生产或知识产权事实

项目结构

brand-system-forge/
├── SKILL.md                 # 技能入口与完整工作流
├── agents/openai.yaml       # Codex 展示与默认提示配置
├── assets/                  # 示例规范、Logo 与排版字体
├── references/              # Schema、页序与视觉规则
└── scripts/                 # 分析、构建、导出和 QA 脚本

字体与授权

仓库包含用于模板排版的 Alibaba PuHuiTi 3 与 Plus Jakarta Sans 字体文件。公开分发、商业使用或嵌入交付物前，请自行确认字体来源、许可范围和再分发条件。

Font availability and licensing should be confirmed before commercial use.

免责声明

本技能生成的推导项和建议项不等于品牌官方规范，也不能替代品牌方、印刷供应商、商标顾问或字体授权方的确认。Logo 仅作为设计证据使用，不应据此推断品牌战略、知识产权状态或生产参数。