Communitygithub.com

Landing Page Factory 編排器

Landing Page Factory 的頂層操作技能。負責分類請求、選擇階段順序、強制執行前置條件與硬性停止、管理變體頁面、重新執行已變更的階段,以及處理頁面套件的管理作業。

Landing Page Factory 編排器 是什麼?

此技能是 Landing Page Factory 的編排控制層,專為 AI 代理(如 Claude Code、Cursor、Codex)設計,用於自動化落地頁面的端到端建置流程。當收到與建置完整管線、建立頁面變體、重新執行特定階段或執行管理任務(如頁面套件命名、產出物檢查、清理或記憶體記錄)相關的請求時,應使用此技能。此技能負責請求分類、階段排序、前置產出物檢查、強制硬性停止與降級、頁面與變體命名,以及決定哪些階段在變更後需要重新執行。它不擁有提取、策略、文案、圖像生成、HTML 建置或 QA 評分的邏輯,這些功能由專門的子技能(如 `site-extract`、`page-strategy`、`page-copy` 等)負責。此技能透過嚴格的階段排序規則、依賴規則和命名慣例來確保建置流程的完整性與可追蹤性。它支援 Cowork 和其他技能資料夾執行環境,並提供 `page-admin.py` 和 `run-pipeline.py` 等輔助腳本,以實現混合執行模式:腳本化階段自動執行,而需要人工判斷的階段(如策略、文案)則會暫停並傳遞精確的交接指令。此技能也強制執行提供者政策,例如優先使用 Firecrawl 進行提取、使用 Bloom 進行圖像生成,並在首選提供者不可用時暫停並要求操作員明確批准降級選項。

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

在你喜歡的 AI 中提問

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

說明文件

Landing Page Factory 編排器 是做什麼的?

這是控制層。

當請求涉及以下內容時,請使用此技能:

  • 建置完整的落地頁面管線
  • 建立一個或多個頁面變體
  • 在編輯後重新執行選定的階段
  • 找出正確的作業順序
  • 關於頁面套件命名、產出物檢查、清理或記憶體記錄的管理任務

請勿取代技能階段的技能。 此技能負責路由和監督它們。

此技能擁有的職責

  • 請求分類
  • 階段排序
  • 產出物預檢
  • 硬性停止與降級強制執行
  • 頁面命名與變體命名
  • 決定變更後哪些階段必須重新執行
  • 在 memory/YYYY-MM-DD.md 中記錄記憶體

此技能不擁有的職責

  • 提取邏輯
  • 策略邏輯
  • 文案邏輯
  • 圖像生成邏輯
  • HTML 建置邏輯
  • QA 評分本身

這些屬於:

  • site-extract
  • page-strategy
  • brand-profile
  • page-copy
  • page-visuals
  • page-build
  • page-qa

請求分類

首先將每個請求路由到以下模式之一。

1. 完整管線

範例:

按順序執行:

  1. site-extract
  2. page-strategy
  3. brand-profile
  4. page-copy
  5. page-visuals
  6. page-build
  7. page-qa

2. 變體管線

範例:

  • "為企業買家製作一個版本"
  • "建立三個角度變體"

如果可用,使用現有的品牌產出物。 為每個變體建立一個新的頁面套件並重新執行:

  1. page-strategy
  2. page-copy
  3. page-visuals
  4. page-build
  5. page-qa

僅當來源事實已變更或目前的品牌產出物遺失或薄弱時,才重新執行 site-extract 或 brand-profile。

3. 階段重新執行

範例:

  • "僅重新建置視覺效果"
  • "再次執行 QA"
  • "在策略變更後更新文案"

僅重新執行所需的最小下游階段。

依賴規則:

  • 策略已變更 → 重新執行文案、視覺效果、建置、QA
  • 品牌資訊已變更 → 重新執行文案、視覺效果、建置、QA
  • 文案已變更 → 重新執行建置、QA
  • 視覺效果已變更 → 重新執行建置、QA
  • 建置已變更 → 重新執行 QA

4. 管理/檢查

範例:

  • "缺少哪些產出物?"
  • "我們應該以什麼順序執行?"
  • "建立一個新的頁面套件"

檢查、回報和準備。請勿偽造缺少的產出物。

預檢檢查

在調用下游工作之前,請驗證所需的產出物。

品牌層級:

  • workspace/brand/extract.md
  • workspace/brand/extract.json
  • 當需要文案、視覺效果或建置時,workspace/brand/profile.md
  • 當需要視覺效果或建置時,workspace/brand/palette.json

頁面層級:

  • workspace/pages/[page-name]/strategy.json
  • workspace/pages/[page-name]/copy.md
  • workspace/pages/[page-name]/visuals/
  • workspace/pages/[page-name]/index.html
  • workspace/pages/[page-name]/meta.json
  • workspace/pages/[page-name]/qa.md

如果請求階段所需的產出物遺失,請停止並路由到最早遺失的階段。

硬性停止

絕不超過以下情況繼續:

  • 文案、視覺效果或建置缺少 strategy.json
  • 未識別出獨特機制
  • 潛在客戶開發或行動驅動的頁面缺少 CTA 目的地
  • 證據對於提議的確定性級別而言過於薄弱
  • 預期使用 Firecrawl 進行提取,但未設定或在執行階段被阻止
  • 預期使用 Bloom 進行視覺效果,但未設定或在執行階段被阻止,除非使用者明確批准 Nano Banana 或手動素材

當被阻止時,請說明:

  1. 缺少什麼
  2. 接下來必須執行哪個階段
  3. 哪些可以降級,哪些不能

降級

僅在階段技能允許時繼續降級。

典型的降級:

  • 薄弱的證據 → 較溫和的宣稱,僅草案階段的 QA 目標
  • 部分視覺效果 → 中性支援佈局
  • 精確產品圖像失敗 → 品牌化環境或操作員素材
  • 缺少 Bloom 品牌 → 為供應商上線提供上下文,但保持儲存庫品牌產出物作為真實來源

命名規則

使用 workspace/pages/ 下描述性的頁面套件名稱。

模式:

  • 基礎執行:[brand]-[core-angle]
  • 變體執行:[brand]-[audience]-[angle]

良好範例:

  • ridge-wallet-proof
  • stealads-enterprise-time
  • notion-agency-velocity

避免:

  • test-page
  • v2
  • new-one

變體工作流程

在建置多個變體時:

  1. 在 workspace/brand/ 中保持一個共享的品牌真實來源
  2. 為每個變體建立一個獨立的頁面套件
  3. 有意識地變更目標受眾、角度、優惠框架、證據重點或視覺處理方式
  4. 為每個變體執行完整的頁面層級下游階段
  5. 比較各變體的 QA 裁決和審查標誌

不要讓變體靜默地互相覆蓋。

階段排序規則

使用此確切邏輯:

  • 如果使用者僅提供 URL: 從 site-extract 開始

  • 如果品牌產出物存在但頁面套件不存在: 從 page-strategy 開始

  • 如果 strategy.json 存在且使用者要求文案: 執行 page-copy

  • 如果 copy.md 和品牌產出物存在且使用者要求視覺效果: 執行 page-visuals

  • 如果策略、文案和視覺效果都存在: 執行 page-build

  • 如果建置產出物存在: 執行 page-qa

建置和視覺腳本進入點

對於 Cowork 和其他技能資料夾執行環境,偏好使用技能本機腳本:

  • skills/landing-page-factory-orchestrator/scripts/page-admin.py
  • skills/page-visuals/scripts/image-provider.sh
  • skills/page-build/scripts/resolve-visual-assets.py
  • skills/page-build/scripts/prepare-build-meta.py
  • skills/page-build/scripts/select-build-images.py
  • skills/page-build/scripts/html-image-context.py
  • skills/page-build/scripts/build-page.py

儲存庫根目錄的 scripts/ 進入點僅為本機包裝器。

使用管理輔助工具進行編排支援:

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py status --page-name [page-name] 傳回目前的產出物狀態和最早遺失的階段。

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py suggest-name --brand [brand] --audience [audience] --angle [angle] 傳回一個乾淨、無衝突的頁面套件名稱。

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --page-name [page-a] --page-name [page-b] 傳回產出物狀態、就緒分數、就緒備註、標題、頁面類型、CTA 目的地、圖像數量、審查標誌和 QA 裁決(如果存在)的並排 JSON 摘要。

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown 傳回供 Cowork 審查的人類可讀 Markdown 比較表格,按就緒程度排序。

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown --output workspace/pages/[report-name].md 將比較報告寫入磁碟。

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] 比較所有符合前綴的頁面套件。

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py log-memory --title "[title]" --page-name [page-name] --stages "[stages]" --verdict "[verdict]" 將簡短的執行記錄附加到 memory/YYYY-MM-DD.md。

當您希望編排器實際執行管線的腳本化部分時,請使用執行器:

  • python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --page-name example-proof --format markdown 如果需要,執行提取,然後在具有精確交接說明的下一個技能創作階段停止。

  • python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --page-name example-proof --format markdown 恢復現有頁面套件,並在所需的產出物已存在時繼續進行建置鏈。

  • python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --brand Example --audience enterprise --angle time-saving --format markdown 建立一個無衝突的變體頁面名稱,並執行直到下一個手動階段。

此執行器是故意混合的:

  • 它直接執行腳本化階段
  • 當 page-strategy、brand-profile、page-copy 和大多數 page-visuals 工作在創作產出物仍缺失時,它會乾淨地停止
  • 一旦這些產出物存在,它會自動恢復

提取政策:

  • 當 FIRECRAWL_API_KEY 可用時,偏好自動使用 Firecrawl
  • 如果未設定 Firecrawl,允許基本提取,但應視為降級
  • 對於公開發布品質的執行,建議新增 Firecrawl,而不是靜默地假裝提取品質是等效的

提供者強制執行:

  • 不允許 site-extract 在預期使用 Firecrawl 時靜默地降級為 WebFetch/手動抓取
  • 不允許 page-visuals 在預期使用 Bloom 時靜默地降級為預設的內建圖像生成
  • 如果首選提供者被阻止、缺失或未設定,暫停並詢問操作員哪種降級是可接受的
  • 僅在使用者明確批准降級時才繼續

Cowork 特定行為:

  • 如果 Cowork 阻止 api.firecrawl.dev,請直接說明,並建議將該網域加入白名單或執行本機提取預檢
  • 如果 Cowork 無法連接 Bloom,請直接說明,並詢問是否要設定 Bloom、使用 Nano Banana 或繼續使用手動素材
  • 不要讓「它與 WebFetch/預設圖像勉強可用」算作成功的提供者執行

對於仍然依賴技能創作判斷的階段,請勿聲稱完全自動化。

記憶體記錄

在任何有意義的執行之後,將簡短備註附加到 memory/YYYY-MM-DD.md,內容包含:

  • 品牌或頁面名稱
  • 完成的階段
  • 可用的 QA 裁決
  • 阻礙或降級
  • 值得注意的教訓

保持簡潔。每次執行一個簡短的部分即可。

輸出期望

在編排時,始終回報:

  • 選擇的模式:完整管線、變體、階段重新執行或管理
  • 頁面套件名稱
  • 已執行的階段或下一個需要的階段
  • 阻礙、降級或審查標誌

對於變體執行,包括一個簡潔的比較:

  • 變體名稱
  • 目標受眾 / 角度
  • 目前的產出物狀態
  • 可用的 QA 裁決

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

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

Plan and generate visuals by preservation class: exact product, branded environment, or concept support. Uses strategy-driven shot selection and visual QA instead of generic vibe prompting.

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.

相關技能