agency-multi-brand-pack

Agency 多品牌套件

在一次协调运行中为 N 个长期合作客户生成内容——每个客户的输出都严格使用独立命名空间，每项任务都受该客户的品牌规则约束，每次运行都满足法务和计费的审计要求。

N 个客户 × 每个客户 M 个模板 → 一个批次，零交叉污染。 适用于为客户组合运行每周／每月创意周期的代理机构。

适用场景

• 为多个长期合作客户每周／每月更新内容
• 为整个客户组合进行季节性换肤（例如，在一个批次中为所有 8 个长期合作品牌更新节日主题）
• 多客户提案周，每份提案都需要各自的品牌样稿集
• 需要按客户拆分支出明细、以便财务／法务审计的生产运行
• 任何“按每位客户的规则为所有客户运行相同流水线”的代理机构工作流

不适用于单客户深度生产工作——请改用 agency-pitch-mockups 或特定客户的工作流。多品牌适用于整个客户组合的并行处理。

前提条件

请在一条消息中询问用户：

1. 客户列表 — 本次涉及的客户 slug（例如 acme-fintech、zest-retail、nova-travel）。每个客户都必须有已锁定的 brand-system.json。
2. 每位客户的模板集 — 所有客户使用相同模板集（主视觉 + 3 个社交媒体模板 + OG），还是每位客户的交付内容都不同？
3. 本周主题／简报 — 一个针对每位客户重新表达的简报（例如“Q2 产品更新”），还是每位客户都有完全独立的简报？
4. 输出位置 — 每位客户对应的 Drive 文件夹？Dropbox／S3？内部仓库路径？
5. 计费范围 — 为每项任务添加 client:<slug> 标签，以便从 gen-ai history 获取每位客户的支出
6. 并发上限 — 默认为 4；如果所有客户都有高级速率限制，则提高到 8

如果列表中的任何客户缺少 brand-system.json 或 brand.md，请停止并先为该客户运行 agency-brand-scoping——不得在品牌文件尚未锁定时批量生成。

运行方法

1. VERIFY BRANDS  → every client in scope has clients/<slug>/brand.md + brand-system.json
2. SCAFFOLD       → build per-client manifest fragments, merge into one master manifest
3. ESTIMATE       → gen-ai batch run <manifest.json> --dry-run + estimate; break into smaller batches if > $20
4. RUN            → `gen-ai batch run <manifest.json>` with client names in job IDs and a resume-ready output dir
5. VERIFY         → per-client output folders populated; cross-check any NULLs in results.json
6. AUDIT          → export per-client spend + asset list for billing
7. DELIVER        → folder per client, approved files uploaded or linked in the retainer channel

规则：

• 每位客户使用一个文件夹。 out/<slug>/...——绝不使用可能导致文件名冲突的共享输出文件夹。
• 每项任务使用一个品牌上下文，而非每个批次使用一个——每项任务的提示词都应包含相关客户 brand.md 中的约束。批次级通用提示词是造成交叉污染的最大原因。
• 使用稳定的任务 ID。 在每个 id 中加入客户或活动名称，让下载的文件和 results.json 仍易于归类。
• 默认使用 gen-ai batch resume <output-dir> 恢复。 使用 gen-ai batch resume <output-dir>，避免中途失败导致已完成的一半工作白费。

快速参考

{
  "batch_kind": "multi-brand-pack",
  "week": "2026-04-22",
  "defaults": { "model": "recraftv4", "aspectRatio": "1:1" },
  "clients": [
    { "slug": "acme-fintech", "templates": ["hero", "social-1", "og"] },
    { "slug": "zest-retail",  "templates": ["hero", "social-1", "og"] }
  ]
}

脚手架脚本会将其展开为 CLI 所需的扁平 jobs[] 清单。请将展开后的清单检入 out/retainer-<date>/manifest.json，以便复现。

快速参考

子任务	模型	备注
每位客户的主视觉（默认）	recraftv4	注重设计，遵循品牌调色板
每位客户的主视觉（照片主导型品牌）	flux-2-pro	照片占比较高的客户可在任务级别覆盖
社交媒体图块（1:1、9:16）	recraftv4	遵循相同的品牌规则，成本更低
OG／标题需清晰可读的幻灯片	ideogram-v3	唯一可靠的文字渲染模型
替换产品图片背景	recraftv3-replace-bg	适用于电商长期合作项目
每个品牌的视频剪辑	kling-v3-standard（草稿）／kling-v3-pro（最终版）	每位客户的并发数为 2

流程

• 每个客户端对应一个品牌文件，不共享「代理机构风格」规则。 每个客户端都应为自身的品牌规范付费。
• 按 slug 为每项输出添加命名空间 — out/<slug>/、drive:retainer-<date>/<slug>/、results.json 任务 ID。冗余是好事。
• 用脚本生成清单。 客户端超过 3 个时，用 Node/Python 脚手架遍历 clients[] × templates[]，比复制粘贴更不容易出错。
• 每次运行前都先估算。 多品牌批次很容易超过 $20 — 暂停并确认。
• 将 results.json 保存到代码库。 作为法律审计轨迹、计费依据和可复现性记录。
• 为每个客户端维护提示词库，路径为 clients/<slug>/prompts/ — 清单引用这些文件，修改后会同步生效。
• 审核对品牌敏感的输出。 `` — 缺少素材总比品牌标错好。
• 每周定期运行时应设置 cron，并在完成后通过 Slack webhook 通知；参见 gen-ai-batch.md §CI recipes。

注意事项

• 品牌交叉污染 — 单个任务缺少 rules，整个批次都可能有问题。解决方法：为每个任务设置 rules，而非在批次级别设置。
• 未添加 slug 前缀会导致文件名冲突 — 客户端 B 的 hero.webp 会覆盖客户端 A 的文件。
• 100 个任务的批次未运行 gen-ai batch resume <output-dir> — 提供方发生一次故障就会导致整个运行失败。
• 共享 Drive 文件夹 — 客户端 A 会看到客户端 B 的文件夹，违反 NDA。
• 未添加标签的任务 — 无法按客户端计费；财务询问时，你无法作答。
• 处处使用旗舰模型 — 每周批次成本会从 $15 涨到 $40。先生成草稿，再有选择地升级。

验证

运行 gen-ai whoami 确认身份验证，然后使用 --debug 重新运行失败的命令。

步骤 1：验证品牌并构建清单

CLIENTS=("acme-fintech" "zest-retail" "nova-travel")
WEEK=$(date +%Y-%m-%d)

# Sanity check: every client has a brand file
for c in "${CLIENTS[@]}"; do
  test -f "clients/$c/brand.md" || { echo "Missing brand.md for $c"; exit 1; }
done

步骤 2：合并各客户端的清单片段

cat > /tmp/multi-brand-$WEEK.json <<'EOF'
{
  "defaults": { "model": "recraftv4", "aspectRatio": "1:1" },
  "jobs": [
    { "id": "acme-fintech/hero",    "prompt": "acme-fintech Q2 hero — editorial, restrained", "aspectRatio": "16:9" },
    { "id": "acme-fintech/og",      "prompt": "acme-fintech OG — headline: Q2 launch", "aspectRatio": "1200x630", "model": "ideogram-v3" },
    { "id": "zest-retail/hero",     "prompt": "zest-retail Q2 hero — playful, bold color", "aspectRatio": "16:9" },
    { "id": "nova-travel/hero",     "prompt": "nova-travel Q2 hero — cinematic wide", "aspectRatio": "16:9", "model": "flux-2-pro" }
  ]
}
EOF

gen-ai batch run /tmp/multi-brand-$WEEK.json --dry-run
gen-ai batch run /tmp/multi-brand-$WEEK.json -c 4 -o "out/retainer-$WEEK"

每个任务 id 中的 / 会自动创建对应客户端的子文件夹 — 输出会保存到 out/retainer-<date>/<client-slug>/<asset>.webp，并附带 results.json。

步骤 3：按客户端审计并交付

# Per-client completion breakdown from results.json
node -e '
  const r = require("./out/retainer-2026-04-22/results.json");
  const by = {};
  for (const j of r.jobs) {
    const c = j.id.split("/")[0];
    by[c] ||= { completed: 0, failed: 0 };
    by[c][j.status] = (by[c][j.status] || 0) + 1;
  }
  console.table(by);
'

为每个客户端创建归档子文件夹 retainer-$WEEK/<client-slug>/，并在其中放入摘要，列出素材和根据 gen-ai pricing 估算的费用。仅分享各客户端文件夹的链接 — 绝不要分享主文件夹。

成本与时间

阶段	典型费用	典型耗时
范围界定（每个新客户端，一次性）	~$1	30 min
生产（每周长期合作，8 个客户端 × 4 项素材）	$15-30	批量处理 + 审核，共 20-40 min
旗舰模型升级处理（升级 2-3 项主视觉素材）	$5-10	10-15 min

每个客户端每周的费用应能从 results.json 中追踪 — 如果不能，说明标签设置有问题。

另请参阅

• workflows/agency-brand-scoping/ — 每个客户端都必须先完成此步骤
• workflows/agency-pitch-mockups/ — 每个客户端的提案变体
• workflows/agency-client-handoff/ — 合作结束时归档长期合作历史记录
• gen-ai-batch.md — 并发、gen-ai batch resume <output-dir>、审计方案