Communitygithub.com

ChuchoMonster/claude-code-skills

端到端流水线:输入一个URL,自动生成带品牌化英雄背景视频的着陆页改版,并部署到Netlify上。四步串联,中间无需任何澄清提问。

claude-code-skills 是什么?

这是一个针对AI编程助手(如Claude Code)设计的技能,能够从单个URL开始,自动完成完整的品牌化着陆页生成与部署流程。其核心价值在于零人工干预:只需提供参考网站URL,技能便会依次执行品牌手册提取(包括自动发布到GitHub)、基于Nano Banana 2生成静态图像、利用Seedance 2将图像转换为7秒循环英雄视频、构建前端页面,最后通过Netlify CLI部署到生产环境。该技能支持多个站点共存于同一父项目下,每个站点文件独立存放在 `sites/<slug>/` 目录,并拥有独立的Netlify站点。关键步骤具备缓存机制,避免重复计算消耗API额度。该技能特别适合需要快速原型设计、设计对比或品牌一致性检查的开发者,能够极大缩短从设计参考到可部署页面的周期。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ChuchoMonster/claude-code-skills/tree/HEAD/skills/animated-website

在你喜欢的 AI 中提问

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

文档

动画网站流水线

端到端 — 输入URL,输出已部署的Netlify URL。四步走,中间无需提示。所有输出均按 $PWD/sites/<slug>/ 命名空间存放,以便多个站点在同一个父项目中共存。

触发条件

  1. 从用户消息或 $1 参数中提取URL。如果没有URL,询问一次后停止。否则静默继续。
  2. 从URL主机名推导slug和站点名称:
    • 主机 acmegrowthpartners.com → slug acme-growth,站点名称 Acme Growth Partners(首字母大写)
    • 去掉 www.,去掉顶级域名,将点替换为连字符,转为小写。对于人类友好的站点名称,基于品牌识别使用合理的首字母大写形式(例如 acmegrowthpartners.com → Acme Growth Partners,而不是 Acmegrowthpartners)。slug 仅用于文件名和URL。
  3. 并行确认前置条件:
    • 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" 并继续。

  1. 运行品牌手册提取器:
    node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand"
    
  2. 读取 sites/<slug>/brand/type-styles.json、sites/<slug>/brand/css-variables.json,并查看 sites/<slug>/brand/reference.png。
  3. 按照品牌手册技能的格式编写 sites/<slug>/brand/typography.md、colors.md、tailwind.snippet.js、README.md —— 先写不一致之处,再写字体层级表、调色板分组、语义命名的 Tailwind 令牌。应用“理性化而非编码化”规则。
  4. 自动发布到 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" 并继续。

  1. 从刚刚编写的品牌手册工件中推导视觉概念:
    • 检查 colors.md 中理性化后的调色板 → 选择主导品牌情感(例如,增长导向的品牌选择轨迹+解锁;暖色调调色板选择温暖+工艺;极简单色选择克制+精确)。
    • 观察 reference.png 中的视觉元素(渐变方向、线条、粒子/纹理处理、几何形状)。
    • 综合一句话的视频隐喻,将品牌的文字定位映射到运动。
    • 这是创意工作——认真对待,不要退回到通用模板。查看截图。
  2. 构建Nano Banana 2 图像提示,作为捕捉循环“之前”节拍的1:1静态图像。引用确切的品牌十六进制颜色代码。以“无文字、无标志、电影感、高级B2B美学”结尾。
  3. 提交给 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" } }
    EOF
    
    捕获 taskId。轮询 https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID> 直到 state == "success"。解析 data.resultJson(它是一个JSON字符串)中的URL。不要下载——保留云URL。
  4. 构建Seedance 提示,作为7秒内的定时节拍。始终包括:
    • 0-2秒:建立(摄像机漂移、氛围)
    • 2-4秒:构建(运动加速/汇聚)
    • 4-5秒:释放(品牌“解锁”时刻——通常是强调色绽放)
    • 5-7秒:解决(回到可循环状态)
    • 结尾:“慢速受控摄像机,无抖动。逼真的光晕物理效果。无文字、无标志。”
  5. 使用云图像URL作为 image_url 提交给 Seedance 2:
    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.json
    
    捕获 taskId。在后台运行轮询循环(run_in_background: true)——典型生成时间为3-5分钟。当通知完成时,直接点击 recordInfo 端点读取 state(bash中的Python轮询解析器不稳定——建议在后台通知后直接使用一次curl)。
  6. 将最终视频下载到 $PWD/sites/<slug>/hero-loop-7s.mp4。

捕获:VIDEO_PATH。

步骤 3 — 前端设计构建(可跳过)

跳过条件: $PWD/sites/<slug>/index.html 存在。记录 "→ site reused from cache" 并继续。(如果用户希望重新构建,他们会删除该文件或在请求中传递 --force。)

这是用户用来与 claude.ai 的 Artifacts 进行比较的工作产品。质量很重要。

  1. 加载前端设计子技能的上下文:
    • 读取 sites/<slug>/brand/tailwind.snippet.js(完整内容)
    • 读取 sites/<slug>/brand/typography.md 和 colors.md(仅理性化摘要)
    • 注意本地视频路径:./hero-loop-7s.mp4(与 index.html 同级——重要:不要使用像旧结构中的 ../references/...)
    • 注意源URL(用于内容/文案参考——页面应该是改版,而不是克隆)
  2. 通过技能工具调用 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 枚举实际模块。不要编造不存在的产品。
  3. 子技能完成后,验证 $PWD/sites/<slug>/index.html 存在并引用了 ./hero-loop-7s.mp4。

捕获:SITE_PATH。

步骤 4 — Netlify 部署

  1. 为此slug创建或重用Netlify站点。使用清晰且稳定的站点名称模式:animated-<slug>(例如 animated-acme-growth)。
  2. 从 $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.app URL)。
  3. 快速烟雾测试: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.app URL。不要试图将五个站点挂载到一个Netlify项目中。
  • KIE托管的图像URL是临时的——在同一会话中提交Seedance任务。
  • data.resultJson 是一个JSON字符串,而不是对象。 解析它。
  • GitHub仓库已存在? 不要失败——只需推送新文件进行更新。
  • 不要自动安装netlify-cli。 如果 command -v netlify 失败,告诉用户运行 npm install -g netlify-cli && netlify login 并停止。
  • 产品名称的品牌保真度 > 创意自由度。 始终使用在线站点上实际的产品/模块名称。在编写页面文案之前运行 WebFetch 进行验证。
  • 品牌手册截图质量对于概念推导至关重要。 如果截图大部分是空的(Cookie横幅覆盖、懒加载部分未渲染),仍然继续——使用类型样式JSON、颜色调色板以及您对该品牌定位的了解来推导概念。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能