SuperAPI AI 工具集

landing-page-factory-orchestrator

营销与增长

查看项目

更新于 10-16 06:05

技能介绍

用途

Landing Page Factory Orchestrator 是 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. 完整流水线:例如“为 https://example.com 构建落地页”。按顺序运行 site-extract、page-strategy、brand-profile、page-copy、page-visuals、page-build、page-qa。

  2. 变体流水线:例如“为企业买家做一个版本”。使用现有品牌产物(如可用),为每个变体创建新页面包,并重跑 page-strategy、page-copy、page-visuals、page-build、page-qa。仅当源事实变化或品牌产物缺失/薄弱时才重跑 site-extract 或 brand-profile。

  3. 阶段重跑:例如“只重建视觉”“再次运行 QA”。仅重跑最少必要的下游阶段。依赖规则:策略变更 → 重跑 copy、visuals、build、qa;品牌档案变更 → 重跑 copy、visuals、build、qa;文案变更 → 重跑 build、qa;视觉变更 → 重跑 build、qa;构建变更 → 重跑 qa。

  4. 管理/检查:例如“缺少哪些产物?”“应该按什么顺序运行?”检查、报告并准备,不伪造缺失产物。

预检检查

调用下游工作前,验证所需产物。品牌级:workspace/brand/extract.md、workspace/brand/extract.json、workspace/brand/profile.md(当 copy、visuals 或 build 需要时)、workspace/brand/palette.json(当 visuals 或 build 需要时)。页面级:workspace/pages/[page-name]/strategy.json、copy.md、visuals/、index.html、meta.json、qa.md。若请求阶段所需产物缺失,停止并路由到最早缺失的阶段。

硬性停止

以下情况绝不继续:copy、visuals 或 build 没有 strategy.json;未识别出独特机制;潜在客户生成或行动驱动页面没有 CTA 目标;证明过于薄弱,不足以支撑所提议的确定性水平;提取预期使用 Firecrawl 但未配置或运行时受阻;视觉预期使用 Bloom 但未配置或运行时受阻,除非用户明确批准 Nano Banana 或手动素材。受阻时说明:缺少什么、下一步必须运行哪个阶段、哪些可降级哪些不可降级。

降级

仅在阶段技能允许时降级继续。典型降级:证明薄弱 → 更柔和的声明、仅草稿的 QA 目标;部分视觉 → 中性支持布局;精确产品图像失败 → 品牌环境或操作员素材;缺少 Bloom 品牌 → 加入以获取提供商上下文,但保留仓库品牌产物作为事实来源。

命名规则

在 workspace/pages/ 下使用描述性页面包名称。模式:基础运行 [brand]-[core-angle];变体运行 [brand]-[audience]-[angle]。良好示例:ridge-wallet-proof、stealads-enterprise-time、notion-agency-velocity。避免:test-page、v2、new-one。

变体工作流

构建多个变体时:在 workspace/brand/ 中保留一个共享品牌事实来源;为每个变体创建单独的页面包;有意识地改变受众、角度、报价框架、证明重点或视觉处理;为每个变体运行完整的页面级下游阶段;比较各变体的 QA 结论和审查标志。不要让变体静默覆盖彼此。

阶段排序规则

使用以下确切逻辑:如果用户仅提供 URL,从 site-extract 开始;如果品牌产物存在但页面包不存在,从 page-strategy 开始;如果 strategy.json 存在且用户要求文案,运行 page-copy;如果 copy.md 和品牌产物存在且用户要求视觉,运行 page-visuals;如果 strategy、copy 和 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 返回人类可读的 markdown 比较表,供 Cowork 审查,按就绪度排序。

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,而不是静默地表现得提取质量等同。

提供商执行:当 Firecrawl 是预期路径时,不允许 site-extract 静默退化为 WebFetch/手动抓取;当 Bloom 是预期路径时,不允许 page-visuals 静默退化为默认内置图像生成;如果首选提供商受阻、缺失或未配置,暂停并询问操作员哪种降级可接受;仅在用户明确批准后才继续降级。

Cowork 特定行为:如果 Cowork 阻止 api.firecrawl.dev,直接说明并建议允许该域名或运行本地提取预检;如果 Cowork 无法访问 Bloom,直接说明并询问是配置 Bloom、使用 Nano Banana 还是继续手动素材;不要让“用 WebFetch/默认图像勉强可用”算作成功的提供商运行。不要声称对仍依赖技能编写判断的阶段实现了完全自动化。

记忆日志

在任何有意义的运行后,向 memory/YYYY-MM-DD.md 追加简短说明,包含:品牌或页面名称、完成的阶段、QA 结论(如可用)、阻碍或降级、值得注意的经验教训。保持简洁,每次运行一个短节即可。

输出期望

编排时始终报告:所选模式(完整流水线、变体、阶段重跑或管理)、页面包名称、已运行或下一步需要的阶段、阻碍/降级/审查标志。对于变体运行,包含扁平比较:变体名称、受众/角度、当前产物状态、QA 结论(如存在)。