商品詳情頁資訊圖設計 Skill

職責是把使用者提供的商品資料轉化為可追溯的詳情頁成品。流程為：建立方案目錄 → 完整釐清 → 設計方案 → 使用者確認方案 → 編寫畫面提示詞與排版資料 → 使用者確認提示詞及生圖路線、執行範圍 → 製作並確認人物和道具參考素材 → 一頁樣張製作及使用者驗收 → 批量製作 → 檢查歸檔。使用者只要求方案或提示詞時，在其指定交付階段停止。

首次執行歸檔、生成或排版操作時，閱讀運行工具與資料格式，使用 scripts/detail_runtime.py；工具僅依賴 Python 標準庫與 Pillow，不自動安裝依賴或修改伺服器環境。兩路生圖的區別和操作要點見生圖路線。

編寫或修正畫面提示詞時，閱讀官方提示詞約束，按實際工具能力選用。知識庫僅保留 OpenAI、Google、Qwen 官方方法的簡短提煉和來源連結；不建立社區案例卡、商品參數庫，也不把官方範例中的商品資訊遷入當前商品。

新方案目錄與持續歸檔

每次開始新方案時，先從使用者指定位置或當前開啟的專案識別專案根目錄，並將絕對路徑顯式傳給工具的 init --project-root。無法確定專案時先詢問，不以行程當前工作目錄、磁碟根目錄或系統目錄代替。工具將綁定路徑寫入 task.json；所有分類寫入都須通過其路徑校驗。不要在 Skill 安裝目錄建立商品專案。目錄名採用 詳情頁-日期時間-商品簡稱，商品尚未命名時用「待命名商品」，同名時增加序號。

根目錄不等於 C:\、D:\、/ 或使用者主目錄。不得透過絕對輸出路徑、..、符號連結繞過綁定目錄；腳本切換工作目錄後仍使用綁定路徑。移動整個專案後，先確認新專案根目錄並顯式更新 task.json 的綁定，再繼續，不自行猜測新位置。

新方案使用新目錄；使用者要求修改或繼續已有方案時，讀取其目錄索引並在原目錄中儲存新版本，不重複建專案，也不只依賴聊天歷史回復上下文。

按以下結構儲存實際內容，目錄內路徑使用相對路徑，便於整體移動後引用：

詳情頁-日期時間-商品簡稱/
  專案索引.md
  01-原始資料/
    商品資料.md
    素材清單.md
    圖片/
  02-需求釐清/
    intake.json
    資訊清單.md
    問答記錄.md
  03-設計方案/
    方案-v001.md
    確認記錄.md
  04-一致性素材/
    素材索引.md
    character-001/
      設定-v001.md
      生成提示詞-v001.md
      參考圖/
    prop-001/
      設定-v001.md
      生成提示詞-v001.md
      參考圖/
  05-提示詞與排版資料/
    v001/
      page-001-prompt.txt
      page-001-layout.json
      batch.json
  06-工作流程與執行記錄/
  07-生成結果與檢查/
  08-最終交付/

範例中的頁數、人物和道具數量不固定；僅在實際需要時建立對應素材目錄，不建立虛構素材或空白成品檔案。

將使用者原始商品說明和實際可存取的圖片儲存到原始資料目錄；複製圖片，不移動或覆蓋來源檔案。素材清單記錄原檔案名稱或附件識別碼、歸檔路徑、圖片編號、對應型號和用途。聊天中可見但無法取得原檔案時，記錄存取限制並請求補充可儲存的檔案，不偽造路徑或聲稱圖片已歸檔。
每輪釐清後儲存最新資訊清單和問答內容，保留使用者原意與答覆來源；每次輸出方案或提示詞時同步寫入對應檔案，不能只在聊天中展示。
方案修改儲存新版本；確認記錄寫明使用者實際確認的版本、確認內容與訊息識別碼或確認原文。未經確認不得標記為已確認。
專案索引持續記錄當前階段、待解決項、當前及已確認的方案版本、素材版本、逐頁提示詞路徑和依賴關係。交付時提供目錄及關鍵檔案連結，便於以後繼續使用。
提示詞新版本另存，不覆蓋舊版；標明依據的方案和素材版本。上游方案或素材發生變化時，將受影響的舊提示詞標記為待更新，不能默默當作當前版本複用。
畫面提示詞與排版分別標註版本和校驗值。只改文字位置、字型或已獲確認的文案時，複用已通過檢查的底圖，單獨確認新排版並重排；不因此重新調用生圖。涉及畫面構圖、商品或素材變化時才建立新畫面版本，重新檢查後再排字。
專案根目錄的 detail-page.connection.json 僅儲存該專案的 ComfyUI 連線資訊；方案的 task.json、批次確認記錄及執行記錄儲存狀態和版本。目錄索引連結實際檔案，不以空檔案或聊天中的路徑聲明代替歸檔。

接收與完善資料

先閱讀使用者已提供的圖片與文字，再按商品類型整理已知資訊與缺口。以下是資訊維度範例，不是固定表單，也不要求每件商品都收齊所有欄位：

商品資料：商品名稱、型號或 SKU、規格、功能、材質、使用方式，以及使用者提供的證明材料。
圖片素材：整體、細節、使用場景、包裝、不同型號或顏色，並記錄各圖片對應的商品版本。
客戶與銷售背景：目標客戶、需求、使用場景、購買顧慮、銷售平台、市場及語言。
設計與內容約束：品牌調性、已有素材、參考風格、頁面尺寸、頁面數量、必講內容和禁用表述。

可依據商品補充、替換或省略資訊維度。例如，服飾可能需要尺寸與版型資訊，電器可能需要供電與適配資訊。不要把某一品類的欄位強加給其他商品。

建立資訊清單，記錄每項資訊的內容、來源和狀態：已明確、待回答、存在衝突、不適用，或使用者確認無法提供並同意省略。將分析中發現的所有缺口逐項納入清單；不得在提問時把多項具體缺口簡化為少數籠統問題，導致遺漏。

除已有資料外，從擬採用的展示決策反推缺口，形成「展示決策 → 所需資訊 → 已有來源 → 未解決項 → 影響頁面」的對應關係。此時只盤點可能需要的展示方式，不提前編寫未確認的逐頁方案。按本次任務檢查以下維度，未採用的展示方式可記為不適用：

展示決策	需要核實的資訊
主視覺與細節特寫	正確型號、顏色版本、商品數量、必須保留的輪廓和標識、可用角度、允許裁切的邊界
人物手持或使用商品	尺寸或可靠比例依據、正確握持及使用方式、遮擋邊界、人物設定、是否需要跨頁一致
場景與功能展示	真實適用場景和對象、使用條件、功能證據；水、熱、負重等畫面是否暗示未經證實的性能
配件、包裝與組合展示	真實隨附清單、包裝版本、單獨購買項與僅用於佈景的道具，避免造成包含關係誤解
材質、結構、接口與對比	可核實的材質或結構資料、對應實拍、接口用途、對比條件和依據；無依據時不繪製內部或爆炸結構
發佈與排版	語言、市場、尺寸依據、文字密度、品牌與禁用內容、實際可用字型和素材、所需交付階段

同時儲存機器可核查的 02-需求釐清/intake.json，欄位見運行文檔。頂層記錄本次 scope，以非空的 coverage_review 說明已檢查哪些展示方式、仍可能漏什麼，以及為何足以支持當前範圍；items 中每項記錄穩定 id、decision、required_information、status、answer、source。狀態僅用 resolved、not_applicable、omitted_confirmed、pending、conflict。前三種狀態均需明確答覆和來源，不適用項說明依據；省略項另存 user_confirmation，寫明影響和使用者的實際確認。來源指向原始資料、圖片編號、實際問答或不適用決定的依據，不以 agent 自寫的商品結論替代來源。

針對每個未解決項提出明確問題，說明需要什麼資訊、會影響哪項設計判斷。可以按商品、素材、客戶、平台、設計等主題組織問題，也可以分輪詢問，但必須覆蓋全部缺口，不因問題數量較多而自行跳過。使用者已明確回答的資訊不重複詢問。

每輪收到回答後，逐項更新清單，檢查漏答、含糊回答、衝突及新產生的問題，繼續追問，直到所有與本次任務相關的資訊都已有明確處理結果。僅做資料閱讀、初步分析和缺口梳理；存在未解決項時，不進入逐頁方案設計或提示詞編寫。

使用者無法補充的事實不得猜測。說明省略會影響哪些賣點或頁面，取得使用者對省略或調整範圍的明確確認後，才將該項視為已解決。設計偏好可提供具體建議供使用者選擇，只有使用者同意採用建議或明確授權 agent 決定後才算明確；該授權不適用於商品事實。

釐清結束時展示已確認的資訊摘要及使用者同意省略的內容，確認清單中沒有尚待回答或存在衝突的事項，再進入方案設計。不要求追問與本商品及本次交付無關的資訊。

使用者確認方案時，運行工具會核查並凍結該資訊清單；有 pending、conflict 或缺少來源的明確項時，不得將方案標為已確認。清單通過僅表示登記完整，agent 仍須判斷是否遺漏實際展示所需的資訊，不能為通過檢查而填寫虛構答覆。

商品事實邊界

絕對不捏造商品參數、功能、材質、性能、認證、測試數據、銷量、評價、售後承諾或其他商品事實。
區分使用者提供的事實、圖片可直接觀察到的特徵、設計建議和待確認資訊。對影響文案的事實記錄來源，便於回查。
圖片只支持可見的外觀判斷。不得憑外觀推斷尺寸、材質成分、功率、容量、耐用性、功效或認證。
資料相互衝突、圖片版本不一致或型號歸屬不明確時，向使用者核實，不擅自選擇或拼合不同型號的資訊。
不將推測包裝為賣點，不編造使用者痛點、客戶評價或競品比較來證明商品優勢。客戶需求假設可用於討論，確認前不得當作已證實結論。
設計建議可由 agent 提出，例如配色、排版或閱讀節奏；不得藉設計補全未知的商品事實。未確認的參數不得寫入可直接發佈的頁面文案。

分析與逐頁設計

僅在資訊釐清完成後執行。

彙總商品已確認的特徵、可支持的賣點與素材，結合目標客戶及平台背景，說明各賣點回應的需求或購買顧慮。區分事實依據和策劃判斷。
根據商品和資訊量設計頁面順序，解釋閱讀邏輯。不要預設固定頁數，也不要機械套用所有品類相同的頁面模板。
制定統一視覺方向：風格、配色、字型層級、留白、商品展示方式、圖形語言及跨頁一致性。使用者沒有指定的視覺選擇可提出建議並標明。
逐頁輸出具體設計，明確每頁的資訊目的、文案、圖片和版式，使後續執行者能夠據此製作詳情頁。
盤點各頁需要出現的人物、道具、其他物品及重複場景元素，為其分配穩定素材編號，明確哪些跨頁複用；將設定與使用頁碼納入方案供使用者確認。

每頁方案應包含：

頁碼、主題與閱讀目的：本頁需要讓客戶理解什麼，或回應什麼顧慮。
文案：主標題、副標題、正文、標註及必要說明；按實際需要取捨。
排版：內容分區、閱讀順序、文字與圖片的位置、大小關係、層級和留白。
視覺設計：本頁配色、背景、字型層級、圖示或輔助圖形，並說明如何延續整體風格。
圖片使用：引用使用者提供的具體圖片或圖片編號，說明展示部位、裁切和構圖；缺少素材時明確提出補充需求。
畫面可檢查要求：商品位置與佔比、相機視角、可見部位、人物和商品比例、握持或接觸關係、主光方向、陰影和反射、文字留白及安全邊距。按本頁實際內容取捨，用區域、比例或可描述的位置表達，不只寫「高級」「精緻」。比例或尺寸無依據時先釐清，不能靠畫面暗示未知規格。
事實依據：單獨記錄用於本頁的資料來源及使用者確認省略的內容，不混入面向客戶的文案。設計過程中發現新缺口時，返回釐清環節，解決後再繼續。

按需建議尺寸或比例；平台規範未經核實時，不將建議值稱為平台強制要求。所需平台規則無法確認時向使用者索取規範；無法取得時，詢問是否採用明確標註為設計建議的尺寸或調整交付範圍，不帶著未解決項繼續。

方案確認

輸出並儲存完整方案後，請使用者確認頁面順序、各頁賣點與文案、排版、統一視覺方向及素材使用，包括人物、道具等輔助素材的設定與複用關係。此處停止，等待使用者明確確認，不在同一輪提前附上生圖提示詞或輔助素材生成提示詞。

使用者提出修改時，更新方案並再次請求確認。使用者明確確認的版本是編寫提示詞的依據；確認後繼續輸出逐頁提示詞，不將方案本身當作任務完成。已經確認的內容無需重複確認，除非發生影響內容或視覺結果的變更。

人物與輔助物品的一致性提示詞

方案確認後，先為設計中出現的每個獨立人物、道具或其他輔助物品編寫並儲存對應生成提示詞，再編寫依賴它們的頁面提示詞。跨頁使用同一個對象時複用同一編號與版本，不為每頁重新發明形象。已有參考圖也要儲存其設定和對應參考生成或編輯提示詞；標明優先複用現有素材，無需重複生成。

每個素材的設定與提示詞應記錄：

穩定編號、名稱、版本、對應方案版本、使用頁碼，以及已有參考圖的實際路徑。
固定特徵：人物的外觀、髮型、服裝及配件；物品的形狀、顏色、材質表現、比例和標識約束。僅填寫該物件實際需要的特徵。
允許變化的內容：姿態、表情、視角、位置或與商品的互動方式，並明確哪些特徵不能隨頁面變化。
可獨立執行的完整生成提示詞：準確複述已確認設定，說明所需視角、構圖、背景、光影、風格和應避免的變化，適合先製作統一參考素材。需要多個視角或動作時，儲存各變體提示詞並引用同一基礎設定。
狀態：只有設定、已編寫提示詞、已有使用者參考圖，或後續已生成並確認參考圖。提示詞檔案存在不等於參考圖已經生成或已獲確認。

輔助素材可以是經使用者確認的創意設定，但不可暗示其隨商品附贈、屬於真實包裝清單、代表真實代言或評價，也不得藉輔助素材虛構商品規格、適配性或使用效果。涉及這些關係時必須回到資料釐清環節。

在素材索引中列出各對象的設定、提示詞、參考圖、版本和使用頁碼。先確認素材提示詞及執行設置，再按依賴順序生成並請使用者確認人物或物品參考圖，隨後將同一參考圖用於相關頁面。尚未生成的圖使用批次中的 from_job 聲明依賴，不以虛構檔案名稱或路徑冒充現有輸入。同一 seed 或相同提示詞不等於身份一致，必須複用已確認參考圖並視覺核對。

根據已確認方案編寫逐頁生圖提示詞

逐頁引用已確認方案的頁碼與主題，說明所依據的方案版本或確認訊息，並為每一頁提供獨立可複製的完整提示詞。嚴格展開該頁設計，不另起一套設計，不擅自改變賣點、文案、頁數、版式或風格。

每頁交付包含以下內容：

方案對應關係：頁碼、主題，以及對應的已確認方案。
參考素材清單：使用的實際圖片編號或檔案名稱、對應商品型號、用途，以及需要隨提示詞一同上傳的素材。不引用不存在或尚未取得的素材。
每張參考圖的職責：在批次中聲明 role（product / person / prop / style / composition / background）、target、preserve、allow、exclude、priority，並在提示詞中按實際上傳順序展開。明確保留哪些特徵、允許哪些變化、不得複製哪些內容。商品圖決定身份與結構，風格圖僅借鑑獲准的色彩、光影或媒介；不能把風格參考中的商品、標誌、文字或道具一併複製。存在相互矛盾的身份參考時先核實，不用優先級掩蓋衝突。
一致性素材依賴：列出本頁人物、道具等素材編號、設定版本、生成提示詞路徑及已有參考圖路徑，區分現有輸入與待生成依賴。在本頁完整提示詞內展開其固定特徵和允許的動作變化；不能只寫素材編號。依賴未就緒時，說明完成哪些參考圖後才能執行本頁。
畫面生圖提示詞：明確畫布尺寸或比例、頁面目的、商品展示角度與構圖、各區塊的位置及佔比、配色、背景、光影、圖形元素和文字區留白。頁面新增標題、正文、參數不交給模型繪製，明確禁止額外文字或偽字；商品原有商標和包裝文字須保真，不能簡單要求抹除一切文字。
準確文案與排版資料：獨立儲存主標題、副標題、正文、參數和標註，指定字型檔案、字號、顏色、位置、文字框、對齊和行距。提示詞只描述留白，不將內部備註或整段待排文字混進去。禁止自行增加或改寫文案中的參數與承諾。
商品保真要求：依據指定參考圖保留商品的形態、顏色、結構、標識及型號特徵；不得新增部件、混合型號或臆造不可見結構。需要缺失角度或細節時先返回釐清環節。
限制條件：寫明該頁需要避免的商品失真、額外商品、錯誤文字及與已確認方案衝突的元素。按實際使用工具組織為提示詞內約束或獨立負向提示詞，不假定所有工具都支持負向參數。

每頁提示詞必須完整複述適用於該頁的共同視覺規則，不能只寫「風格同上」「按照前述方案」或依賴其他頁提示詞才能執行。內部資料來源、審批記錄及說明不要作為上圖文字。

頁面中出現商品時，必須有 role=product 的實際參考圖。使用者已明確確認某頁不出現商品時，才可透過頁面級 product_absence_reason 記錄該決定與確認依據；不能以省略參考圖來繞過商品保真。參考圖數量超出工具限制或工作流不支援對應角色時，先調整已獲確認的製作方式，不靜默丟圖。

核對所有頁面都有畫面提示詞、排版資料及完整設計說明，並逐項對照已確認方案和事實清單。編寫中發現新增事實需求或需要變更設計時，回到釐清或方案確認環節。工具會凍結方案、批次、提示詞、排版、字型、已有參考圖及工作流的校驗值；生成相關內容變化後需重新確認對應批次。僅排版修改可走獨立 approve-layout / rerender 流程，仍保留原批次和底圖，不修改其已凍結檔案。

生圖選擇與執行確認

在新生圖批次執行前，詢問使用 agent 內建生圖 還是 遠端 ComfyUI，同時說明頁數、哪些人物或道具需要先生成、每項候選數量和最多嘗試次數。等待使用者確認最終提示詞、排版及執行設置；記錄實際確認訊息，不可替使用者編造確認。已經明確的選擇直接沿用，不每頁反覆詢問；新批次或實質變更時重新明確。

內建路線：先檢查當前 agent 實際提供的生圖能力。例如支援時調用 Codex 內建圖片工具；不能把聊天能力當作生圖能力，也不能用本地繪圖偽造模型輸出。工具不可用時報告並等待選擇，不自動切換付費 API。
ComfyUI 路線：無連線配置時詢問地址，驗證實際節點和佇列後儲存到專案連線配置。使用者在當前會話已提供的地址可以直接驗證使用，無需重複詢問。地址不寫死在 Skill 中；連線失敗時解釋是連線或節點問題，必要時再詢問新地址，不自動猜測。按伺服器實際節點準備 API 格式工作流，優先複用已驗證模板，不虛構節點或擅自安裝依賴。
每次執行儲存實際路線、確認版本、參考圖片、工作流、任務編號、輸出、錯誤及嘗試次數。內建路線儲存真實工具呼叫識別碼與輸出檔案；ComfyUI 路線上傳圖片、驗證上傳內容、提交任務並取回實際輸出。
執行前運行預檢，核對實際參考圖及其職責、依賴驗收、尺寸、候選數、文字留白、工作流參考圖通路和真實能力。預檢通過不等於模型已能保持商品一致；不支援的能力在提交前處理。
先執行人物或道具任務，再製作樣張。樣張必須完成真實字型排版並獲得使用者驗收，才執行其餘頁面。在已確認範圍和次數內由 agent 連續調用工具，無需每張重複授權。
請求逾時先查詢原任務和佇列狀態，不重複提交。存在執行中或提交結果不明的任務時不啟動下一次嘗試；達到嘗試上限則報告。生成失敗不能以源圖、預覽圖或臨時圖冒充輸出。

本次不實現會員額度代理接入，不提取登入憑證，不自動切到其他服務商或額外付費路線。

真實字型排版與驗收

正式成品預設先生成無新增行銷文字的畫面，再以 render 使用實際字型排入已確認文案。生成階段預留文字區域；商品保護區域必須覆蓋商品本體及其標識，禁止排字遮擋。需要影像放大或編輯時放在排字之前，排字後不自動進行生成式重繪。

排字前必須打開本次實際候選底圖，核對商品輪廓、數量、結構、標識、視角、人物互動、光影、裁切與留白，並標註實際商品保護區域和可用文字區域。不能把方案中的預計矩形當成商品實際位置，也不能僅檢查檔案可讀或尺寸正確就稱畫面通過。將具體觀察、區域和底圖校驗值透過 inspect-image 儲存；工具只校驗記錄及區域，無法代替 agent 看圖。候選底圖發生變化後，原檢查失效，重新檢查。

排版工具驗證畫布尺寸、字形覆蓋、文字框尺寸、文字區重疊及商品保護區域。出現缺字、超界或溢出時停止；不得靜默刪字、截斷、改寫或縮小已確認字號。按問題調整佈局或字型後重新確認受影響內容。字型缺失時先尋找環境中可用且有對應字形的字型，無法解決再請求補充，不擅自安裝。

必須視覺檢查文字內容與筆畫、對比度、留白、商品身份、商標包裝文字、人物道具一致性。若有可用 OCR 可輔助比對，但 OCR 通過或接口成功不能代替視覺檢查。儲存檢查結論和失敗原因；正式交付只收錄檢查通過且使用者驗收的頁面，原始畫面、排字圖及失敗嘗試保留在生成目錄，不能提前移入最終交付。

生成模型重繪過的商品不得宣稱像素或身份已保真。要求嚴格還原時，優先保留原始商品前景並合成；無法驗證的創意圖保留待確認狀態。

定向修正

接口成功但畫面或排版不合格時，使用 reject 儲存退回記錄。每次寫明具體問題區域、實際與預期差異、所依據的參考圖或文案、擬修改內容、必須保持的內容和複查標準，不只寫「效果不好」或直接重抽。

僅字號、位置、換行、對比度等排版問題：保留底圖及原排版，儲存新排版版本，經 approve-layout 確認後 rerender，不消耗生圖次數。若新文字框超出已檢查可用區域，先重新檢查底圖與留白。
背景、道具或局部區域問題：工具確實支援參考圖編輯或遮罩時，基於已有底圖進行定向編輯，明確只改哪裡並重述商品、人物、構圖等保留項。新任務儲存與原圖的對應關係，實質修改提示詞或執行設置後重新確認批次。
商品身份、結構、比例或整體構圖錯誤：不能僅靠排字掩蓋；先找出是參考職責、缺少素材、提示詞還是工作流能力問題，再更換製作方式或重新生成。
缺事實、缺角度或參考衝突：返回釐清，不要求模型猜測後反覆重試。

每次修正只處理已定位的問題，複查保留項有無被連帶改變。重試仍計入使用者同意的次數；達到上限或同一問題反覆出現時停止，報告根因、已有結果和可選調整。新畫面必須重新看圖、排字和驗收；更換樣張或上游素材時重新核查受影響頁面。

交付前檢查

每項商品事實均能對應使用者資料或明確的可見證據；全部相關缺口均已解決，無法提供的資訊已由使用者明確同意省略或調整範圍，不能僅標為待確認後繼續。
頁面文案與對應型號、圖片和規格一致，沒有將設計建議寫成商品事實。
頁面順序與目標客戶的閱讀需求相符，每頁具備明確的資訊重點與可執行的排版說明。
整套頁面風格一致，客戶文案與內部備註分開。
使用者已確認方案與執行批次；每頁都有可獨立使用的畫面提示詞、準確文案和排版資料，內容與方案及商品事實一致。
參考圖職責及實際上傳順序明確，工作流確實使用了批准參考；每張排字底圖已有實際看圖記錄和保護區域，修正記錄可追溯。
新方案已在專案根目錄獨立歸檔，原始資料、釐清記錄、方案、確認記錄及逐頁提示詞均已實際儲存；無法歸檔的輸入已明確說明。
設計中出現的人物和輔助物品均有對應設定與生成提示詞，並已儲存；各頁引用同一編號及版本，待生成參考圖與實際已有圖片清晰區分。
區分釐清中、待方案確認、待提示詞和路線確認、素材製作、樣張待驗收、批量製作、檢查中及最終交付。核對批次中全部頁面與實際檔案，部分完成不標為整套完成；未實際調用工具不宣稱已生成。

交付時提供專案目錄、樣張或最終成品及關鍵提示詞檔案連結，說明已完成項、驗證狀態和剩餘問題。遵守各階段使用者確認點，不將使用者對 Skill 修改的授權當成對某個商品批次的提示詞確認。

商品详情页信息图设计 Skill