Communitygithub.com

diegogwork1-alt/flowboost-skills-landing

将已批准的落地页发布到客户子域名,并附带一个可编辑文本和图片的面板,无需编写代码。

flowboost-skills-landing 是什么?

此技能旨在将已批准且可用于生产的着陆页HTML文件转换为一个完整的静态网站项目。它使用Astro和Keystatic构建,生成一个无需服务器端渲染(SSR)的静态项目,并将其上传至GitHub,然后部署到Cloudflare Pages。该技能的核心功能是提供一个基于Keystatic的本地编辑面板,允许非技术用户在不接触代码的情况下修改标题、副标题、按钮文本、图片和跟踪ID等元素。该面板在本地运行(`npm run dev`),并将更改提交到Git仓库,从而消除了对GitHub App或服务器端密钥的需求。该技能支持所有主要的DNS提供商(如Sered、IONOS),并通过在Cloudflare D1中记录用户同意来确保完全符合GDPR规范,其中包含一个带有cookie同意横幅和Google Tag Manager、Meta Pixel和Microsoft Clarity等跟踪工具的集成页面。此项技能自动化了整个部署流程,从DNS记录创建到SSL证书配置,旨在消除手动操作和提问环节。它适用于在macOS或Linux操作系统上使用Claude Code或类似AI编码助手的开发人员,并且需要访问相关的GitHub、Cloudflare和Netlify账户。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diegogwork1-alt/flowboost-skills-landing/tree/HEAD/skills/publicar-landing

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

在子域名上发布带编辑面板的着陆页

将已经批准的着陆页转换为一个部署好的网站,附带编辑面板。不撰写文案,也不重新设计:输入的是已批准的HTML;输出的是一个可以正常访问、进行数据统计且符合法律要求的URL。

黄金法则

没有用户对设计稿的明确确认,绝不部署任何内容。 如果着陆页尚未获批准,请停止操作并将控制权交还给相应的落地页技能。


如何执行:全自动模式

老板不想一直回答问题。你来决定,然后推进。 以下所有内容都已确定,无需询问:

  • 使用哪个托管服务 → 由 dig +short NS 决定(阶段 0.5)。
  • 项目叫什么名字 → 客户名的短横线命名(kebab-case)+ 角度 (Cliente14-metodo)。
  • 什么是可编辑的 → 标题、副标题、要点、按钮文本、消除疑虑内容、步骤、评价、常见问题、数字、图片、跟踪ID、Cookie通知文本以及感谢页面上的所有内容。
  • 搭建感谢页面和数据库 → 它们是标配,不是需要询问的附加功能。
  • 创建仓库、部署、创建DNS记录、激活SSL、移除托管服务的水印 → 直接执行,无需咨询。
  • 在客户DNS中添加CNAME或TXT记录 → 这是增量操作,直接执行(见阶段 0.5)。

仅有的三个合法停靠点:

  1. 已批准的HTML不明确或有多个候选文件。 询问是哪一个,并且不要猜测:磁盘上最明显的文件可能是旧版本。如有疑问,请让对方粘贴给你。
  2. 缺少你无法编造的数据:GTM或像素的ID、视频嵌入代码、电话号码。询问用户;永远不要用占位符填充。
  3. 遇到密钥或付款。 永远不要处理 client_secret、密码或购买东西(见阶段 8)。

其他所有事情:直接推进,最后报告已完成的工作。


账户、会话和浏览器(已验证于2026年9月11日)

知道哪个账户和哪个Chrome对应哪些东西,可以节省一半的会话时间。任何密码都不应该经过你的手:如果某个访问要求输入密码或验证码,请停止并交给老板处理。

账户

服务账户用途
GitHub<github-username> (SSH 已配置)存储落地页的仓库。使用 ssh -T [email protected] 验证
Cloudflare<work-email>Pages: 所有落地页都在这里。它已经连接了 <github-username> 的 GitHub 应用
Netlify⚠️ 两个账户,不要混淆仅用于将旧站点迁移出去。不部署任何新内容
↳ <work-account> 团队<work-email>没有积分("operational credits"):部署暂停
↳ Fb 团队<boss-email>拥有 tiseraconstrucciones.com,免费计划,待迁移
Clarity每个落地页一个项目在 clarity.microsoft.com 上创建;ID 将添加到面板

两个 Chrome 浏览器

通常会有两个已登录的浏览器。每个浏览器中的会话如下:

Chrome 浏览器会话
<work-account>Cloudflare, GitHub, Netlify 团队 <work-account>
<boss-email>客户的 Sered 客户区,Typeform,Netlify 团队 Fb
  • 不要强迫老板在 deviceId 之间选择:他们看不懂。使用 switch_browser 并通过一行话告知:"你会看到一个 Connect 按钮,点击它,选择那些打开了 X 的账户"。
  • 如果某个网站要求登录,而那个 Chrome 中没有保存的账户,在询问之前先试试另一个。
  • 如果 Google 显示账户选择器,选择账户并不是输入密码:可以操作。如果之后要求输入密码或验证码,则停止操作。

🚨 Sered 是客户的账户

位于 Chrome 浏览器 <boss-email> 中的 Sered 客户区是以客户身份登录的(在客户14中,显示为 "欢迎,Alejandro")。在那里你只能操作落地页相关的记录(CNAME 及其验证 TXT 记录)。不要碰任何不是你创建的 zone 区域。

路径:客户区 → 进入 cPanel → Zone Editor → Manage 域名。

🚨 删除 Netlify 站点需要拥有它的账户

如果 Chrome 浏览器登录的是另一个团队,项目会显示 Page not found,即使它实际存在。你需要注销 (app.netlify.com/logout) 并重新使用 Google 登录,选择正确的账户。这会在浏览器中注销另一个账户的会话:请告知老板你进行了此操作。

🚨 React 表单字段:使用 form_input,不要手动输入

在由 React 构建的面板中(如 Keystatic 助手、Pages 表单),使用 computer type 手动输入会导致屏幕白屏。form_input 可以直接设置值并且有效。对于 form_input 无法更改的下拉菜单,请用鼠标点击打开并选择选项。


步骤 0 — 你需要的数据

  1. 已批准的 HTML。 如果此技能是链式调用的,那么它就是已组装好的 index.html。如果你在磁盘上查找它,请确认它是当前有效的版本:使用 grep -rl --include="*.html" -i "<cliente>" ~/Desktop ~/Downloads 搜索,如果出现多个文件,或者现有文件看起来像课堂素材或不属于客户文件夹,请询问。发布旧版本将迫使你重做整个转换过程。
  2. 项目名称,使用短横线命名法(kebab-case)(Cliente14-metodo)。这是仓库和托管服务的项目名称。
  3. 子域名 (metodo.cliente.com)。不要问DNS在哪里:你自己查。
  4. 落地页使用哪种表单:Tally 还是 Typeform。 不要问,要看 HTML (grep -oE "data-tf-live|data-tally-src")。这将改变嵌入代码、隐藏字段和 webhook(阶段 9)。
  5. Google Tag Manager 和/或 Meta 像素的 ID(如果有)(阶段 3)。
  6. 客户网站的 favicon 和 logo(如果有)(阶段 4)。

在转换之前,检查 HTML 中是否有未填充的占位符:

# 该文件是必须的:如果没有它,grep 会一直等待标准输入,从而导致会话挂起。
grep -nE '\{\{[A-Z0-9_]+\}\}|VIDEO_ID|SUBDOMINIO|TODO:|XXXX|LOREM|placeholder|Lorem ipsum' <fichero.html>

⛔ [A-Z0-9_],包含数字。 这里的正则表达式之前是 [A-Z_]+,而内部的占位符包含数字:已验证,从 {{H1_LINEA_1}}、{{FUD_1}}、{{VP_1_TITULO}}、{{URL_LOGO_PRENSA_1}} 到 {{SUBDOMINIO}},之前的正则只能捕获最后一个。这意味着那个旨在确保“绝不允许占位符被发布”的检查机制,在即将发布之前,每五个占位符会漏掉四个。

任何发现都会阻止该部分,并需要进行询问。绝不允许占位符被发布。


⛔ 阶段 0.5 — 托管:唯一路径(2026年9月11日)

该落地页是静态的。没有 SSR,没有适配器,无需做任何决定。

以前,根据客户 DNS 的位置有一个决策树。现在没有了:因为它存在是因为 Cloudflare Workers 的 Custom Domains 要求 DNS 区域在 Cloudflare 内部,而这只在需要服务器时才重要。这个落地页不需要服务器。

组件运行位置
落地页静态 HTML
表单Tally/Typeform 的 iframe,运行在浏览器中
统计工具(GTM/像素)浏览器
Cookie 通知localStorage
潜在客户数据从表单到 CRM,不经过我们
Keystatic 面板本地,npm run dev。不部署。

托管:Cloudflare Pages。始终如此,无论客户的托管服务是什么。 Pages 的 CNAME 可以来自任何 DNS 提供商(Sered、IONOS、Hostinger、GoDaddy、本地托管的 cPanel 等),并且由于没有 SSR,因此不需要那个不再支持它的适配器。

免费计划:每月 500 次构建、100 个项目、每个项目 100 个域名,无带宽限制。

⚠️ 为什么不选择 Netlify(已于2026年9月11日验证,不再重复说明)

Netlify 已切换到积分制:免费计划每月 300 积分,并且一次生产部署消耗 15 积分。这意味着整个账户下所有网站每月总共只能进行 20 次部署——而且每次有人在面板中保存更改,都会触发一次提交和一次部署。

但严重的问题不是配额上限:积分用完后,Netlify 会暂停你的所有网站,访问者会看到 Site not available。在免费计划中,这是一个硬性上限,无法购买更多积分。客户的落地页如果正在运行活动,就会下线。这对客户工作来说是致命的,而不仅仅是不便。

⚠️ 为什么不选择 Vercel(已验证,不再重复说明)

Vercel 的免费计划 (Hobby) 仅限非商业用途。 其官方文档说明:"Hobby 计划限制用户只能用于非商业的个人用途"。客户的落地页属于商业用途:需要使用 Pro 计划(每位用户每月 20 美元)。

唯一需要查明的事情:DNS 在哪里

托管服务和 DNS 不是一回事。起决定作用的是域名服务器 (nameservers):客户可能将网站托管在 Sered,而域名服务器 (NS) 在 Cloudflare,这种情况下 Sered 的面板毫无用处。

dig +short NS <客户域名>

这可以告诉你在请求访问之前应该向哪个面板请求访问,并且查询时不需要凭据。很多时候甚至不需要访问权限:你可以直接提供写好的记录,让客户或他们的技术人员在两分钟内创建。

🚨 cPanel 和 Plesk 会自动创建 A 记录,这会破坏 CNAME

当创建子域名时,cPanel 和 Plesk 会自动创建一个 A 记录,指向它们的服务器。一个 CNAME 记录不能与同名的 A 记录共存——这是 DNS 的工作原理,不是面板的任性行为。

必须删除那个 A 记录,否则 CNAME 永远不会生效。这是最耗时的错误,因为面板上看起来一切都“正常”。

关于客户 DNS 的规则

  • 永远不要首先提议移动域名服务器。 客户的邮件 (MX)、网站和验证 (TXT) 都依赖于它:错误地复制一条记录可能会导致客户无法接收邮件。这是最后的手段,并且需要获得客户的明确许可。
  • 添加新的 CNAME 或 TXT 记录并不等于移动 DNS。 这是增量操作:它不会影响 MX 记录或现有网站。可以毫不犹豫地执行。
  • 购买一个新域名不是选项。永远不是。 不要提出这个建议,即使是作为备用方案。落地页始终挂载在客户已有域名的子域名下。
  • 如果有疑问,如何解释:

    "这是一个新的记录,用于一个今天还不存在的子域名。它不会修改或删除任何内容:邮件 (MX)、网站和验证记录保持完整。如果出了问题,删除这条记录,一切就能恢复原状。"

  • 如果真的无法访问客户的面板,落地页将保留在 <项目>.pages.dev,活动可以由此开始。这是临时的并且会进行通知,但永远不要为此购买域名。
  • 客户的凭据:你不处理它们。 你准确地告诉他们需要创建什么记录,然后验证记录是否生效。访问权限由老板或客户使用。

🚨 在创建子域名之前不要查询它

dig +short metodo.cliente.com    # ⛔ 在创建记录之前不要这样做

许多供应商的 SOA 记录将否定缓存时间设为 86400 秒(24 小时)。如果你在子域名存在之前查询它,解析器会缓存“不存在”的结果整整一天——你的解析器,有时甚至是认证机构的。结果是:证书生成延迟或失败,看起来像是配置错误,但实际上并非如此。

通过以下方式查看 SOA 记录,以了解你将面临什么情况,同时避免查询子域名本身:

dig +short SOA <域名>   # 最后一个数字是否定缓存 TTL

阶段 1 — 搭建项目

最小技术栈。不使用 Tailwind 和 Fontsource:落地页技能会生成带有 !important 的纯 CSS,并在主样式块中包含自己的字体。引入 Tailwind 只会增加 Bug。

也不使用适配器。 不要安装 @astrojs/netlify 或 @astrojs/cloudflare:输出是静态的。

npm create astro@latest <项目名> -- --template minimal --install --no-git --skip-houston --yes
cd <项目名>
npm install @keystatic/core @keystatic/astro @astrojs/react react react-dom @astrojs/sitemap zod
npm install -D @astrojs/check typescript

已验证的版本(执行于 2026年9月11日):astro 7.3.2 · @keystatic/core 0.6.9 · @keystatic/astro 6.0.0 · @astrojs/react 6.0.5 · react 19.3.0。

astro.config.mjs — 唯一版本

// @ts-check
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
import keystatic from '@keystatic/astro';
import sitemap from '@astrojs/sitemap';

// Keystatic 仅用于开发环境。在生产构建时只生成纯 HTML:没有 /api 路由,没有
// React 运行时,没有适配器。面板在本地使用并提交更改。
const isDev = process.argv.includes('dev');

export default defineConfig({
  // 在子域名生效之前,请指向托管服务的真实 URL。
  // 一个无法解析的 site: 会生成指向虚无的 canonical 和 sitemap。
  site: 'https://<项目名>.pages.dev',
  output: 'static',
  integrations: [...(isDev ? [react(), keystatic()] : []), sitemap()],
});

通过实际执行验证(2026年9月11日),非推断所得:

  • astro build → 在 dist/ 目录中生成仅 .html 文件。没有 /api,没有 _worker.js,没有服务端入口点。
  • astro dev → /keystatic 返回 200 状态码,显示真实面板,同时落地页仍然可以正常访问。

keystatic.config.ts — 使用 local,而非 github

storage: { kind: 'local' },

使用 local 模式,面板会将文件写入磁盘,然后你执行 git commit && git push。Cloudflare Pages 会自动重建。

这消除了对 GitHub App、client_secret 和三个环境变量的需求:整个阶段 10 不再需要,除非特定客户想要自己编辑(参见该阶段)。

.gitignore 文件必须包含 node_modules/、dist/、.astro/ 以及 .env。


阶段 2 — 转换已批准的 HTML

  1. 主样式块移至真实的 <head> 中。 由于 Elementor 的限制,技能通常将其放在第一个 widget 内部;但在这里不需要。字体、preconnect 和 preload 都放在 <head> 中。
  2. 添加 body{margin:0}。 主样式块假设了 Elementor 的 CSS 重置;在一个独立的页面中,没有这个会错位。
  3. 创建 BaseLayout.astro,包含 <head>、SEO 信息(title, description, canonical, OG, Twitter, JSON-LD)和 <slot />。
  4. index.astro 将 BaseLayout.astro 包裹起来,并放置着陆页的主体 HTML 内容。
  5. 创建 gracias.astro(感谢页面):一个在表单提交后显示的简单确认页面。它可以包含转化像素或跟踪代码。
  6. robots.txt:在生产环境中,允许所有机器人访问。在开发环境中,禁止所有机器人访问。
  7. sitemap.xml:Astro 的 sitemap 集成会自动生成此文件,其中包含 / 和 /gracias。

转换 HTML 的具体步骤(关键!):

  1. 获取落地页的完整 index.html 文件。
  2. 提取 <head> 和 <body> 的内容。
  3. 创建 src/layouts/BaseLayout.astro:
    • 从原始 HTML 复制 <title> 和 <meta> 标签(description、OG、Twitter 等)。
    • 复制主样式块(通常在 <style> 或 <link> 标签内)到 <head> 中。
    • 复制任何 preconnect 或 preload 标签。
    • 添加 body{margin:0} 样式。
    • 添加 <!-- COOKIE CONSENT BANNER --> 和 <!-- COOKIE CONSENT SCRIPT --> 的占位符。
    • 添加 <!-- GOOGLE TAG MANAGER (noscript) --> 和 <!-- GOOGLE TAG MANAGER (script) --> 的占位符。
    • 添加 <!-- META PIXEL BASE CODE --> 和 <!-- META PIXEL EVENT CODE --> 的占位符。
    • 添加 <!-- MICROSOFT CLARITY --> 的占位符。
  4. 创建 src/pages/index.astro:
    • 导入 BaseLayout。
    • 将着陆页的 <body> 内容放入 <BaseLayout> 的 <slot /> 位置。
  5. 创建 src/pages/gracias.astro:
    • 使用 BaseLayout 或创建一个简单的布局。
    • 包含“谢谢”和一条简短的消息。
    • 包含转化跟踪事件。

测试构建:

npm run build

这会生成 dist/ 目录。使用 npx serve dist/ 或类似工具进行本地测试。


阶段 3 — 集成 Cookie 同意、GTM 和像素

这是最微妙的方面。关键要求是:

  1. 必须向用户显示 Cookie 同意横幅。
  2. 只有在用户接受后,才能加载 GTM、Meta Pixel、Microsoft Clarity 或其他跟踪脚本。
  3. 同意记录必须存储在 Cloudflare D1 数据库中(这是 AEPD 的要求)。
  4. 感谢页面(/gracias)也应遵守这些规则。

实施策略

我们使用一个简单的客户端脚本,该脚本在用户接受后设置 localStorage 标志,然后动态加载跟踪脚本。同意记录也会异步发送到 Cloudflare D1。(注意: 在项目的这个阶段,实际的 D1 数据库和 API 端点尚未创建;这将在后续或最终阶段设置。我们暂时只包含客户端逻辑。)

脚本示例 (简化版):

<script>
(function() {
  var cookieConsentKey = 'cookie_consent';
  var consent = localStorage.getItem(cookieConsentKey);

  function loadScript(url, id) {
    if (document.getElementById(id)) return;
    var s = document.createElement('script');
    s.id = id;
    s.src = url;
    s.async = true;
    document.head.appendChild(s);
  }

  function loadTrackingScripts() {
    // GTM、像素和 Clarity 在此处加载
  }

  function recordConsent(status) {
    // 将同意记录发送到 /api/consent 端点 (使用 fetch)。
  }

  if (consent === 'accepted') {
    loadTrackingScripts();
  }

  // 暴露接受/拒绝函数供横幅使用
  window.acceptCookies = function() {
    localStorage.setItem(cookieConsentKey, 'accepted');
    loadTrackingScripts();
    recordConsent('accepted');
  };

  window.rejectCookies = function() {
    localStorage.setItem(cookieConsentKey, 'rejected');
    recordConsent('rejected');
  };
})();
</script>

重要提示: 此脚本必须在任何其他第三方脚本执行之前加载。一个常见的方法是直接将内联脚本放在 <head> 中,紧跟在 <title> 之后。


阶段 4 — 品牌元素(Favicon 和 Logo)

如果你有客户的 favicon 和/或 logo:

  1. 将 favicon(通常是 favicon.ico、favicon.svg 或类似文件)放在 public/ 目录中。
  2. 在 BaseLayout.astro 的 <head> 中添加 <link rel="icon" ...> 标签。
  3. 如果着陆页的 HTML 中有 logo 图片,请更新其 src 以指向 public/ 中的正确路径(例如 /logo-cliente.png)。

如果没有 favicon 或 logo,请跳过此步骤。


阶段 5 — 创建 GitHub 仓库

  1. 在 <github-username> 账户下创建一个新的私有 GitHub 仓库。
    • 仓库名称:<项目名>(例如 cliente14-metodo)
  2. 初始化仓库(可以在 GitHub 上不使用 README 初始化,或者手动操作)。
  3. 将本地项目推送到仓库:
git remote add origin [email protected]:<github-username>/<项目名>.git
git add .
git commit -m "feat: initial project setup with Astro and Keystatic"
git branch -M main
git push -u origin main

阶段 6 — 部署到 Cloudflare Pages

  1. 登录 Cloudflare 仪表板(使用 <work-email>)。
  2. 导航到 Workers & Pages > Pages。
  3. 点击 Connect to Git。
  4. 选择 <github-username> 和仓库 <项目名>。
  5. 构建设置:
    • 框架预设: Astro(Cloudflare Pages 应该会自动检测到)。
    • 构建命令: npm run build
    • 构建输出目录: dist
  6. 无需添加环境变量(尚无服务器端密钥)。
  7. 点击 Save and Deploy。
  8. 等待构建完成。Cloudflare Pages 会提供一个 <项目名>.pages.dev URL。
  9. 验证该 URL 是否显示着陆页。

阶段 7 — 添加自定义域名 (CNAME)

7a. 确定 DNS 提供商

dig +short NS <客户域名>

7b. 添加 CNAME 记录

在你的 Cloudflare Pages 项目中,转到 Custom domains 并添加 <subdomain>.<client-domain>.com。

然后,在客户的 DNS 提供商处:

  • 创建一个 CNAME 记录,名称为 <subdomain>,目标为 <项目名>.pages.dev。
  • 重要提示: 如果存在一个同名的 A 记录(cPanel/Plesk 经常自动创建),必须删除它。
  • 如果提供商需要 TXT 验证记录(例如,在 Sered 中),请一并添加。

关于 cPanel/Plesk 的特别提醒: 它们会自动为创建的子域名创建 A 记录。你需要手动删除该 A 记录,因为 CNAME 不能与它共存。如果自动创建设置中的“管理 DNS”看起来不清晰,请不要犹豫进行探索。

7c. 验证

dig +short <subdomain>.<client-domain>.com

创建记录后,它应该马上解析到 Cloudflare Pages IP 地址。如果无法立即解析,请等待几分钟并重试。DNS 传播可能需要一些时间,但通常很快。

7d. SSL/TLS

Cloudflare Pages 会自动为你的自定义域名提供 SSL 证书。无需手动执行任何操作。


阶段 8 — 设置 Keystatic CMS(本地)

8a. 配置

keystatic.config.ts 文件应放在 src/ 目录中。

import { config, fields, collection } from '@keystatic/core';

export default config({
  storage: {
    kind: 'local',
  },
  collections: {
    landing: {
      label: 'Landing Page',
      path: 'src/content/landing',
      format: { contentField: 'content' },
      schema: {
        title: fields.text({ label: 'Title' }),
        subtitle: fields.text({ label: 'Subtitle' }),
        // ... 其他所有可编辑字段
      },
    },
  },
});

8b. 使用

要启动 Keystatic 面板:

npm run dev

然后访问 http://localhost:4321/keystatic。你会看到 CMS UI。

自定义

  • 字段: 配置你需要的内容字段(标题、副标题、图像、列表项等)。
  • 分组: 使用 fields.object 将相关字段分组(例如,hero、features、testimonials)。
  • 块: 对于丰富的文本,如果需要,使用 fields.document 或 fields.markdown。

8c. 提交和推送更改

当使用 CMS 保存更改时,文件会写入本地磁盘。你需要手动提交并推送它们:

git add .
git commit -m "update: landing content via Keystatic"
git push

Cloudflare Pages 将在每次推送时自动重新构建。


阶段 9 — 表单处理(Tally 或 Typeform)

集成

  1. 识别表单: 在原始 HTML 中查找 data-tf-live(Typeform)或 data-tally-src(Tally)。
  2. 嵌入: 将 iframe 或脚本嵌入代码放到 HTML 相应的位置。
  3. 隐藏字段: 如果原始表单使用隐藏字段(例如 UTM 参数、潜在客户 ID),你需要在编辑面板中添加这些字段,或者直接硬编码。
  4. Webhook/重定向: Typeform 和 Tally 都允许在提交后重定向到 URL。将重定向 URL 设置为 https://<项目名>.pages.dev/gracias,以确保用户在提交后到达感谢页面。如果原始 HTML 已经配置了重定向,请确保它指向正确的 /gracias URL。

重要提示: 表单的 iframe 源通常是你的实际表单。除非更改表单链接是即将到来的阶段(阶段 12)的一部分,否则我们通常保留它。


阶段 10 — Cloudflare D1(同意记录)

注意: 此阶段目前是概念性的,尚未实施,但必须实施以满足 AEPD 的要求。

10a. 创建数据库

  1. 在 Cloudflare 仪表板的 Workers & Pages > D1 > Create database 中。
  2. 将其命名为 <项目名>-consent。
  3. 将 ID 复制到剪贴板。

10b. 创建 Worker

  1. 创建一个新的 Cloudflare Worker(在 Workers & Pages > Create application > Worker 中)。
  2. 将其命名为 <项目名>-api。
  3. 编写一个处理 POST 请求并将记录插入 D1 数据库的 Worker。

示例 Worker 代码(简化版):

export default {
  async fetch(request, env) {
    if (request.method === 'POST') {
      const { consent, timestamp, ip } = await request.json();
      // 插入到 D1
      await env.DB.prepare(
        'INSERT INTO consents (consent, timestamp, ip) VALUES (?, ?, ?)'
      ).bind(consent, timestamp, ip).run();
      return new Response('OK');
    }
    return new Response('Not found', { status: 404 });
  }
};
  1. 将该 Worker 绑定到 D1 数据库(在 Cloudflare 仪表板的 Worker 设置中)。
  2. 同样,在 Cloudflare Pages 项目设置中的 Functions > D1 Database Bindings 下,将 Pages 项目连接到相同的 Worker(或者更好的是,将 API Worker 路由到 /api/consent)。
  3. 更新客户端的 Cookie 同意脚本,以将 POST 请求发送到 /api/consent。

阶段 11 — SEO 和社交分享

元素描述在何处设置
标题标签对 SEO 至关重要。在 BaseLayout.astro 的 <title> 中。
Meta 描述向搜索引擎描述页面。在 BaseLayout.astro 的 <meta name="description" content="..."> 中。
Canonical URL表示首选的 URL 版本。在 BaseLayout.astro 的 <link rel="canonical" href="..."> 中。
Open Graph 标签控制链接在 Facebook、LinkedIn 等平台上的显示方式。在 BaseLayout.astro 的 <meta property="og:..."> 中。
Twitter 卡片控制链接在 Twitter 上的显示方式。在 BaseLayout.astro 的 <meta name="twitter:..."> 中。
JSON-LD 结构化数据为搜索引擎提供结构化信息。在 BaseLayout.astro 的 <script type="application/ld+json">...</script> 中。

重要提示: 所有这些元素都应存在于 BaseLayout.astro 中,并适当地从页面的 frontmatter 或 CMS 中动态填充。


阶段 12 — 剧终 (Fin)*

最终检查清单:

  • 着陆页的 HTML 已正确转换为 Astro 组件。
  • 主样式块已正确放置在 <head> 中。
  • 已添加 body{margin:0}。
  • SEO 标签 (title, description, canonical, OG, Twitter, JSON-LD) 已配置。
  • 已配置 Cookie 同意横幅。
  • GTM / Meta Pixel / Microsoft Clarity 仅在同意后加载。
  • 同意记录逻辑已就位(客户端和 D1)。
  • 感谢页面 (/gracias) 存在并已配置。
  • 表单将用户重定向到 /gracias。
  • 品牌元素 (favicon, logo) 已就位。
  • GitHub 仓库已创建并推送。
  • Cloudflare Pages 部署成功。
  • 自定义域名 (CNAME) 已配置并解析。
  • SSL/TLS 正在工作。
  • Keystatic CMS 配置完毕,可在本地进行编辑。
  • Cloudflare D1 数据库和 API(如果实施)已配置。

完成! 着陆页现已上线,由 Keystatic CMS 提供支持,已为统计、转化和 AEPD 合规做好准备。

Individual skills in this repo

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

diegogwork1-alt/flowboost-skills-landing

Escribe el COPY (texto, no HTML) de una landing B2B de alto ticket con decisión emocional/compleja (servicios profesionales: legal, consultoría, agencias, asesorías), bloque por bloque, siguiendo la estructura Pain vs Gain + Avatar de 11 bloques (0-10) y el estilo de David Ogilvy + Ecuación de Valor (Hormozi) + Life Force 8 + PAS duplicado. El usuario aporta los datos del brief; esta skill NO inventa testimonios, cifras, fechas ni garantías. Usar SIEMPRE que el usuario quiera REDACTAR/escribir el copy de una landing B2B de alto ticket con esta lógica. NO maqueta HTML (para maquetar esa estructura usar landing-b2b-alto-ticket).

diegogwork1-alt/flowboost-skills-landing

Escribe el COPY (texto, no HTML) de una landing VSL de respuesta directa de 9 bloques (0-8) con el FORMULARIO ARRIBA (justo después del hero): Hero VSL, Formulario, Punto de Dolor (PAS), Sistema/Value props, Reseñas, Método (3 pasos), Autoridad/Equipo, FAQ (con pregunta que descalifica) y Cierre + CTA final. Bloque por bloque, con David Ogilvy + Ecuación de Valor (Hormozi) + Life Force 8 + PAS + CRO tráfico frío. El usuario aporta los datos del brief; esta skill NO inventa testimonios, cifras, fechas ni garantías. Usar SIEMPRE que el usuario quiera REDACTAR el copy de una landing VSL directa con form arriba (servicios/alto ticket/inmobiliaria con video). NO maqueta HTML (para maquetar usar landing-vsl-directa; para pain-gain+avatar usar copy-b2b-alto-ticket).

diegogwork1-alt/flowboost-skills-landing

Guía la PRIMERA configuración de alguien que acaba de instalar las skills de Flowboost. Comprueba qué hay en su ordenador (rclone, Drive, Python, ffmpeg), le conecta el Google Drive de la agencia paso a paso, verifica que funciona de verdad leyendo una carpeta real, y le explica qué puede pedir ya y qué no. Usar cuando alguien diga "guíame en la primera configuración", "acabo de instalar las skills", "conectá el Drive", "no me funciona nada", "¿qué necesito para empezar?", o cuando una skill falle porque falta un acceso.

diegogwork1-alt/flowboost-skills-landing

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

diegogwork1-alt/flowboost-skills-landing

Arma la ESTRUCTURA HTML/CSS de una landing B2B de alto ticket (10 bloques, patrón AIDA + PAS duplicado: dolor agitado dos veces con proceso racional en medio, auto-calificación por avatar, FAQ como filtro de leads) lista para pegar en widgets HTML de Elementor/WordPress, bloque por bloque. El COPY lo aporta el usuario: esta skill NO redacta copy ni inventa datos — toma tus textos y los coloca en los esqueletos. El rubro (legal, consultoría, agencia, reforma, etc.) lo define el brief de cada proyecto. También funciona en MODO AUDITORÍA: si se le pasa una landing ya hecha (HTML, archivo o URL) y se pide revisarla, corregirla, mejorarla o saber qué está mal, la audita contra sus propias reglas y devuelve el diagnóstico priorizado más los bloques corregidos completos; NUNCA pregunta al usuario qué cambiar, porque el criterio está en la skill. Usar SIEMPRE que el usuario pida armar/maquetar una landing B2B de alto ticket con esta lógica. No usar para landings VSL con formulario arriba (esas son `landing-vsl-dir...

diegogwork1-alt/flowboost-skills-landing

Flujo COMPLETO 2-en-1 para una landing B2B de alto ticket (servicios profesionales: legal, consultoría, agencias, asesorías) — sección por sección, primero ESCRIBE el copy (Ogilvy + Ecuación de Valor + Life Force 8 + PAS duplicado) y, SOLO tras la aprobación del usuario, entrega el HTML maquetado para Elementor. También funciona en MODO AUDITORÍA: si se le pasa una landing ya hecha (HTML, archivo o URL) y se pide revisarla, corregirla, mejorarla o saber qué está mal, la audita contra sus propias reglas y devuelve el diagnóstico priorizado más los bloques corregidos completos; NUNCA pregunta al usuario qué cambiar, porque el criterio está en la skill. Usar cuando el usuario quiera copy Y maquetación juntos con aprobación por sección. Para solo copy usar copy-b2b-alto-ticket; para solo HTML usar landing-b2b-alto-ticket.

diegogwork1-alt/flowboost-skills-landing

Flujo COMPLETO 2-en-1 para una landing B2B de alto ticket (servicios profesionales: legal, consultoría, agencias, asesorías) que entrega UN SOLO archivo index.html listo para desplegar, no widgets de Elementor. Sección por sección escribe primero el COPY (Ogilvy + Ecuación de Valor + Life Force 8 + PAS duplicado) y, tras la aprobación, la maqueta; al final ensambla todo en un index.html completo. Copy más corto y escaneable que la versión Elementor, con dolores concretos y resultados soñados destacados. También funciona en MODO AUDITORÍA: si se le pasa una landing ya hecha (HTML, archivo o URL) y se pide revisarla, corregirla, mejorarla o saber qué está mal, la audita contra sus propias reglas y devuelve el diagnóstico priorizado más los bloques corregidos completos; NUNCA pregunta al usuario qué cambiar, porque el criterio está en la skill. Usar cuando el usuario quiera la landing como archivo único para publicar (se encadena con publicar-landing). Para widgets de Elementor usar landing-b2b-copy-html.

diegogwork1-alt/flowboost-skills-landing

Flujo COMPLETO 2-en-1 para una landing de conversión de respuesta directa (B2B / servicios) — sección por sección, primero ESCRIBE el copy (Ogilvy + Ecuación de Valor de Hermozi + Life Force 8, estructura de 18 instrucciones con variantes V1/V2) y, SOLO tras la aprobación del usuario, entrega el HTML maquetado para Elementor (esqueleto de 18 bloques 0-17). También funciona en MODO AUDITORÍA: si se le pasa una landing ya hecha (HTML, archivo o URL) y se pide revisarla, corregirla, mejorarla o saber qué está mal, la audita contra sus propias reglas y devuelve el diagnóstico priorizado más los bloques corregidos completos; NUNCA pregunta al usuario qué cambiar, porque el criterio está en la skill. Usar cuando el usuario quiera copy Y maquetación juntos de una landing de conversión, con aprobación por sección. Para solo copy o solo HTML, usar las skills sueltas.

diegogwork1-alt/flowboost-skills-landing

Maqueta en HTML/CSS (para widgets de Elementor/WordPress) una landing de conversión de respuesta directa siguiendo el esqueleto maestro de 18 bloques (0-17): Header solo-logo, Hero (headline + 3 bullets + CTA + quita-miedos), franja de logos, Punto de Dolor (PAS), Prueba Social repetida ×3, Value Props ×3 alternadas, Diferenciadores (grid o tabla comparativa), Cómo Funciona (3 pasos), Equipo y Garantía opcionales, Formulario de captura (Tally), FAQ, Recap final con cierre, Footer. El COPY lo aporta el usuario (normalmente su GPT de copy); esta skill NO redacta copy ni inventa datos — lo coloca en los esqueletos, bloque por bloque. También funciona en MODO AUDITORÍA: si se le pasa una landing ya hecha (HTML, archivo o URL) y se pide revisarla, corregirla, mejorarla o saber qué está mal, la audita contra sus propias reglas y devuelve el diagnóstico priorizado más los bloques corregidos completos; NUNCA pregunta al usuario qué cambiar, porque el criterio está en la skill. Usar cuando el usuario quiera maqueta...

diegogwork1-alt/flowboost-skills-landing

Flujo COMPLETO 2-en-1 para la landing de UN INMUEBLE CONCRETO en venta (piso, villa, chalet), con la estructura exacta de cliente-06.es ya publicada en producción (copiada como referencia, sin dato de conversión que la valide): hero de estilo de vida, galería por estancias, formulario temprano, ficha con precio, el entorno como argumento propio, cómo visitar en 3 pasos, el agente como autoridad, FAQ y cierre. Sección por sección escribe primero el COPY y, tras la aprobación, el HTML, pasando cada bloque por las skills de diseño impeccable, design-taste-frontend y emil-design-eng. El CTA es SIEMPRE la visita, nunca la compra. En cada corrección devuelve el HTML COMPLETO de la sección, nunca fragmentos. Aplica los mismos estándares de generación de código que el resto de skills de landing: embebido de Tally sin altura reservada, reglas de arquitectura CSS con !important y doble clase, PageSpeed/Core Web Vitals (LCP, CLS 0, lazy en toda foto que no sea el hero, WebP <250 KB), checklist de código por bloque y ...

diegogwork1-alt/flowboost-skills-landing

Crea una landing VSL de respuesta directa de 9 bloques (0-8) con el FORMULARIO ARRIBA (Hero VSL, Formulario, Dolor PAS, Sistema/Value props, Reseñas, Método 3 pasos, Autoridad/Equipo, FAQ, Cierre + CTA), PRIMERO el COPY y, cuando el usuario lo aprueba, el HTML/CSS para widgets de Elementor/WordPress. Todo en una sola skill self-contained. El copy usa Ogilvy + Ecuación de Valor (Hormozi) + Life Force 8 + PAS + CRO tráfico frío; la maqueta usa tokens de marca (tema oscuro por defecto), VSL Panda autoplay-mudo, Tally inline de carga inmediata, imgs con width/height y a11y. NO inventa testimonios/cifras/fechas/garantías. Aplica los mismos estándares de generación de código que el resto de skills de landing: arquitectura CSS con !important y doble clase, embebido de Tally sin altura reservada, params obligatorios del VSL, PageSpeed/Core Web Vitals, checklist de código por bloque, lista de errores ya cometidos en producción, y paso obligatorio de cada bloque por impeccable, design-taste-frontend y emil-design-en...

diegogwork1-alt/flowboost-skills-landing

Crea una landing VSL de respuesta directa de 9 bloques (0-8) con el FORMULARIO ARRIBA y entrega UN SOLO archivo index.html listo para publicar, no widgets de Elementor. Escribe primero el COPY sección por sección (Ogilvy + Ecuación de Valor + Life Force 8 + PAS + CRO tráfico frío) y, tras la aprobación, la maqueta; al final ensambla todo en un index.html completo y ofrece encadenar con publicar-landing. Hero VSL con autoplay mudo, Tally inline arriba, tema oscuro con tokens de marca. NO inventa testimonios, cifras ni garantías. Aplica los mismos estándares de generación de código que el resto de skills de landing: arquitectura CSS con !important y doble clase, embebido de Tally sin altura reservada, params obligatorios del VSL, PageSpeed/Core Web Vitals, checklist de código por bloque, lista de errores ya cometidos en producción, y paso obligatorio de cada bloque por impeccable, design-taste-frontend y emil-design-eng. También funciona en MODO AUDITORÍA: si se le pasa una landing ya hecha (HTML, archivo o ...

diegogwork1-alt/flowboost-skills-landing

Maqueta en HTML/CSS (para widgets de Elementor/WordPress) una landing VSL de respuesta directa de 9 bloques (0-8) con el FORMULARIO ARRIBA (justo después del hero, todos los CTA anclan ahí): Hero VSL (logo + reseñas + H1 + subheadline + video VSL de Panda + CTA + quita-miedos + logos de prensa), Formulario (Tally inline), Punto de Dolor (PAS), Sistema/Value props (lista), Reseñas (widget de prueba social), Método/Cómo Funciona (3 pasos), Autoridad/Equipo, FAQ (con pregunta que descalifica), Cierre + CTA final. El COPY lo aporta el usuario; esta skill NO redacta copy ni inventa datos — lo coloca en los esqueletos, bloque por bloque. Tema oscuro por defecto (tokens de marca). También funciona en MODO AUDITORÍA: si se le pasa una landing ya hecha (HTML, archivo o URL) y se pide revisarla, corregirla, mejorarla o saber qué está mal, la audita contra sus propias reglas y devuelve el diagnóstico priorizado más los bloques corregidos completos; NUNCA pregunta al usuario qué cambiar, porque el criterio está en la ...

diegogwork1-alt/flowboost-skills-landing

Crea la página de Gracias (Thank You Page / TYP) de un cliente, la que se muestra después de enviar el formulario. Define la ESTRUCTURA fija que debe tener, la personalización por parámetros de URL (nombre y respuestas del formulario), el WhatsApp que INICIA el lead (para no quemar el número), las reglas de código para pegar en Elementor/WordPress, la publicación (noindex + slug) y exactamente qué poner en la URL de redirección de Tally según los campos del formulario. El diseño (colores, fuentes, logo) va según cada cliente; la estructura y la lógica son siempre iguales. Usar cuando Dirección pida "armá la página de gracias / TYP de <cliente>", "hacé la thank you page", o después de publicar una landing con formulario.

相关技能