Communitygithub.com

JairoBg03/skills

使用自定义设计、动画和代理级效果创建专业落地页。覆盖从简报、设计指导、构建、审核到部署的整个流程,避免千篇一律的AI模板感。技术栈:Astro + Tailwind CSS v4 + GSAP + Lenis。

skills 是什么?

该AI技能旨在帮助开发者构建高度定制化、视觉惊艳的专业落地页,彻底摒弃AI生成模板的“廉价感”。它以“先有简报,后有代码”为核心工作流,通过强制性的六个步骤(简报、设计方向、节架构、构建、审核、部署)确保最终产出具有独特的品牌叙事和交互体验。技能明确指定了技术栈:使用Astro 5生成静态站点保证性能,Tailwind CSS v4通过`@theme`实现设计令牌的集中管理,GSAP (含ScrollTrigger) 和Lenis负责实现代理级的滚动动画和平滑滚动效果,并强调禁止使用任何UI组件库,以保持设计原创性。此外,技能提供了详细的参考文件,包括设计方向指南、动画配方和简报模板,并包含一份严格的交付检查清单(如Lighthouse分数、CLS为0、无障碍标准等),适合需要在客户或产品场景中交付高保真营销页面的开发者。该技能支持在命令行界面(如Claude Code)中通过自然语言触发,专注于Campaign Page、Landing Page、Product Page等类型的页面生成。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JairoBg03/skills/tree/HEAD/landing-pages

在你喜欢的 AI 中提问

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

文档

何时使用

  • 用户需要一个新的落地页(产品、服务、活动、作品集、候补名单)
  • 用户想重新设计现有落地页,使其看起来专业且独特
  • 用户要求在营销页面中添加动画、滚动效果或微交互
  • 用户处于规划阶段:需要确定板块、信息和结构

技术栈(及原因)

组件选择原因被淘汰的替代方案
框架Astro 5默认静态(基础JS为0)、组件化、astro:assets处理图片、部署即上传dist/Next.js(用于落地页过于复杂,部署更繁琐)、纯HTML(无组件和优化)
样式Tailwind CSS v4通过CSS中的@theme自定义令牌、无需JS配置、自动摇树UI组件库(shadcn/DaisyUI/Flowbite → 模板化外观)、纯CSS(迭代速度慢)
动画GSAP 3.13+ (ScrollTrigger, SplitText)滚动/时间线动画的行业标准;从v3.13起所有插件免费Framer Motion(绑定React)、AOS(功能有限,容易看出是模板)
平滑滚动Lenis轻量级(约4kb),与ScrollTrigger集成有文档支持Locomotive Scroll(更臃肿,维护较少)
部署Netlify / Cloudflare Pages / Vercel连接仓库 → 推送 → 部署;静态输出,无需服务器VPS(静态站点无需)

硬性规定:不要安装UI组件库。设计必须原创——这正是该技能与模板的本质区别。

工作流程(必须按此顺序)

绝不要从代码开始。未经简报的落地页只是套了层皮的模板。

  1. 简报 — 与用户一起完成 assets/brief-template.md。如果缺少目标、受众或CTA:先提问再继续。
  2. 设计方向 — 遵循 references/design-direction.md:个性 → 字体 → 颜色 → 布局 → 视觉签名。将其具体化为 assets/design-tokens.css。
  3. 节架构 — 在排版前定义叙事弧(下表)和标题文案。
  4. 构建 — 逐节构建,移动端优先(先以390px为准)。动画参考 references/animation-recipes.md。
  5. 审核 — 交付检查清单(见下文)。未通过检查不得交付。
  6. 部署 — 静态构建 + 托管(命令见下文)。

叙事弧(基础结构)

#板块作用
1Hero在<5秒内传达价值主张 + 主要CTA
2问题/背景点出访客能识别的痛点
3解决方案/好处你如何解决——好处,而非特性
4社会认同真实评价、Logo、数据
5运作方式步骤、演示、截图
6异议处理FAQ、保证、价格
7最终CTA重复Hero中相同的单一行动

根据简报调整、合并或删除板块——并非所有落地页都需要这7个部分。

关键模式

  • 单一转化:整个页面引导用户执行一个操作。两个不同的CTA = 简报有误。
  • 真正的移动端优先:首先以390px设计并构建;桌面端是演进,而非逆向。
  • LCP不可触及:LCP元素(Hero的标题或图片)在CSS中绝不可设置为opacity: 0。入场使用gsap.from()(无JS时页面完全可见),且总时长≤1秒。
  • prefers-reduced-motion:所有动画都必须放在gsap.matchMedia()内部。无例外。
  • 最小化Islands:JS仅用于存在真实交互的地方。FAQ手风琴使用<details>,而非水合组件。
  • 图片:始终使用astro:assets(<Image>),AVIF/WebP格式,显式尺寸,除Hero外设置loading="lazy"。
  • 字体:自托管(本地woff2或Fontsource),font-display: swap,最多2种字体族,展示字体预加载。

交付前检查清单

  • Lighthouse移动端 ≥ 95(性能、可访问性、SEO)
  • CLS = 0(图片尺寸、字体回退已调整)
  • 当prefers-reduced-motion: reduce时禁用动画
  • AA对比度:文本4.5:1,大块UI 3:1
  • 键盘可导航、焦点可见、仅一个h1
  • Meta描述、OG标签、favicon、唯一标题
  • 在390px、768px和1440px下测试通过
  • 品牌测试:遮住Logo后,页面是否可能来自其他公司?如果是 → 返回阶段2

命令

# 创建项目
pnpm create astro@latest mi-landing -- --template minimal --typescript strict
cd mi-landing
pnpm astro add tailwind
pnpm add gsap lenis

# 开发与构建
pnpm dev
pnpm build && pnpm preview

# 部署(选择一个;在Netlify/Vercel/Cloudflare中:构建命令 "pnpm build",输出目录 "dist")
npx wrangler pages deploy dist        # Cloudflare Pages 直接部署
npx netlify deploy --prod --dir=dist  # Netlify 直接部署

资源

相关技能