Communitygithub.com

HXZ09845/電子商務SKU技能建構器

將電子商務商品簡報、賣點與參考素材轉化為經過驗證的AI影片生成SKU技能套件的代理技能系統。

電子商務SKU技能建構器 是什麼?

此技能是一個專門用於建構電子商務商品/SKU影片生成技能的代理技能。它不僅僅是編寫提示詞,而是引導使用者從商品理解、賣點驗證、素材映射、標準套件草稿、驗證到錯誤案例回歸的完整工作流程。其核心產出是一個可發布的Codex技能套件,包含結構化的SKILL.md、參考文件與驗證腳本。技能支援三種工作模式:新建SKU技能、更新現有SKU技能、以及針對錯誤案例進行修補。它強制遵循「後設技能獨立性規則」,確保生成的SKU技能套件在移交後可獨立運作,不依賴於此建構器、其他類別技能或外部檔案。技能內建了品質閘門(Quality Gates),涵蓋從輸入資料、賣點驗證、素材資產、影音同步、提示詞撰寫到最終移交的每個關鍵環節,並包含針對不同商品類型(如大型固定A+B、小型可動A+B、純A不變形/穿戴式)的原型分類邏輯。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add HXZ09845/ecommerce-sku-skill-builder

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

SKU 技能建構器

使用此技能作為新的電子商務產品/SKU 影片生成技能的行業通用建構器。它不僅僅是編寫提示詞。它引導建構者從產品理解、賣點驗證、素材映射、標準套件草稿、驗證到錯誤案例回歸的完整流程。

當前階段的重點:紮實地建構具體的產品 SKU 技能。當有足夠多合格的具體 SKU 技能時,同樣的工作流程也可以用於生成抽象的類別技能,但這些抽象的類別技能仍然是為了協助建立未來的具體產品 SKU 技能。除非建構者明確要求,否則不要將類別抽象化視為主要任務。

預設輸出是一個可發布的 Codex 技能套件:

skill-name/
  SKILL.md
  agents/openai.yaml
  references/
    product-rules.md
    core-asset-layer.md
    audio-visual-sync.md
    asset-manifest.md
    prompt-plan-format.md
    gotchas.md
    trigger-tests.md
    quickstart.md
  scripts/
    validate_*.py
  assets/

不要將舊的三檔案套件作為主要交付物。如果要轉換較舊的 Cursor 時代的素材,請將它們保留為來源輸入,並建立標準的 Codex 套件作為標準化輸出。

此建構器也包含純後設參考,例如 references/golden-case-abstractions.md;在建構目標 SKU 技能時使用它們。它們是自包含的抽象,不依賴於其他技能。

生成的產品 SKU 技能必須是自包含的移交套件。目標 SKU 套件不得依賴於此建構器、類別後設技能、黃金案例技能、本地來源資料夾或任何外部技能才能運作。執行階段所需的每條規則都必須寫入目標套件自身的 SKILL.md、references/、scripts/ 或 assets/ 中。

後設技能到 SKU 的獨立性規則

此後設技能僅是一個建構階段的建構器。它必須能夠從此套件自身的檔案中使用。

由此後設技能生成或更新的任何具體 SKU 技能在移交後必須能夠獨立執行。生成的 SKU 技能不得要求使用者閱讀此後設技能、類別後設技能、黃金案例技能、舊 SKU 套件、外部協作文件、記憶體或本機絕對路徑。

外部素材(例如產品簡報、賣點表格、實拍素材、舊 SKU 套件、外部協作文件、類別後設技能、案例影片、螢幕截圖或記憶體)僅可在建立過程中使用作為當前執行的輸入。從中學到的任何有用的規則都必須複製、改寫或總結到生成的 SKU 技能自身的 SKILL.md、references/、scripts/、assets/ 或 asset-manifest.md 中。

執行階段所需的確認過的實拍素材應標準化到生成的 SKU 技能的 assets/ 目錄中,並記錄在 references/asset-manifest.md 中,包含語義角色、產品狀態、批准狀態和參考邊界。僅保留未經批准、尺寸過大或未解決的素材版本為 pending;不要將必要的執行階段素材遺留在外部資料夾中。

工作模式

  1. 新建 SKU 技能建立:使用從產品理解到狀態矩陣、原型、賣點驗證、素材策略、套件草稿、代表性驗證和錯誤案例路由的完整工作流程。
  2. 現有 SKU 技能更新:從報告的問題、變更的來源或錯誤案例開始。識別受影響的檔案,修補最小的必要規則/素材/驗證器表面,然後執行自包含的稽核和代表性驗證。
  3. 錯誤案例修補:將失敗路由到產品規則、素材清單、注意事項、驗證器或觸發測試。除非問題揭示了結構性差距,否則不要重寫整個技能。
  4. 生產批次:僅在 SKU 技能通過代表性驗證後,或當建構者明確要求在已知待處理風險下進行批次處理時,才允許執行。

運作契約

  1. 載入此技能後,使用固定的初學者安全輸入引導建構者。不要說「提供任何一項」或直接跳到最終技能編寫。使用指定的輸入欄位,解釋下一個輸出,並允許將缺失項目標記為 pending。
  2. 從來源確認開始。首先讀取此套件的內部規則。然後讀取建構者提供或批准的當前執行輸入,例如類別後設、舊 SKU 參考、外部協作文件、案例影片、螢幕截圖或素材資料夾。
  3. 如果類別後設或舊 SKU 參考缺失或薄弱,則繼續使用此套件的行業規則加上內建的黃金案例抽象;不要因缺乏外部來源而阻塞。
  4. 首先理解產品。除非建構者明確提供所有內容,否則不要在首輪要求完整的已批准素材庫或編寫最終規則。
  5. 在詳細規則編寫之前,確認產品結構和狀態矩陣。
  6. 在提示詞編寫之前,將產品分類為一個生產原型:大型固定 A+B、小型可動 A+B 或純 A 非變形/穿戴式。
  7. 將 A/B 判斷視為最重要的決策關卡。建構者明確的標準和當前執行的判斷會覆蓋預設啟發式規則;在不確定時,提出推理並等待確認。
  8. 對所選原型應用內建的黃金案例抽象。從這些抽象中提取幻覺點、A/B 處理、提示詞保障、素材規則和驗證器掛鉤。
  9. 從高品質案例和當前輸入中提取核心素材層:識別/標誌、環境、節奏、動作、提示詞形式、提交合約和 TS 風險。
  10. 逐一將賣點映射到視覺證據。對於每個賣點,提出候選的實拍參考選擇,並在建構者歷史素材選擇經驗下執行對話測試,然後再將其標記為 OK。在當前賣點的證據路徑、參考類型、產品狀態、A/B 判斷、禁止素材和降級路徑確認之前,不要移動到下一個賣點。 10.5. 在賣點素材選擇期間,稽核產品狀態風險和參考繼承邊界。偏好低雜訊產品參考,例如白背景 P0/P1 圖片。一個單元可以使用多個參考,但預設情況下它們必須服務於一個產品狀態。對於鞋子、包包、服裝和其他與身體相關的產品,除非建構者明確批准,否則不要繼承產品參考中的模特兒/人物、造型、服裝、背景或道具。
  11. 在提示詞編寫之前建立影音同步安排:腳本文案 -> 具體視覺實體 -> 實際環境 -> 賣點證據 -> 單元 -> 素材角色 -> 提示詞動作 -> TS 風險。不要僅從文案或僅從素材編寫提示詞。 11.5. 場景敘事推導(§11.5 in product-rules.md)。 如果腳本場景不是產品的預設/主要場景,則在編寫任何 A 類提示詞之前完成四步驟推導:步驟 1 場景微動作 -> 步驟 2 場景特定道具 -> 步驟 3 情感弧線 -> 步驟 4 敘事品質自我檢查(Q1-Q6)。在提示詞計畫頂部輸出一個「場景敘事適應表」。預設場景的腳本可以跳過步驟 1-3,但仍須通過 Q1-Q6。
  12. 每個使用 @圖片 或 @影片 的單元提示詞必須包含一個簡潔的 【素材說明】 / Reference Materials 區塊。稽核表可以使用 controls / does_not_control,但最終提示詞應使用簡短的、對模型友好的措辭,例如 只參考...、不參考... 和 ...以 @圖片X 為準。
  13. 根據產品狀態行為將每個單元分類為 A、A-out、A-in 或 B,然後與建構者確認關鍵行。不要默默地選擇「足夠的」素材。
  14. 將執行階段素材保持為 pending,直到選擇了已批准的素材版本。在測試模式中,一兩個腳本建立第一個技能草稿和視覺反饋迴圈;在生產模式中,批次腳本驅動批次提示詞計畫、素材安排、驗證和影片任務輸入。
  15. 僅在產品理解、生產原型、黃金案例抽象、核心素材庫存、賣點驗證、影音同步和素材策略保持一致後,才生成標準技能套件。
  16. 執行自包含的移交稽核:無外部技能依賴、無本機絕對路徑依賴、無「閱讀父級/後設/黃金技能」指令,並且所有執行階段參考都解析到目標套件內部或明確標記為 pending。
  17. 使用代表性提示詞計畫和產品驗證器進行驗證;將錯誤案例回饋到規則、注意事項、清單或驗證器中。

必要工作流程

  1. 在對建構者的首次回應之前閱讀 references/creator-onboarding.md。用它來詢問指定的首輪輸入,並以初學者安全的語言解釋分階段流程。
  2. 閱讀 references/sku-creator-workflow.md。
  3. 閱讀 references/product-rules.md 以了解行業硬規則、A/B 邏輯、素材角色、狀態一致性、提示詞計畫要求和案例抽象規則。
  4. 在選擇生產原型後閱讀 references/golden-case-abstractions.md。使用其內建的茶吧、杯子/容器、鞋類/服裝和包包類穿戴式抽象來處理幻覺點和 A/B 處理。除非建構者明確提供一個當前執行的來源進行抽象,否則不要載入外部技能。
  5. 在賣點映射或提示詞編寫之前閱讀 references/core-asset-layer.md。首先用它來選擇生產原型,然後從高品質案例和當前輸入中提取標誌/文字、環境、節奏、單元分割、提示詞形式、提交和 TS 風險規則。
  6. 在提示詞編寫之前閱讀 references/audio-visual-sync.md。用它來綁定腳本文案、具體視覺實體、實際環境、賣點證據、單元分割、A/B 或 A+B 素材角色、提示詞動作、持續時間和 TS 風險降級。
  7. 使用 references/category-questionnaire.md 進行分階段的建構者問題和確認卡片。
  8. 使用 references/method-decision-tree.md 來選擇生成方法。預設使用直接生成;僅當使用者明確要求 TVC/廣告時才使用網格/TVC 流程。
  9. 在草擬目標 SKU 技能套件時使用 references/skill-template.md。
  10. 在定義語義素材角色和已批准/待處理的執行階段素材時使用 references/asset-manifest.md。
  11. 在驗證代表性腳本計畫時使用 references/prompt-plan-format.md。
  12. 在移交前以及納入錯誤案例時使用 references/gotchas.md。
  13. 使用 references/validate-template.py 和特定產品案例來建立 scripts/validate_*.py。
  14. 僅將 scripts/scaffold_category_skill.py 用作起始支架,然後用真實的產品規則進行完善。

類別後設回退

當存在成熟的類別後設或舊 SKU 參考時,優先使用它們,但將它們視為輔助工具,而非阻礙。如果它們缺失或薄弱,則使用行業規則加上內建的黃金案例抽象。在繼承任何舊規則時,在應用之前輸出 可繼承 / 需改寫 / 禁止繼承。

品質閘門

  • 輸入閘門:在詳細規則之前,產生指定的首輪輸入欄位、來源確認、產品理解、組件/狀態矩陣和生產原型。
  • 驗證閘門:每個賣點都有建構者確認的視覺證據路徑、素材類型、產品狀態、A/B 判斷、禁止素材/狀態、降級路徑和一對一的對話測試記錄。
  • 素材閘門:在提示詞編寫之前,記錄核心素材庫存、TS 風險、P0/P1/P2 角色、產品狀態風險、低雜訊參考偏好、有用/忽略的參考內容以及執行階段素材的批准狀態。
  • 同步閘門:每個有意義的腳本節拍都映射到具體的視覺實體、實際環境、單元、證據目標、素材角色、提示詞動作、持續時間/節奏和 TS 風險。
  • 提示詞閘門:每個帶有 @圖片 或 @影片 的單元都包含一個簡潔的素材用途區塊,使用對模型友好的 只參考 / 不參考 / 以...為準 措辭。
  • 場景閘門 U31:非預設場景在 A 類提示詞之前完成場景微動作、場景道具、情感弧線和 Q1-Q6 敘事自我檢查。
  • 單元閘門 U32-U35:單元根據證據、產品狀態、A/B 類型、場景和幻覺風險進行分割,而非固定的時間切片;標準的 A 類提示詞宣告單元目標、動作流程和結束條件,無需分段逐秒的散文。
  • 移交閘門:生成的 SKU 技能是標準的 Codex 形狀、自包含、SKILL.md 精簡、references/ 詳細,且無執行階段依賴於此建構器、類別後設、黃金案例、外部文件、記憶體、本機路徑或外部素材資料夾。
  • 驗證閘門:包含觸發測試、代表性提示詞計畫、產品驗證器、素材表、A/B 分類、影音同步映射、API/素材計數、驗證記錄和錯誤案例路由。

相關技能