电商发布质检与导出
先质检,后导出。确定性规则交给脚本,语义、视觉和商业表达由当前 Agent 复核。
选项处理
- 优先从
strategy.json读取站点、国家和语言;用户已指定的导出格式或模板直接采用。 - 用户只要求质检时,仅生成报告,不询问导出选项。
- 用户要求正式刊登文件但缺少会改变字段映射的信息时,调用结构化选择控件。Codex 使用
request_user_input;其他 Agent 使用等价选项工具。不得在普通消息中列出编号选项。 - 每次显示 1 至 3 题,每题 2 至 3 个互斥选项;推荐项排第一,使用
export_template、category_mapping、image_url_mode等稳定 ID,不设置自动超时。 - 正式刊登需要图片 URL 时,优先使用用户提供的永久 CDN URL。只有本地图片且用户只是内部审阅时允许导出本地路径;正式发布前使用结构化控件选择“补充永久 URL”“仅导出内部审阅版”或“暂不导出”。
- 当前环境没有结构化选择控件时停止正式导出,并提示切换到支持结构化输入的交互模式;不要退化为文本问卷。
- 不重复询问
listing.json、strategy.json或用户消息中已有的信息。
质检
从任意目录运行,并把参数指向同一工作目录:
python "<本 Skill 目录>/scripts/validate.py" --listing "<工作目录>/listing.json" --copy "<工作目录>/copy.json" --jobs "<工作目录>/image_jobs.json" --images "<工作目录>/final_images" --site amazon-US --json --out "<工作目录>/quality-report.json"
检查以下内容:
- 标题、五点描述、长描述和搜索词的站点限制。
- 禁用词、绝对化承诺和不允许的全大写格式。
- 待确认事实是否泄漏到公开文案、底图提示词或图上文字。
- 图文中的数值、单位、兼容范围和卖点命名是否一致。
- 成品数量是否达到策略要求,文件是否与工单一一对应。
- 图片格式、文件大小、长边像素、宽高比和白底主图。
- 主图、两张代表性信息图和所有失败项的视觉检查。
block 必须修复;warn 要么修复,要么在报告中说明接受理由。修复事实或文案后,从最早受影响的 Skill 续跑,不绕过阻断项导出。
导出
质检报告的 blocking 为 0 后运行:
python "<本 Skill 目录>/scripts/export_csv.py" --copy "<工作目录>/copy.json" --site amazon-US --images "<工作目录>/final_images" --base-url https://cdn.example.com/SKU-001 --quality "<工作目录>/quality-report.json" --out "<工作目录>/listing_export.csv"
如果已有永久图片 URL JSON,可把 --images 指向该 JSON 并省略 --base-url。导出结果包括 listing_export.csv 和 export_manifest.json。
交付
报告站点、阻断数、警告数、图片数量、CSV 路径和仍需人工处理的发布项。只有在脚本无阻断且视觉抽检完成后,才能说明“可发布”;本地图片路径或临时 URL 不得描述为正式刊登就绪。
所有报告和导出文件都写入用户的工作目录,不要写入 Skill 安装目录;<本 Skill 目录> 指当前 SKILL.md 所在目录。