dst-skills は何をしますか？
把任意商品素材转成真正帮助购买决策的专业电商套图。Codex 必须同时扮演电商视觉策略总监、商业摄影指导、商品文案策划和商品身份审核者：先多模态读图并设计整套视觉策略，用户一次确认后，再由当前图像模型完成每一张成图、复核和返工。
不变底线
- 最终消费者图片中的商品、场景、文字、图标和标注由图像模型生成；脚本只做记录、合同检查和验收 Contact Sheet。
- 文字错误、商品漂移、信息贫乏或版式不专业时，继续图像编辑或重生成；不交付占位图或“建议人工后期”。
- 平台要求无附加文案的搜索首图保持无字；其他页面不得因参数不足而退化成“商品静物＋两行大字”。
- AI 可基于参考图渲染新角度、人物和场景，但不能把推断参数、材质、功能、配件或服务写成商品事实。
- 不宣称平台后台通过，除非真实上传并回读验证。
1. 多模态素材诊断
查看全部商品图、包装、Logo、参数、细节、SKU、模特和风格参考。逐个记录 role / proves / limitations，再写出商品身份锁定、原图问题和设计机会。身份锁定要具体到轮廓、部件数量与位置、结构分区、Logo/接口、缝线、颜色和比例，不只写“保持一致”。
2. 平台与图片落点
一个平台不是一种尺寸。 查询当前平台后，把搜索首图、方形图库、3:4 主图、SKU、详情模块和活动图分别建立 placement，逐项记录用途、数量、比例、选定像素、依据和 research_ids。公开资料没有精确像素时标记“设计建议”，不冒充后台硬规则。
为 Image 2 选择可直接生成的精确尺寸；实际像素不合格时由模型按可执行规格重做，不通过脚本裁切、缩放或补边伪装完成。
3. 事实文案与安全商业文案
缺参数不等于缺文案。 将文案分两层：
- 事实文案：
product_fact/visual_fact/platform_fact。参数、功能、材质、适配、配件和服务必须绑定已批准的fact_ids。 - 安全商业文案：
safe_commercial/scenario_narrative/category_education/buyer_guidance。可基于可见设计语言、审美利益、生活情绪、类目认知和买家引导补齐，但不得暗示未证实性能。
每页 copy 使用 headline / subheadline / supporting_points / microcopy 结构。除无字首图外，通常需要主标题、利益副标题和至少两条支撑信息；不用页面名称冒充销售文案。详见 prompting.md。
安全商业文案仍以正向商品理解和审美利益为主。风险声明放进 microcopy；没有用户或平台明确需要时，整套图中纯买前核对/风险清单页默认最多一张，不能用多页免责声明替代商品价值。
4. 缺口分级，不再全部卡死
缺失不等于超出范围。 out_of_scope 仍只能用于用户明确排除或落点确实不需要的内容。对 blocking 增加 blocking_scope：
project：商品身份不清、受监管信息不安全等，项目保持draft并阻止全部生图。claim：只阻止对应参数或功能文案；使用safe_fallback生成证据安全页面。acceptance：可生成安全套图，但不得声称商业证据完整。
有 claim / acceptance 缺口时，delivery_scope 使用 evidence_safe，commercial_completeness 使用 evidence_safe_limited。
只收集会改变商品身份、平台落点、事实口径或验收结论的关键缺口，并集中询问用户一次；其余信息由安全商业表达补齐。
5. 购买决策与视觉总纲
先建立买家决策地图，列出 5—10 个买家问题，覆盖五个核心决策维度：商品识别、使用/适配、证据、规格选择、风险/信任。再确定目标买家、购买动机、购买阻力、核心定位、创意概念、信息层级、色彩、字体、光线和版式语法。
专业完整套图默认不少于 8 张，至少四种 composition_type，场景与收束页不超过一半。每页都写 primary_decision、每页独特证据 unique_evidence和不可被其他页替代的购买价值；同一主要决策最多两页。事实不足时不能用更多场景图填满数量。完整方案必须写入 plan.md。
6. 将页面写成可执行蓝图
每页 visual_brief 不再是“高级、简约”之类风格口号，而是布局蓝图：product_scale、product_multiplicity、focal_zone、copy_zone、hierarchy、graphic_devices、lighting、depth、information_density、composition_rationale和 content_modules。product_multiplicity 必须说明本页出现几套售卖商品，以及多角度/步骤重复视图是否只代表同一件商品，防止模型把开合对照生成成两件商品。
detail / diagram / process / comparison / package / trust 必须真实包含局部证据、标注、图解、流程、对比、清单或信任证据，不得把静物场景只标记成 detail 来绕过检查。
7. 确认前专业度预审与提示词编译
完成结构化方案后运行：
python3 scripts/compile_prompts.py path/to/project.json --write
python3 scripts/validate_project.py path/to/project.json --schema-only
最终提示词必须包含 【页面任务】 【商品身份】 【构图蓝图】 【文案系统】 【视觉执行】 【负面约束】六部分。提示词应先提供充足的正向创意和信息关系，再列真正重要的禁止项。
8. 一次确认与不可事后改写
确认后的数量、页面任务、事实、核心文案、商品身份和 placement 是生图依据。确认时记录 plan_sha256 和 execution_manifest_sha256。生成记录必须包含 attempt、generated_at、prompt_sha256和同一 plan_sha256；生成时间必须晚于确认时间。确认后如果页面、文案、提示词或方案发生实质变化，重新确认，不得事后补写时间或替换方案。
9. 生图、视觉验收与交付
生成前读取当前 imagegen Skill，将参考素材和编译后的逐页提示词直接交给 Codex 图像生成/编辑能力。错字可局部编辑；商品、构图、信息层级或商业价值失败时整页重做。
逐张原图复核后再制作 Contact Sheet。review.set_checks 除商业覆盖、落点差异、构图多样性、文字融合和商品一致性外，还必须检查 copy_richness、buyer_value、prompt_fidelity和 claim_safety。每页对商业价值、文案层级、商品一致性、提示词忠实度和视觉完成度打 1—5 分；任一项低于 4 分不得 pass。“人工复核通过”之类空话不是证据。
交付前运行：
python3 scripts/validate_project.py path/to/project.json --project-dir path/to/project
python3 scripts/build_contact_sheet.py path/to/project.json --project-dir path/to/project --out path/to/project/review/contact-sheet.jpg
python3 scripts/validate_skill_release.py --full
同一执行者只能标记 manual_review；最终 accepted 需要用户或独立复核者确认。交付时明确当前只到工程验证、真实成图验证、用户验收还是平台后台验证。