动画网站流水线
端到端 — 输入URL,输出已部署的Netlify URL。四步走,中间无需提示。所有输出均按 $PWD/sites/<slug>/ 命名空间存放,以便多个站点在同一个父项目中共存。
触发条件
- 从用户消息或
$1参数中提取URL。如果没有URL,询问一次后停止。否则静默继续。 - 从URL主机名推导slug和站点名称:
- 主机
acmegrowthpartners.com→ slugacme-growth,站点名称Acme Growth Partners(首字母大写) - 去掉
www.,去掉顶级域名,将点替换为连字符,转为小写。对于人类友好的站点名称,基于品牌识别使用合理的首字母大写形式(例如acmegrowthpartners.com→Acme Growth Partners,而不是Acmegrowthpartners)。slug 仅用于文件名和URL。
- 主机
- 并行确认前置条件:
npx playwright --version(品牌手册提取依赖)grep -l KIE_AI_API_KEY "$PWD/.env" || grep -l KIE_AI_API_KEY "$HOME/<your-project-dir>/.env"(KIE.ai API 密钥)command -v netlify(Netlify CLI,用于部署步骤)mkdir -p "$PWD/sites/<slug>"
如果任何前置条件失败,明确指出问题并停止。不要尝试安装 Playwright、Netlify 或猜测 API 密钥。
步骤 1 — 品牌手册(可跳过)
跳过条件: $PWD/sites/<slug>/brand/typography.md、colors.md、tailwind.snippet.js、reference.png 全部存在,且 reference.png 在过去24小时内修改过。如果跳过,则记录 "→ brand book reused from cache" 并继续。
- 运行品牌手册提取器:
node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand" - 读取
sites/<slug>/brand/type-styles.json、sites/<slug>/brand/css-variables.json,并查看sites/<slug>/brand/reference.png。 - 按照品牌手册技能的格式编写
sites/<slug>/brand/typography.md、colors.md、tailwind.snippet.js、README.md—— 先写不一致之处,再写字体层级表、调色板分组、语义命名的 Tailwind 令牌。应用“理性化而非编码化”规则。 - 自动发布到 GitHub,无需询问(这会在您的 GitHub 账户下创建一个公开仓库 — 请设置
<your-github-username>,如果不希望发布品牌手册,请删除此步骤):- 仓库名称:
Brand-Book-<TitleCaseSlug>(例如Brand-Book-Acme-Growth-Partners)。单词之间用连字符分隔。 - 使用
mcp__github__create_repository(所有者:<your-github-username>,公开,autoInit: true),然后使用mcp__github__push_files推送所有6个文件(跳过reference.png——文件太大,超出工具参数限制)。 - 如果仓库已存在(创建时返回 HTTP 422),继续——直接调用
mcp__github__push_files进行更新。
- 仓库名称:
捕获:BRAND_REPO_URL,以及来自 colors.md 的理性化后的主色、强调色、中性色、深色表面的十六进制值(您将在步骤3中重新读取这些值)。
步骤 2 — 英雄循环视频(可跳过)
跳过条件: $PWD/sites/<slug>/hero-loop-7s.mp4 存在。记录 "→ hero video reused from cache" 并继续。
- 从刚刚编写的品牌手册工件中推导视觉概念:
- 检查
colors.md中理性化后的调色板 → 选择主导品牌情感(例如,增长导向的品牌选择轨迹+解锁;暖色调调色板选择温暖+工艺;极简单色选择克制+精确)。 - 观察
reference.png中的视觉元素(渐变方向、线条、粒子/纹理处理、几何形状)。 - 综合一句话的视频隐喻,将品牌的文字定位映射到运动。
- 这是创意工作——认真对待,不要退回到通用模板。查看截图。
- 检查
- 构建Nano Banana 2 图像提示,作为捕捉循环“之前”节拍的1:1静态图像。引用确切的品牌十六进制颜色代码。以“无文字、无标志、电影感、高级B2B美学”结尾。
- 提交给 Nano Banana 2:
捕获source "$PWD/.env" 2>/dev/null || source "$HOME/<your-project-dir>/.env" curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @- <<EOF { "model": "nano-banana-2", "input": { "prompt": "<IMAGE_PROMPT>", "output_format": "png", "image_size": "1:1" } } EOFtaskId。轮询https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID>直到state == "success"。解析data.resultJson(它是一个JSON字符串)中的URL。不要下载——保留云URL。 - 构建Seedance 提示,作为7秒内的定时节拍。始终包括:
- 0-2秒:建立(摄像机漂移、氛围)
- 2-4秒:构建(运动加速/汇聚)
- 4-5秒:释放(品牌“解锁”时刻——通常是强调色绽放)
- 5-7秒:解决(回到可循环状态)
- 结尾:“慢速受控摄像机,无抖动。逼真的光晕物理效果。无文字、无标志。”
- 使用云图像URL作为
image_url提交给 Seedance 2:捕获 taskId。在后台运行轮询循环(cat > /tmp/seedance-payload.json <<'EOF' { "model": "bytedance/seedance-2", "input": { "prompt": "<VIDEO_PROMPT>", "image_url": "<CLOUD_IMAGE_URL>", "duration": 7, "resolution": "480p", "aspect_ratio": "16:9" } } EOF curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @/tmp/seedance-payload.jsonrun_in_background: true)——典型生成时间为3-5分钟。当通知完成时,直接点击recordInfo端点读取state(bash中的Python轮询解析器不稳定——建议在后台通知后直接使用一次curl)。 - 将最终视频下载到
$PWD/sites/<slug>/hero-loop-7s.mp4。
捕获:VIDEO_PATH。
步骤 3 — 前端设计构建(可跳过)
跳过条件: $PWD/sites/<slug>/index.html 存在。记录 "→ site reused from cache" 并继续。(如果用户希望重新构建,他们会删除该文件或在请求中传递 --force。)
这是用户用来与 claude.ai 的 Artifacts 进行比较的工作产品。质量很重要。
- 加载前端设计子技能的上下文:
- 读取
sites/<slug>/brand/tailwind.snippet.js(完整内容) - 读取
sites/<slug>/brand/typography.md和colors.md(仅理性化摘要) - 注意本地视频路径:
./hero-loop-7s.mp4(与 index.html 同级——重要:不要使用像旧结构中的../references/...) - 注意源URL(用于内容/文案参考——页面应该是改版,而不是克隆)
- 读取
- 通过技能工具调用
frontend-design:frontend-design子技能。传递一个包含所有内容的独立提示:- 输出路径 -
$PWD/sites/<slug>/index.html(单个文件,自包含)。视频位于其旁边的./hero-loop-7s.mp4。 - 品牌令牌 - 粘贴来自
sites/<slug>/brand/tailwind.snippet.js的完整 Tailwind theme.extend 块。 - 英雄视频 - 使用 src
./hero-loop-7s.mp4作为<video autoplay loop muted playsinline>背景放入英雄区域,并添加深色渐变遮罩以保证文字可读性。 - 源URL 用于内容 - 告诉设计子技能起草
<URL>着陆页的改版:保留价值主张和关键部分(英雄、社交证明、服务/解决方案、CTA、页脚),但提升设计质量、排版层次和动效精致度。 - 质量标准 - “生产级、独特、避免通用AI美学。用户正在将其与 claude.ai Artifacts 的输出进行比较——目标是超越。”
- 技术栈 - 纯 HTML + 通过 CDN(
https://cdn.tailwindcss.com)的 Tailwind + lucide 图标 + Google Fonts。内联 Tailwind 配置以消费品牌令牌。 - 内容真实性 - 如果在线站点有命名的产品/模块/服务,请逐字使用。如果不确定,在编写文案之前使用 WebFetch 枚举实际模块。不要编造不存在的产品。
- 输出路径 -
- 子技能完成后,验证
$PWD/sites/<slug>/index.html存在并引用了./hero-loop-7s.mp4。
捕获:SITE_PATH。
步骤 4 — Netlify 部署
- 为此slug创建或重用Netlify站点。使用清晰且稳定的站点名称模式:
animated-<slug>(例如animated-acme-growth)。 - 从
$PWD/sites/<slug>/部署到生产环境:cd "$PWD/sites/<slug>" && netlify deploy --prod --dir=. --site=animated-<slug> 2>&1- 首次为slug运行时,Netlify会提示该站点不存在。此时,显式创建它:
netlify sites:create --name=animated-<slug>然后重新运行部署。 - 从部署输出中捕获
Website URL:(即实时的*.netlify.appURL)。
- 首次为slug运行时,Netlify会提示该站点不存在。此时,显式创建它:
- 快速烟雾测试:
curl -sI <LIVE_URL> | head -1应返回HTTP/2 200。如果不是,则报告失败但仍显示本地路径。
捕获:LIVE_URL。
最终输出
当所有四个步骤成功后,向用户发送一条简短消息——四个链接,仅此而已:
线上链接 - <LIVE_URL>
品牌手册 - <BRAND_REPO_URL>
英雄视频 - <VIDEO_PATH>
本地站点 - <SITE_PATH>
不要总结构建了什么。不要回顾。不要自动打开本地文件——线上URL才是最终交付物。
常见陷阱
- 不要在运行中途询问用户。 整个要点是零交接。如果确实缺少某些东西(没有URL、没有API密钥、没有Netlify CLI),则指出阻塞原因并停止——不要寻求创意输入。
- 跳过已经运行过的步骤。 所有三个工件步骤通过文件存在性实现幂等。重复执行会浪费信用额度。
- 视频路径必须相对于其同级HTML。 使用
./hero-loop-7s.mp4,而不是../references/...。每个站点完全自包含在sites/<slug>/中。 - 每个站点是其自己的Netlify站点,而不是子路径。 使用
--site=animated-<slug>进行部署,以便获得自己的*.netlify.appURL。不要试图将五个站点挂载到一个Netlify项目中。 - KIE托管的图像URL是临时的——在同一会话中提交Seedance任务。
data.resultJson是一个JSON字符串,而不是对象。 解析它。- GitHub仓库已存在? 不要失败——只需推送新文件进行更新。
- 不要自动安装netlify-cli。 如果
command -v netlify失败,告诉用户运行npm install -g netlify-cli && netlify login并停止。 - 产品名称的品牌保真度 > 创意自由度。 始终使用在线站点上实际的产品/模块名称。在编写页面文案之前运行 WebFetch 进行验证。
- 品牌手册截图质量对于概念推导至关重要。 如果截图大部分是空的(Cookie横幅覆盖、懒加载部分未渲染),仍然继续——使用类型样式JSON、颜色调色板以及您对该品牌定位的了解来推导概念。