higgsfield-brandkit

Higgsfield 品牌套件

构建统一的品牌形象及用户要求的应用。将提供的品牌事实和官方素材视为固定约束。

初始化

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 交付物应保留为本地项目文件。

面向用户的行为

• 使用用户的语言。将 Design Brain 推理、提示词、状态机制、脚本、模型查询和 QA 内部信息保密。
• 每批可见生成最多发送一句简短状态说明，然后保持安静，直到结果就绪。
• 只针对尚未解决的阻塞问题提出一组简短问题。对于部分任务，切勿重复已知事实或强迫用户填写完整的品牌形象问卷。
• 每次完成配色方案、徽标、字体排版或下游内容评审后，都应停下并等待用户反馈。
• 切勿根据沉默、生成成功或自己的偏好推断用户已批准。
• 保留用户提供的确切文案。切勿编造定位、价值观、宣称、成分、价格、认证、统计数据或法规内容。

核心工作流

1. 对请求进行分类。

   • apply-existing：使用提供的官方素材，不重新设计。
   • extend-partial：仅创建请求输出所需的缺失项。
   • create-identity：仅在用户明确请求时创建新 Logo 或品牌标识。

2. **读取状态。**运行：

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

   本地状态具有持久性。状态文件存在时，绝不要粘贴、手动编辑或重新创建审批记录。

3. **执行需求收集和素材分析。**阅读需求收集、素材分析、状态路由和精确状态载荷。立即锁定用户指定的所有官方 Logo、调色板和字体项。

4. **创建品牌锁定记录。**阅读品牌锁定。记录准确拼写、官方素材、颜色、字体、布局／形状规则、请求的输出和禁止的处理方式。

5. 仅要求输出所用的项。

   • 仅 Logo → 新标志需要调色板 + Logo；现有标志只需官方 Logo
   • 仅调色板 → 调色板
   • 仅字体 → 字体
   • 无文案的样机／周边 → Logo；仅在颜色／应用需要时添加调色板
   • 带文字的社交媒体素材／包装／海报／标牌 → Logo + 调色板 + 字体
   • 品牌手册／演示文稿 → Logo + 调色板 + 字体

6. **构建缺失的基础项。**阅读 Design Brain、概念板、内嵌审阅，以及所需的调色板、Logo或字体模块。

7. 所需项一经批准，立即继续处理原始请求。绝不要再次询问用户要选择什么范围。

8. 仅加载请求所需的制作模块：

   • 样机
   • 社交媒体图片
   • 海报／横幅
   • 包装
   • 标牌
   • 周边商品
   • 演示文稿
   • 品牌手册

9. **质量检查与审批。**阅读质量检查与迭代。仅修复未通过的输出。只有在获得明确批准后，才保存下游元素，并记录其确切的基础依赖项。

新品牌标识流程

1. 调色板

使用预览载荷，以确定性 HTML 呈现 2–3 个精确的调色板选项。展示 PNG 截图和可编辑 HTML 文件，然后等待。生成 Logo 前，使用 approve_palette 保存选定的调色板。

2. SVG Logo 标志

阅读 Logo 提示词增强器。制作恰好三个不同的纯符号方案，并为每个方案编写一条 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 "<selected Recraft SVG URL or absolute local path>"

使用 approve_logo 保存准确的任务 ID、SVG URL、名称、调色板修订版本和返回的规范几何指纹。

3. 字体

使用提供的字体或经验证的 Google Fonts，提出 2–3 组独特的展示字体／正文字体搭配。通过预览脚本呈现真实品牌名称和示例文案。仅使用 approve_typography 保存选定的字体搭配。

交互式流程必须在调色板、Logo 和字体选择环节暂停等待。明确的免提问模式可以自行选择并保存调色板，但仍必须展示全部三个 SVG Logo 候选项，并等待用户选择 Logo；绝不自行批准精确的品牌标志。

一致性不变量

• 在所有地方重复使用同一已批准的 Logo 来源。只要能够确定性地放置或导出，就绝不重新绘制官方或选定的 SVG。
• 生成的 Logo 取决于创建它时使用的调色板修订版。更改该调色板会使生成的 Logo 及其依赖项失效；更改字体排版不会使标志图形失效。
• 更改基础项插槽，只会使 required_slots 中列出该插槽的下游元素失效。
• 将相同的 Brand Lock 值复制到每个相关生成提示词中：准确的十六进制颜色、字体角色、形状语言、位置、留白、构图和禁止的处理方式。
• 仅对新 Logo 标志使用 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"

导出 Logo 时，加载 Logo 导出载荷。对于 Brandbook，只能使用捆绑的构建器；确定性契约失败后，绝不能改用临时编写的 PowerPoint 或 PDF 生成器。

失败处理策略

• Recraft 或图像生成请求失败时，使用相同的锁定概念和修正后的契约重试一次。第二次出现同等失败后停止。
• 如果预览或 Logo 导出连续失败两次，报告具体错误；绝不能用临时 SVG 改写来替代。
• 如果 Brandbook 模板、字体或转换契约失败，立即停止。不要生成视觉效果不同的备用版本并称其为标准版本。
• 如果无法保留精确的字体排版或官方 Logo 的忠实度，应披露限制，而不是声称已完成。
• 绝不在文件、日志或聊天中暴露原始身份验证令牌或凭据。

交付

对于 Brandbook，遵循 brandbook 中的严格回复规范：仅提供 PPTX 链接/路径、PDF 链接/路径和字体安装警告。

对于其他输出，返回：

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

参考索引

• 前置条件 — 各阶段所需的本地依赖和安装命令。
• 信息收集 — 最少提问和输入路由。
• 素材分析 — 官方素材／参考素材分类和测量。
• 状态路由和状态负载 — 持久化审批。
• 品牌锁定 — 规范的视觉约束。
• 设计大脑 — 私有艺术指导。
• 概念板、预览负载和内联评审 — 选择阶段。
• Logo、Logo 提示词增强器和Logo 导出负载 — SVG 生成和确定性变体。
• 配色方案和字体排版 — 基础槽位。
• 样机、社交媒体图片、海报／横幅、包装、标识和周边商品 — 应用场景。
• 演示文稿和品牌手册 — 可编辑文档。
• QA 和迭代 — 预检、修复、审批和交付清单。