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 需要用戶或獨立複核者確認。交付時明確目前只到工程驗證、真實成圖驗證、用戶驗收還是平台後台驗證。