Higgsfield Brandkit

Higgsfield Brandkit 是做什么的？

构建具有连贯性的品牌标识及其所需的应用产物。将提供的品牌事实和官方资产视为固定约束。

启动

1. 将 SKILL_ROOT 解析为本技能的安装目录，并创建一个持久的项目目录：

   BRANDKIT_WORKDIR="${PWD}/brandkit"
   BRANDKIT_STATE="${BRANDKIT_WORKDIR}/state.json"
   mkdir -p "${BRANDKIT_WORKDIR}"
   

2. 阅读先决条件。在需要工具的步骤之前检查它们。未经用户许可，切勿安装系统包。

3. 如果 higgsfield 缺失，仅在获得许可后安装：

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

4. 如果 higgsfield account status 报告身份验证或工作区错误，请要求用户运行 higgsfield auth login 或选择一个工作区，然后等待。

5. 在付费生成之前检查实时模型合约：

   higgsfield model get recraft_v4_1 --json
   higgsfield model get seedream_v5_pro --json
   higgsfield model get gpt_image_2 --json
   

CLI 映射

操作	命令
发现模型	higgsfield model get <model> --json
生成并轮询	higgsfield generate create <model> ... --wait --json
恢复作业	higgsfield generate wait <job_id> --json
上传本地资产	higgsfield upload create <path> --json
导入网站元数据	higgsfield marketing-studio brand-kits fetch --url <url> --wait --json
读取/写入审批状态	python3 "$SKILL_ROOT/scripts/brandkit.py" state ...
渲染评审板	python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...
检查选定的徽标	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...
导出徽标文件	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...
构建品牌手册	python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...

使用 --image 传递的本地图片路径会被自动上传。将 HTML、SVG、PPTX 和 PDF 交付物保留为本地项目文件，除非用户明确需要托管副本。

用户交互行为

• 匹配用户的语言。将设计推理、提示词、状态机制、脚本、模型查找和内部质量检查保持为私有。
• 每个可见的生成批次最多发送一条简短的状态句，然后保持沉默，直到结果准备就绪。
• 仅提出一组尚未解决的阻塞性问题。切勿重复提及事实，也不要为部分任务强制填写完整的品牌标识问卷。
• 在每个调色板、徽标、排版或下游审核完成后，停下来等待用户的常规反馈。
• 切勿因沉默、成功生成或你自己的偏好而推断批准。
• 保留用户原文。切勿发明定位、价值观、声明、成分、价格、认证、统计数据或监管内容。

核心工作流

1. 分类请求。

   • apply-existing：使用提供的官方资产，不重新设计。
   • extend-partial：仅创建所请求输出需要的缺失部分。
   • create-identity：仅在明确请求时创建新的徽标或品牌标识。

2. 读取状态。 运行：

   python3 "$SKILL_ROOT/scripts/brandkit.py" state \
     --state-file "$BRANDKIT_STATE" --action get_status
   

   本地状态是持久的。当状态文件存在时，切勿粘贴、手动编辑或重新创建审批记录。

3. 执行信息收集与资产分析。 阅读信息收集、资产分析、状态路由和确切状态负载。立即锁定每个用户声明的官方徽标、调色板和排版插槽。

4. 创建品牌锁。 阅读品牌锁。记录确切的拼写、官方资产、颜色、字体、布局/形状规则、请求的输出以及禁止的处理方式。

5. 仅要求输出所使用的插槽。

   • 仅徽标 → （新标识需）调色板 + 徽标；（现有标识只需）官方徽标
   • 仅调色板 → 调色板
   • 仅排版 → 排版
   • 无文字的样机/周边 → 徽标；仅当颜色/应用需要时才添加调色板
   • 含文字的社交媒体/包装/海报/标牌 → 徽标 + 调色板 + 排版
   • 品牌手册/演示文稿 → 徽标 + 调色板 + 排版

6. 构建缺失的基础插槽。 阅读设计大脑、概念板、内联审核，以及仅所需的调色板、徽标或排版模块。

7. 一旦所需插槽获得批准，立即继续原始请求。 切勿再次要求用户选择范围。

8. 仅加载请求的生产模块：

   • 样机
   • 社交媒体素材
   • 海报/横幅
   • 包装
   • 标牌
   • 周边产品
   • 演示文稿
   • 品牌手册

9. 质量检查与审批。 阅读质量检查与迭代。仅修复失败的输出。只有在明确获得批准且具有准确的基础依赖关系后，才保存下游元素。

新品牌标识生成序列

1. 调色板

使用预览负载将 2–3 个精确的调色板选项渲染为确定性 HTML。显示 PNG 截图以及可编辑的 HTML 文件并等待。在生成徽标之前，使用 approve_palette 持久化选定的调色板。

2. SVG 徽标

阅读徽标提示词增强器。精确生成三个仅限符号的不同方案，并为每个方案生成一个 Recraft 提示词。将每个长提示词写入文件并分别提交：

higgsfield generate create recraft_v4_1 \
  --model_type vector \
  --colors @"${BRANDKIT_WORKDIR}/logo-colors.json" \
  --background_color '#F7F7F5' \
  --aspect_ratio 1:1 \
  --resolution 2k \
  --wait --json < "${BRANDKIT_WORKDIR}/logo-candidate-1.txt"

直接使用返回的 SVG URL 进行审核。选择后，检查确切的 SVG，不做更改：

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<选定的 Recraft SVG URL 或绝对本地路径>"

使用 approve_logo 持久化确切的作业 ID、SVG URL、名称、调色板修订版以及返回的规范几何指纹。

3. 排版

使用提供的字体或经过验证的 Google Fonts 提出 2–3 种独特的显示/正文字体对。通过预览脚本渲染真实的品牌名称和示例文案。仅使用 approve_typography 持久化所选字体对。

交互式流程始终在调色板、徽标和排版选择处停止。明确的无需提问模式可以选择并持久化一个调色板，但仍然显示所有三个 SVG 徽标候选项，并等待用户选择徽标；品牌标识标记绝不会自动批准。

一致性不变性

• 在所有地方复用相同的已批准徽标源。当确定性放置/导出可行时，切勿重新绘制官方或选定的 SVG。
• 生成的徽标依赖于创建它时所使用的调色板修订版。更改该调色板会使生成的徽标及其依赖项失效；更改排版不会使符号标记失效。
• 更改基础插槽仅会使在其 required_slots 中列出该插槽的下游元素失效。
• 将相同的品牌锁值复制到每个相关的生成提示词中：确切的十六进制颜色、字体角色、形状语言、放置方式、留白空间、构图以及禁止的处理方式。
• 仅对新的徽标标记使用 Recraft V4.1 矢量模式。
• 将 Seedream 作为主要的照片级样机生成器。仅在有可控阶段需要添加可读文字或精确图形细节时使用 GPT Image 2。
• 对于精确的文案和可编辑的布局，使用本地确定的 SVG/PPTX/HTML 构建。不要要求图像模型伪造可编辑文件。
• 不要承诺提供原生的 Figma、Canva、PSD、AI 或 EPS 文件。

确定性脚本

在 "$BRANDKIT_WORKDIR" 下创建 JSON 输入文件；切勿将用户文本直接插入到 shell 参数中。

python3 "$SKILL_ROOT/scripts/brandkit.py" preview \
  --input "$BRANDKIT_WORKDIR/reviews.json" \
  --output-dir "$BRANDKIT_WORKDIR/reviews"

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export \
  --input "$BRANDKIT_WORKDIR/logo-export.json" \
  --output-dir "$BRANDKIT_WORKDIR/logo"

python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build \
  --state-file "$BRANDKIT_STATE" \
  --input "$BRANDKIT_WORKDIR/brandbook.json" \
  --output-dir "$BRANDKIT_WORKDIR/brandbook"

对于徽标导出，加载徽标导出负载。对于品牌手册，仅使用捆绑的构建器；在确定性合约失败后，切勿用临时的 PowerPoint 或 PDF 生成器替代。

失败策略

• 对于失败的 Recraft 或图像生成请求，使用相同的锁定概念和修正后的合约重试一次。在第二次等效失败后停止。
• 如果预览或徽标导出失败两次，报告具体错误；切勿使用临时的 SVG 重写来代替。
• 如果品牌手册模板、字体或转换合约失败，立即停止。不要生成视觉上不同的备用方案并称之为规范版本。
• 如果无法保证准确的排版或官方徽标保真度，请披露此限制，而不是声称完成。
• 切勿在文件、日志或聊天中暴露原始身份验证令牌或凭据。

交付

对于品牌手册，遵循品牌手册中严格的响应合约：仅提供 PPTX 链接/路径、PDF 链接/路径和字体安装警告。

对于其他输出，返回：

1. 请求的视觉文件和预览。
2. 简洁的品牌锁摘要。
3. 可编辑与扁平化格式的标签。
4. 所需的字体/导入限制。
5. 用于定向修订的稳定变体名称。

参考索引

• 先决条件 — 按阶段划分的本地依赖项和安装命令。
• 信息收集 — 最少问题和输入路由。
• 资产分析 — 官方/参考资产的分类与测量。
• 状态路由 和状态负载 — 持久化审批。
• 品牌锁 — 规范视觉约束。
• 设计大脑 — 私密艺术指导。
• 概念板、预览负载和内联审核 — 选择阶段。
• 徽标、徽标提示词增强器和徽标导出负载 — SVG 生成与确定性变体。
• 调色板和排版 — 基础插槽。
• 样机、社交媒体素材、海报/横幅、包装、标牌和周边产品 — 应用。
• 演示文稿和品牌手册 — 可编辑文档。
• 质量检查与迭代 — 预检、修复、审批和交付清单。