DetailFlow

DetailFlow 是一个用于规划、生成、审核和交付电商详情页的 Codex Skill。

用户只需要提供产品图和风格参考图，DetailFlow 会先规划整套详情页，经过确认后再建立视觉母版、生成分屏、拼接检查并针对问题进行局部返修。它默认面向 8 屏长图电商详情页，也可以适配其他产品页、功能页和长滚动销售页面。

核心能力

• 分析产品图与风格参考图
• 区分已确认信息、图片可见事实和 AI 推断
• 先输出 8 屏内容与视觉规划，再开始生成
• 使用首屏卖点种子维持整套页面的叙事关系
• 避免 8 屏重复使用“标题 + 副标题”的相同结构
• 建立文字视觉母版和可选的 1:3 图像母版
• 默认生成独立的 9:21 详情页分屏
• 在前 2 至 3 屏阶段提前拼接检查
• 检查产品漂移、文字混乱和未经确认的参数
• 根据问题定位最小返修范围
• 自动整理单屏、母版、预览图和完整长图

使用方式

最简单的请求：

图1是产品图，图2是风格参考。
请为这个产品生成一套8屏电商详情页。

也可以补充产品信息：

产品名称：SonicAir H7 Pro
核心卖点：长续航、舒适包耳、蓝牙5.3、折叠收纳
目标人群：通勤和日常娱乐用户
禁止出现：主动降噪、防水、未经确认的认证

如果没有提供卖点或参数，DetailFlow 可以根据产品图片和品类进行合理推断，但会提醒用户在商业使用前复核这些内容。

工作流程

1. 分析输入
   识别产品外观、结构、品牌元素、参考图的色彩、光线、人物和构图语言。

2. 确认产品信息
   邀请用户补充卖点、参数、受众和禁止使用的宣传内容。

3. 输出页面规划
   先生成每屏的消费者问题、页面任务、文案结构、视觉模块、内容密度和衔接方式。

4. 用户确认
   用户确认或修改规划后，才进入图像生成阶段。

5. 建立视觉母版
   锁定配色、光线、产品规则、字体层级、叙事节奏与连续视觉元素。

6. 生成前 2 至 3 屏
   拼接预览并检查产品还原、参考风格、文案差异和页面统一性。

7. 生成剩余分屏
   保持同一视觉系统，同时让不同屏幕承担不同的信息任务。

8. 最终审核
   检查产品漂移、文字错误、参数编造、重复版式和叙事断裂。

9. 局部返修与交付
   仅修改受影响的文案、产品、单屏或相邻屏幕，并输出最终文件夹路径。

安装

让 Codex 安装

向 Codex 提出：

请从 https://github.com/AJbeckliy/detail-flow 安装这个 Skill。

手动安装

Windows PowerShell：

git clone https://github.com/AJbeckliy/detail-flow.git "$env:USERPROFILE\.codex\skills\detail-flow"

macOS / Linux：

git clone https://github.com/AJbeckliy/detail-flow.git ~/.codex/skills/detail-flow

安装后可以通过 $detail-flow 显式调用，也可以直接提出电商详情页相关需求触发它。

文件结构

detail-flow/
├── SKILL.md
├── agents/
│   └── openai.yaml
└── references/
    └── detail-page-patterns.md

• SKILL.md：核心工作流程和执行规则
• agents/openai.yaml：Skill 的显示名称、简介和默认提示
• references/detail-page-patterns.md：详情页结构、文案模式、审核标准和返修策略

设计原则

• 详情页是一条完整购买叙事，不是 8 张独立海报。
• 后续屏幕应展开首屏卖点，而不是不断加入无关的新卖点。
• 不要求所有屏幕权重相同，应有强弱、疏密和节奏变化。
• 产品图是身份基准，不能随意改变颜色、结构、Logo 或佩戴方向。
• 对无法确认的参数、认证、奖项、功效和促销信息保持克制。
• 图像模型无法保证一次生成完全正确，审核和局部返修是正式流程的一部分。

当前限制

• 图像模型可能产生产品结构或文字细节漂移，需要人工审核。
• 1:3 母版用于统一视觉和叙事，不应直接裁切为最终分屏。
• 独立生成的分屏无法保证像同一张照片一样完全无缝连接。
• 医疗、功效、认证和精确参数必须由用户提供可靠信息。

Repository

https://github.com/AJbeckliy/detail-flow