TheMattBerman/landing-page-factory

页面构建

构建质量源于战略保真度，而非反其道而行。

此阶段将组装页面，同时保留对信任和转化至关重要的内容。

必需的输入项

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. workspace/pages/[page-name]/visuals/
6. references/anti-slop.md（与该技能捆绑）

如果缺少策略，则停止。

如果 workspace/pages/[page-name]/visuals/manifest.json 存在，则将其用作规范的机器可读视觉源。 当提供者元数据影响信任、保真度或回退历史时，不要忽略它。

保留层级

按以下顺序应用：

1. 保留信任关键类别约定
2. 保留机制传达需求
3. 保留品牌视觉标识
4. 改进布局节奏和交互质量
5. 仅在不扭曲1-4的前提下应用反垃圾品味改进

反垃圾是质量过滤器，而非重新设计许可证。

构建前检查清单

在生成HTML之前，确认：

• 页面类型已确认
• 转化机制已确认
• 证明库存已加载
• 信任提示已选择
• 视觉清单已解析为构建就绪的图像路径
• 必需的类别约定已保留
• CTA目标已知
• 布局选择已在一行中证明合理性

如果任何一项为假，则停止或降级。

路由逻辑

实体产品路由

当策略页面类型为产品导向时使用。

首屏必须包含：

• 清晰的产品或机制视觉元素
• 优惠标题
• CTA
• 信任提示

SaaS / 应用路由

首屏必须包含：

• 保留的屏幕截图或UI处理（如需要）
• 结果导向标题
• 信任提示
• CTA

潜在客户捕获路由

首屏必须包含：

• 表单 + 摩擦削减项 或
• 指向已知目的地的清晰CTA

权威 / 服务路由

必须包含：

• 首屏权威提示
• 早期证明部分
• 围绕信任和适配性的异议处理

受监管路由

必须包含：

• 当证明不完整时降低确定性
• 元数据中的合规审查标记

设计规则

• 单个HTML文件
• 至少响应于768px和1024px断点
• 语义化HTML
• 可见的焦点状态
• 所有图像上的alt文本
• 除非明确要求，否则不包含构建者归属
• 不导入覆盖源信任提示的品味模式

反垃圾使用

加载 references/anti-slop.md，并在保留层级之后（而非之前）应用它。

构建后QA表格

将其写入 workspace/pages/[page-name]/qa.md，并在 meta.json 中总结：

检查项	通过？	备注
首屏可见机制
首屏可见主要证明
首屏CTA
首屏信任提示
无虚构证明
无禁止的垃圾模式
检查了移动端折叠
检查了对比度
存在alt文本
保留了类别约定

元数据合约

meta.json 必须包含：

• 品牌
• 页面
• 页面类型
• 机制类型
• 模板路由
• CTA目标
• 具有来源摘要的证明项
• 风险反转存在
• 合规标志
• 审查标志
• 保留元素
• 与源的偏差
• 使用的图像
• 存在的部分
• 构建置信度

当存在视觉清单时，还应包含：

• hero_image
• image_provider_policy
• images_used 作为结构化对象，而不仅仅是裸文件名
• 与审查或QA相关的提供者和回退上下文

构建助手

使用 scripts/resolve-visual-assets.py --page-name [page-name] 将 visuals/manifest.json 转换为构建就绪的图像元数据，用于HTML和meta.json。

然后使用 scripts/prepare-build-meta.py --page-name [page-name] --resolved-assets [file] 将这些已解析的资源合并到 meta.json 中，包含确定性选择字段：

• hero_image
• mechanism_image
• lifestyle_image
• og_image
• image_slots.hero
• image_slots.mechanism
• image_slots.lifestyle
• image_slots.og

然后使用 skills/page-build/scripts/html-image-context.py --meta workspace/pages/[page-name]/meta.json 发出字面HTML就绪的值，例如：

• hero_img_src
• hero_img_alt
• mechanism_img_src
• mechanism_img_alt
• lifestyle_img_src
• lifestyle_img_alt
• og_image_path

最小可执行构建器：

• skills/page-build/scripts/build-page.py --page-name [page-name] 它消费 strategy.json、meta.json 和 html-image-context.json 并写入真正的 index.html 脚手架。

使用技能本地的脚本作为Cowork或任何仅上传技能文件夹的代理运行时的主要接口。 仓库根目录下的 /scripts 副本是本地开发便利，而非打包要求。

评估参考

有关评分标准和通过阈值，请参阅 skills/page-qa/references/eval-rubric.md。 有关反垃圾模式，请参阅 references/anti-slop.md（与该技能捆绑）。

停止 / 继续逻辑

在以下情况下停止：

• 对于潜在客户操作页面，CTA目标未知
• 页面依赖于缺失的证明
• 必需的信任提示无法得到支持

在以下情况下继续并降级：

• 视觉资源不完整，但中性支持布局仍然有效
• 证明较少，但页面重新调整为较温和的主张

输出

写入：

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

没有QA输出的构建是不完整的。