Communitygithub.com

TheMattBerman/landing-page-factory

根據保留類別規劃並生成視覺素材:精確產品、品牌環境或概念輔助。使用策略驅動的鏡頭選擇與視覺品質檢核,而非泛泛的氛圍提示。

landing-page-factory 是什麼?

此技能為 AI 代理(如 Claude Code、Cursor 或 Codex)提供一個嚴謹的流程,用於生成以轉換為導向的頁面視覺素材,確保素材的真實性與品牌一致性。它根據三個保留類別(精確產品、品牌環境、概念輔助)對視覺素材進行分類,並在提示生成之前強制執行結構化的鏡頭規劃。該技能支援多個圖像生成供應商(主要是 Bloom,次要為 Nano Banana),並包含全面的視覺品質檢核評分標準,依據區段適配性、調色板忠實度、幾何形狀與材質等維度對輸出進行評分,分數低於門檻值即拒絕。技能會產出結構化的鏡頭計畫與清單,管理失敗情況(如供應商故障或品質檢核失敗),並確保不會在需要精確的素材上使用泛泛的「氛圍」提示。其最終目標是生成支援轉換、不誤導使用者的視覺素材,同時透過強制要求使用參考素材與明確的供應商選擇,防止代理使用次級或不當的圖像生成方法。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheMattBerman/landing-page-factory/tree/HEAD/skills/page-visuals

在你喜歡的 AI 中提問

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

說明文件

頁面視覺素材

任務不是「製作漂亮的圖片」。任務是支援轉換,同時不在視覺上對所銷售的產品說謊。

如果產品、包裝、UI 或材料需要精確度,請相應地安排路徑。

必要輸入

  1. workspace/pages/[page-name]/strategy.json
  2. workspace/brand/profile.md
  3. workspace/brand/palette.json
  4. workspace/pages/[page-name]/copy.md
  5. 操作者提供的任何產品參考、包裝參考、螢幕截圖或圖片素材

供應商政策

使用 Page Factory 品牌成品作為唯一真實來源。

  • workspace/brand/extract.md 和 workspace/brand/profile.md 定義了規範的品牌理解
  • 供應商端的品牌入職是圖像生成的輔助上下文,不能取代萃取或設定檔
  • 首選供應商順序:Bloom 優先,Nano Banana 備用,在信任至關重要的情況下則使用手動/操作者素材

供應商選擇是強制性的。

如果 Bloom 在本次執行中已設定或預期使用,你必須先檢查 Bloom。 請勿在 Bloom 是預期供應商時,默默地用 Cowork 原生圖像生成、通用內建圖像工具或臨時圖像提示來取代。

如果 Bloom 未設定、被封鎖或無法連接:

  1. 明確說明此情況
  2. 詢問操作者是否要:
    • 提供/設定 Bloom
    • 使用 Nano Banana 備用
    • 提供手動/操作者素材
  3. 在信任至關重要的執行中,請勿默默地改用較弱的供應商

如果 Nano Banana 是備用路徑,請確認操作者已提供必要的轉接器/指令或 API 支援的工作流程。 請不要只因 Nano Banana 這個名稱出現在文件中就假設它存在。

Bloom 特定指引

當 Bloom 可用時:

  • 檢查該品牌是否已存在於 Bloom 中
  • 如果不存在,則從來源 URL 將品牌入職
  • 如果 Bloom 品牌上下文薄弱或不完整,請使用儲存庫中萃取的品牌事實、設定檔和調色板來補齊
  • 在生成精確產品圖片之前,先上傳產品、包裝或 UI 參考
  • 當基礎構圖夠強且變更請求範圍狹小時,使用 Bloom 的編輯/調整大小功能

在下列情況下備用至 Nano Banana:

  • Bloom 不可用或未設定
  • Bloom 入職重複失敗
  • Bloom 點數不足
  • 必要圖片在合理重試後仍無法通過視覺品質檢核評分標準

在切換至 Nano Banana 之前,明確說明為何不使用 Bloom:

  • 不可用
  • 未設定
  • 被執行環境封鎖
  • 重試後品質檢核失敗
  • 點數不足

供應商輔助程式

使用技能本地的圖像供應商進入點,透過供應商備用機制執行實際的圖像生成:

bash skills/page-visuals/scripts/image-provider.sh \
  --page-name [page-name] \
  --shot-id [shot-id] \
  --prompt "[prompt]" \
  --preservation-class [exact_product|branded_environment|concept_support]

對於 Cowork 或任何僅上傳技能資料夾的執行環境,請使用 skills/page-visuals/scripts/ 作為主要介面。 儲存庫根目錄的 /scripts 複本是本地開發的便利性,並非打包要求。

保留類別

每個規劃的視覺素材在提示之前必須先分類。

1. 精確產品保留

當產品的形狀、材質、包裝、UI 或工業設計對信任或理解至關重要時使用。

要求:

  • 保留輪廓
  • 保留比例
  • 保留材質外觀
  • 在相關情況下保留包裝
  • 在相關情況下保留 UI/螢幕內容
  • 盡可能使用參考素材

2. 品牌環境保留

當產品可以放置在特定品牌上下文中,但不需要完美的物件保真度時使用。

要求:

  • 符合調色板和目標客群的世界觀
  • 保持品牌氛圍和類別真實感
  • 避免圖庫照片式的佈置

3. 概念輔助視覺素材

當圖像是解釋性、氛圍性或背景輔助,而非信任至關重要的產品證明時使用。

要求:

  • 支援機制或區段任務
  • 保持從屬於文案
  • 不要引入虛假的產品細節

鏡頭優先級層級

按此順序生成:

  1. 證明 / 機制視覺素材
  2. 產品清晰度視覺素材
  3. 生活風格嚮往視覺素材
  4. 裝飾性輔助視覺素材

如果時間或預算有限,優先捨棄第 4 項。

必要鏡頭計畫輸出

寫入 workspace/pages/[page-name]/visuals/index.md:

# 視覺計畫:[page-name]
生成日期:

| 鏡頭 | 區段 | 保留類別 | 目的 | 必要參考素材 | 狀態 |
|---|---|---|---|---|---|
| hero-1 | hero | 精確產品 / 品牌環境 / 概念輔助 | | | 已規劃 |

當實際生成視覺素材時,請盡可能使用供應商中繼資料擴展計畫:

## 供應商執行

| 鏡頭 | 供應商 | 品牌上下文來源 | 來源圖片 ID / 參考素材 | 結果 |
|---|---|---|---|---|
| hero-1 | bloom | 儲存庫設定檔 + Bloom 入職 | bloom:img_123, 本地產品參考 | 已核准 |

同時寫入 workspace/pages/[page-name]/visuals/manifest.json,包含機器可讀的欄位:

  • 使用的供應商
  • 備用供應商及備用原因(若適用)
  • Bloom 品牌 ID 與圖片 ID(若適用)
  • 該鏡頭使用的來源參考
  • 本地輸出路徑
  • 狀態與備註

提示規則

始終包含:

  • 預期區段與任務
  • 保留類別
  • 構圖要求
  • 調色板方向
  • 氛圍/光線
  • 保真度限制
  • 明確的排除項目

精確產品保留

提示必須說明:

  • 保留物件輪廓與比例
  • 保留材質表面處理
  • 僅依據參考保留包裝/UI
  • 無虛構文字或更改的品牌標記
  • 在生成之前,若供應商支援,請附加或上傳參考素材

品牌環境

提示必須說明:

  • 目標客群上下文
  • 真實的使用瞬間
  • 透過環境、道具、服裝或光線整合調色板
  • 無刻板的圖庫照片姿勢

概念輔助

提示必須說明:

  • 區段任務
  • 簡約/抽象程度
  • 無虛假的主張承載細節

螢幕截圖 / UI 處理

如果策略標記為需要處理螢幕截圖:

  • 保留螢幕截圖或 UI 參考
  • 不要憑空偽造 UI 精確度
  • 如果沒有真實的 UI 素材,請提出標記並降級鏡頭計畫

視覺品質檢核評分標準

每個生成的圖像必須評分:

維度分數 /10及格門檻
區段適配性8
調色板忠實度8
輪廓/幾何形狀忠實度8(如適用)
材質忠實度8(如適用)
包裝/UI 忠實度8(如適用)
構圖清晰度8
偽影缺失9
文字偽影缺失10

如果任何必要維度失敗,則拒絕並重新生成。

失敗邏輯

如果精確產品保真度重複失敗:

  • 停止使用寬鬆的品牌氛圍提示
  • 要求更嚴格的參考素材
  • 如果可用,降級為保留的攝影照片或操作者提供的素材
  • 絕對不要因為模型表現不佳就偽造精確度

如果 Bloom 是首選供應商且重複失敗:

  • 如果問題是構圖或裁切而非核心保真度,請先嘗試供應商原生的編輯/調整大小功能,而非完全重新生成
  • 如果 Bloom 仍無法通過品質檢核,請切換至 Nano Banana
  • 如果兩個供應商都失敗且該鏡頭對信任至關重要,則要求真實的操作者素材

請勿讓 Cowork 默默地用其自身的預設圖像行為取代 Bloom。 如果執行環境無法存取 Bloom,請暫停並說明原因。

評估參考

有關評分標準與及格門檻,請參閱 skills/page-qa/references/eval-rubric.md。

交接

視覺素材核准後,執行 page-build。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

TheMattBerman/landing-page-factory

Build an evidence-backed brand profile from site extract and page strategy. Separates observed facts from synthesis so downstream skills preserve the brand instead of rewriting it.

TheMattBerman/landing-page-factory

Top-level operator skill for Landing Page Factory. Classifies requests, chooses stage order, enforces prerequisites and hard stops, manages variant pages, reruns changed stages, and handles page-package admin.

TheMattBerman/landing-page-factory

Build a deployable landing page from strategy, copy, visuals, and brand profile using category-aware routing, preservation hierarchy, and explicit QA. Single-file HTML output.

TheMattBerman/landing-page-factory

Write mechanism-preserving, proof-disciplined landing page copy from strategy, brand profile, and extract language bank. Includes mandatory sharpness audit and claim control.

TheMattBerman/landing-page-factory

Final landing-page QA pass against strategy, proof provenance, mechanism clarity, trust preservation, accessibility, and anti-slop. Gates whether a page is shippable or draft-only.

TheMattBerman/landing-page-factory

Normalize raw extract or manual brief into a page strategy artifact: mechanism, offer, audience, proof provenance, CTA, preservation plan, and review flags. Mandatory before copy or build.

TheMattBerman/landing-page-factory

Extract operator-grade source facts from a website or manual brief: claims, proof, CTAs, mechanism language, trust cues, visual patterns, and page structure with provenance. First stage of Page Factory.

相關技能