Douyin Cover

Douyin Cover

为当前项目生成短视频封面图。默认目标是：标题一眼能读懂，画面简约大方且有点击理由，泊舟 IP 人物稳定可识别。技能只提供比例、版式、文字准确性和质量检查框架，不预设具体场景、道具或画面元素。

先读这些

• 每次使用先读 references/ip-persona.md，确认泊舟 IP 的稳定特征。
• 每次正式设计前读 references/design-playbook.md，从标题类型选择合适的视觉策略。
• 需要具体锚点位置、配色 HEX、字重比、对比度阈值时，读 references/template-formulas.md。这是可选工具箱：选一个模板方向参考其参数即可，简约优先级永远高于信息密度，不要因为有模板就堆色块、堆小字。
• 用户给的是一张已有封面、问为什么没人点 / 帮我改 / 怎么提升点击率时，走 references/cover-diagnosis.md 的诊断改版流程。
• 头像参考资产在 assets/bozhou-avatar-reference.jpg，规范化卡通参考在 assets/bozhou-ip-canonical-cartoon-reference.png。凡是封面出现泊舟 IP，必须先用 view_image 打开至少一张参考图，优先两张都打开，并在系统 imagegen 提示词里明确写成 identity reference；不能只把 IP 特征写进文字提示词。

输出位置（重要）

封面默认存进对应视频工程文件夹，不再统一塞进 douyin-covers/。

• 确定目标视频工程：用户指定了某个工程目录就用它；否则用当前所在的视频工程（含 逐字稿.md / 分镜.md / index.html 等成片资产的那个项目目录）；标题能明确对应到某个已有工程时也用那个工程。
• 默认只把通过检查的最终图存到该工程目录下的 cover/ 子文件夹（不存在就先创建），例如 prompt-context-harness/cover/。生成过程中的试稿留在系统 Image Gen 默认目录，不复制进项目。
• 文件名包含标题 slug 和比例，例如 cover/harness-cover-AI客服退错旧卡-3x4.png。只有用户明确要求保留多个候选或方案时，才使用 -candidate-1、-candidate-2 并把候选复制进项目。
• 只有在无法判断属于哪个视频工程（例如在仓库根目录泛泛生成、与任何成片项目都无关）时，才回退到旧路径 douyin-covers/YYYY-MM-DD/generated/。
• 不确定该放进哪个工程目录、且存在多个候选工程时，先问用户一句，不要凭空选。

工具硬约束

• 小白学AI系列封面例外：如果 xiaobai-ai-cover skill 可用，停止本流程，改用该 skill 的系统内置 imagegen + 固定参考图流程。
• 默认必须使用系统 imagegen skill 的内置 image_gen 工具生成封面图。不要默认调用 gpt-image skill、DragonCode 脚本、第三方生图脚本或其它通用图像工具；只有用户明确要求 CLI/API/DragonCode 路径时，才另行按用户指定路径处理。
• IP/人物封面必须带参考图：先用 view_image 把参考图放进上下文，再在提示词 Input images 中标注“identity reference”。如果做泊舟 IP，至少使用 assets/bozhou-avatar-reference.jpg，优先同时使用规范化卡通参考图；不得只靠文字描述“黑发眼镜程序员”。
• 不要用代码合成封面：禁止用 Pillow、ImageMagick、Canvas、SVG、HTML/CSS 截图、程序绘图等方式生成、拼接、绘制、叠加、修补封面画面或标题文字。
• 本地命令只用于必要的非视觉操作：创建 cover/ 目录、复制系统 Image Gen 输出、重命名文件、读取尺寸、查看图片。
• 如果系统 Image Gen 一次生成的文字或构图不合格，解决方案是改提示词并重新调用 image_gen，而不是用代码修字、补字、换背景或做局部合成。

输入判断

从用户消息中提取：

• title：封面主标题。没有标题时先问一句，不要凭空编主标题。
• ratio：默认 3:4。用户说横版、视频封面、B 站、公众号头图、4:3 时用 4:3。用户说合集封面、正方形、1:1、1080x1080、1080*1080 时用 1:1。
• subtitle：可选，用于补充收益、冲突或系列信息。
• platform：默认抖音/小红书竖版封面。
• tone：从标题推断，可为新手入门、争议纠错、工具教程、经验总结、案例拆解、效率提升、避坑警示、方法论等。

比例和目标尺寸说明：

目标尺寸用于理解用户发布场景。实际像素以系统 Image Gen 返回的原图为准；不要为了凑像素尺寸而用代码合成或重排版。

工作流

1. 先做一个简短的创意判断，不要直接套上一次的样子：

   • 观众为什么会点？（信息密度：利益点在缩略图里清不清楚；视觉锚点：有没有一个让眼睛停住的位置。）
   • 这张封面要传达什么气质：清爽、专业、轻松、强观点、结果感、避坑感等？
   • 从标题类型选一个模板方向（冲突型 / 数字型 / 截图型 / 情绪型，见 references/template-formulas.md）作为锚点和配色的参考，但只选一个，不混搭，也不强制堆料。
   • 标题和主视觉的比例如何安排，才能在手机缩略图里一眼读懂？
   • 如何尽量减少元素，只保留最能服务点击的内容？
   • 如果出现泊舟 IP，如何让他只做辅助，不抢标题？

2. 写一段 visual brief，至少包含：

   • 版式：比例、标题区域、主视觉占比、留白和层级。
   • 气质：简约大方、有点击欲，避免杂乱和廉价感。
   • 色彩：2-3 个主色和一个强调色。不要默认每次都是同一套配色。
   • IP 出现方式：只写稳定识别特征和画面占比，不写固定动作或固定场景。
   • 文字计划：封面上要出现的完整文字、换行方式、字号层级、标题底板/描边/投影/贴纸等可读性处理。

3. 写一套规范的系统 Image Gen 提示词：

   • 按系统 imagegen skill 的默认内置工具流程调用 image_gen。不要为了尺寸、质量或路径控制改走 DragonCode/CLI。
   • 如果出现泊舟 IP 或其它指定人物/IP，必须先 view_image 参考图，并在提示词里写清：Input images: the visible reference images are identity references for the same IP/person。
   • 提示词必须把封面文字当作画面核心元素来描述，而不是事后叠加。明确写出：封面文字必须严格为「...」，如果有副标题也逐字列出。
   • 明确标题排版：哪些词最大、如何换行、文字颜色、描边/阴影/底板、标题占画面比例、与主视觉的相对位置。
   • 明确限制模型不要添加任何未指定文字：不要额外汉字、英文字母、数字、logo、水印、签名、品牌名、乱码符号。
   • 不要列道具清单。除非用户明确指定，提示词只描述画面气质、版式和主视觉简洁度，让系统 Image Gen 自主选择具体元素。
   • 生成比例使用 3:4、4:3 或 1:1，按用户需求选择。

4. 生成完整封面图：

   • 直接让系统 Image Gen 生成包含标题文字、主视觉、背景气质和整体版式的完整发布图。
   • 系统 Image Gen 默认会把原始产物放在 $CODEX_HOME/generated_images/...。检查通过后，只把最终选中的原图复制到目标视频工程的 cover/ 子文件夹（见上文「输出位置」）；不要再复制一份内容相同的 candidate。无法判断工程时才回退到 douyin-covers/YYYY-MM-DD/generated/。
   • 最终图应来自系统 Image Gen 输出原图。不要用本地代码改尺寸、裁切、压缩、拼接、加字或修图。
   • 如果用户要求的精确像素尺寸与系统 Image Gen 返回尺寸不一致，优先保留系统 Image Gen 原图并说明实际尺寸；只有用户随后明确要求“只做尺寸转换”时，才可执行非创意的格式/尺寸转换，但仍不得改画面内容或文字。

5. 检查与重试：

   • 用 identify 或同类工具确认尺寸。
   • 用图片查看工具检查候选图，逐项核对：
     • 标题文字是否与用户给出的标题完全一致，包括中文、英文大小写、数字、标点。
     • 是否漏字、错字、变形、乱码，或添加了未指定的额外文字。
     • 80px 缩略图测试：缩到约 80px 宽（手机信息流缩略图尺寸）后，主标题还能读、只有一个锚点最先被看到、色块仍分明。
     • 主标题与背景对比度是否足够（参考阈值：主标题 vs 背景 ≥ 4.5:1，缩略图建议 ≥ 7:1）。
     • 标题是否压住人物脸部或主视觉。
     • 人物是否仍像泊舟 IP，画面是否简约大方、有点击理由。
     • 画面是否因为道具、图标、信息块或装饰过多而显得模板化。
   • 如果文字或构图有问题，不要直接交付。根据失败点重写提示词并重新调用系统 image_gen，例如“上一版把 MCP 写错/画面太乱/标题被主视觉抢走，这次只允许出现标题 X，减少元素，增加留白，强化标题层级”。通常先重试 1-3 次；如果连续失败，再把问题和候选图说明给用户。
   • 通过检查后直接以最终文件名复制进项目，例如 vibe-coding-newbie-cover-3x4.png。未通过的试稿不要复制进项目；用户明确要求看候选时例外。

6. 导出和回复：

   • 保存最终图到目标视频工程的 cover/ 子文件夹（见上文「输出位置」），无法判断工程时才回退到 douyin-covers/YYYY-MM-DD/generated/。
   • 最终图文件名包含标题 slug，例如 cover/harness-cover-AI客服退错旧卡-3x4.png。
   • 最终回复给用户本地路径，并用 Markdown 图片展示成图。