用途:把“调研某品牌”变成结构化、可复用的品牌上下文包,作为下游广告/视频技能生成内容前的基准资料。适用于用户要求“为广告调研某品牌”“建立品牌文件夹”“填充品牌上下文”,或下游技能需要 brand-research/*.md 与 brand-assets/manifest.json 已就绪时。若用户想立刻做视频/广告,或品牌包已完整且校验通过,则不应使用。
主要能力:产出固定结构的品牌根目录,包括 brand-research/ 下的 brand-summary.md、visual-identity.md、competitors.md、audience.md、asset-urls.md,必要时加 ui-references.md;brand-assets/manifest.json 及 logos、reference-photos 等资产目录;concept-brief.md 与空的 ad-runs/。流程分八阶段:消歧品牌与产品、搭建目录、网络调研写四份文档、可选分析现有广告、采集并登记 logo 与参考图、可选生成品牌锚定静帧(需 FAL)、撰写概念简报、运行 verify_pack.py 校验。
使用方式:核心路径无需密钥,仅可选图像生成阶段需要 FAL。安装:pip install -r requirements.txt;可选 cp .env.example .env 并填 FAL_KEY。脚本在技能目录运行,均接受 --brand-dir <path>。搭建:python scripts/scaffold_brand.py --brand-dir <brand_dir> --brand "<Brand Name>"。采集资产:python scripts/fetch_asset.py --brand-dir <brand_dir> --url <logo-url> --kind wordmark --subdir logos --name "Wordmark (black)" --description "..."。已有本地文件用 scripts/register_asset.py。生成静帧:python scripts/render_product_shot.py --brand-dir <brand_dir> --ref brand-assets/reference-photos/hero.jpg --prompt "..." --kind product_photo --subdir generated-product-shots --name "..." --description "..."。校验:python scripts/verify_pack.py --brand-dir <brand_dir>,必须输出 PASS。
限制与规则:品牌与产品未消歧前不得继续,同名实体不得猜测;四份调研文档不得留 TBD/TODO;每个资产需真实用途描述而非文件名复述;品牌文本需可溯源,不得编造;抓取的第三方参考图需注明“not licensed for redistribution”;无现有广告时不得虚构“Observed patterns”。技能为步骤幂等,重跑只补缺失部分,先运行 verify_pack.py,PASS 即退出。无法运行 verify_pack.py 的主机需先手工盘点再执行。若缺少新闻稿 logo 或可接受参考图,应标注并保持资产精简,不得虚构 logo。图像生成失败不应阻塞调研包。