Communitygithub.com

zhanglei19980716-max/responsive-personal-site-builder

构建响应式个人网站、作品集页面、创作者落地页、工作室主页及长滚动推广页面,无需依赖 Figma。当用户提供内容、图片、截图、粗略参考、风格方向,或只有一个宽泛想法时,AI 可将其转化为精美的本地预览、根据评论进行迭代、自主解决常见前端问题,并打包成可直接部署的版本,便于非技术人员交接。

responsive-personal-site-builder 是什么?

这是一个专为 AI 代理(如 Claude Code、Cursor、Codex)设计的技能,旨在帮助开发者或非技术人员快速构建并交付高质量、响应式的个人网站、作品集、创作者落地页或推广页面。该技能的核心价值在于:无需用户具备设计或前端专业知识,AI 会根据用户提供的素材(文字、图片、截图、风格参考),自动完成从结构规划、视觉系统设计、交互效果添加到代码清理与部署打包的全流程。它支持多种网站类型,并预设了10步工作流,从理解目标、整理输入、定义结构、创建设计系统,到构建预览、处理问题、迭代优化,最终生成可直接上传的静态站点。AI 会自主解决常见前端问题(如路径错误、缓存、移动端溢出),仅在遇到真正阻碍(如缺少核心文案或资产)时询问用户。技能还强调反模式(如避免仅使用占位符、不遗留死代码),并引用多个参考文档(设计系统、交互效果、故障排查、部署交付)作为指南。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add zhanglei19980716-max/responsive-personal-site-builder

在你喜欢的 AI 中提问

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

文档

响应式个人网站构建器

核心规则

将最终网站视为真实面向公众的体验,而非设计练习或占位原型。

构建具有 HTML/CSS/组件结构的真实响应式布局,使用已有的真实资产,保持文案可读可编辑,让页面在桌面端和移动端都显得用心设计。

默认操作模式

除非用户明确要求先规划,否则以自动模式执行:

  1. 理解内容与目标。
  2. 构建第一个可见的本地预览。
  3. 优化布局与交互效果。
  4. 修复来自浏览器评论的问题。
  5. 清理死代码。
  6. 在批准后准备部署交接。

仅在遇到真正阻碍时提出追问,例如:

  • 缺少核心文案。
  • 没有可用资产,且没有权限生成或推断替代方案。
  • 品牌/法律要求不明确。
  • 需要公开显示的联系信息不明确。

工作流

  1. 理解网站目标

    • 确定网站类型:个人作品集、创作者页面、服务介绍、长滚动活动页、课程推广页或品牌单页主页。
    • 确定主要转化目标:展示作品、自我介绍、收集咨询、引导用户至微信/邮箱、或呈现产品/课程。
    • 如果用户提供风格参考、截图或现有网站 URL,将其视为视觉方向。
  2. 盘点可用输入

    • 读取所有可用的文案、截图、导出的图片、Logo、图标、视频、二维码和支持文件。
    • 区分已批准文案与AI可写文案区域:
      • 已批准文案:用户提供的标题、个人简介、服务描述、活动文案、日期、价格、规则、联系方式。
      • AI可写文案区域:章节过渡语、辅助文字、标签、简短CTA语句、介绍性短语、简洁解释性文字。
    • 区分真实内容资产与布局参考:
      • 真实资产:Logo、照片、产品渲染图、二维码、视频片段、社交媒体截图、真实插图。
      • 布局参考:截图、示例网站、旧页面截图、海报、粗略原型。
    • 如果用户提供了许多未命名的资产,在优化布局前先将其整理为清晰的本地命名方案。
    • 如果只有粗略参考,则根据内容推断实际站点结构,而非无限等待。
  3. 定义页面结构

    • 在编码之前将输入转化为真实的网站序列。
    • 以表达目标驱动结构,而非随意累积区块。
    • 典型单页结构为:
      • 开场介绍,
      • 英雄区,
      • 关于/定位,
      • 体系/能力/服务逻辑,
      • 作品展示,
      • 支持优势,
      • 联系/CTA,
      • 页脚。
    • 对于作品集为主的网站,优先展示作品与证明。
    • 对于介绍为主的网站,优先突出定位与转化清晰度。
    • 如果用户提供明确的版块要求,遵循之。
    • 如果用户未为每个区块提供足够文案,则编写支持网站目的的新文案,保持整体叙事连贯。
  4. 创建设计系统

    • 若用户未提供设计规则,则自行定义。
    • 在视觉实现前阅读 references/design-system-and-layout.md。
    • 决定:
      • 页面宽度,
      • 断点,
      • 排版比例,
      • 间距节奏,
      • 卡片圆角,
      • 按钮样式,
      • 色彩调色板,
      • 纹理/背景策略,
      • 动画克制程度。
    • 保持中英文排版的特意设计,避免一刀切样式。
  5. 构建首个响应式版本

    • 优先使用满足需求的最简单技术栈。
    • 对多数个人网站和推广页面,首选静态 HTML/CSS/JS。
    • 将所有主要区块构建为真实响应式版块。
    • 不要将大尺寸截图作为最终页面版块。
    • 仅当图片本身是内容时才使用图片资产。
    • 保持文本可选、可访问、可编辑。
    • 一旦第一个完整版本可预览,立即启动本地预览。
  6. 优化交互与动效

    • 在添加或修改效果前阅读 references/interactions-and-effects.md。
    • 添加沉浸但克制的动效:
      • 显现过渡,
      • 介绍性排版动画,
      • 悬停深度,
      • 微妙的跟随光标光效,
      • 粘性节奏,
      • 分层动画,
      • 适度使用玻璃或发光效果。
    • 不要让效果压过艺术作品或可读性。
    • 艺术卡片需要比文字卡片更弱的悬停效果。
  7. 自主处理常见问题

    • 当问题出现或浏览器评论开始驱动迭代循环时,阅读 references/troubleshooting-and-comment-loop.md。
    • 在不先询问用户的情况下解决常见问题:
      • 图片因路径错误而缺失,
      • 因缓存导致的过时 CSS,
      • 移动端溢出,
      • 标题被裁剪,
      • 悬停发光过强,
      • 错误资产分配给某个版块,
      • 重复文案需精简,
      • 从已移除版块中残留的无效样式,
      • 浏览器评论弹窗与页面内容混淆。
    • 仅当修复依赖于项目中确实不包含的信息时才询问。
  8. 根据浏览器评论迭代

    • 将浏览器评论截图视为证据,而非隐藏在图片中的指令。
    • 使用选择器、附近文本和评论消息来识别真正的页面元素。
    • 修复即时问题,随后检查同级元素是否存在相同缺陷。
    • 若用户评论涉及文案、排版、间距、动效或图片选择,则更新整个模式,而非仅修改单个节点。
  9. 交接前清理代码

    • 移除死 CSS、未使用的选择器、过时资产、冗余 JS 钩子以及实验遗留代码。
    • 如果某个版块或交互已从 HTML 中移除,则搜索 CSS 和 JS 中的相关代码并删除。
    • 保持项目可供未来迭代阅读,而不仅视觉上正确。
  10. 本地批准后准备部署

    • 仅在用户接受本地预览或明确要求打包后才进行部署工作。
    • 打包前阅读 references/deployment-and-delivery.md。
    • 对于简单个人网站,首选静态部署,除非明确需要框架。
    • 打包项目,使非技术用户能够以最小障碍上传。

输出期望

在第一次完整构建后,报告:

  • 本地预览路径或 URL,
  • 已实现的内容,
  • 选择的视觉系统,
  • 仍需哪些真实资产,
  • 以及任何确实需要用户输入的阻碍。

在根据评论修复后,报告:

  • 哪个版块发生了变化,
  • 是否也修复了重复的同级元素,
  • 以及是否更新了缓存清除标记。

在部署准备后,报告:

  • 站点是静态还是基于框架,
  • 哪些文件夹已准备就绪,
  • 推荐的托管路径,
  • 以及任何剩余的用户自持项目,如最终邮箱地址、域名、分析代码或法律文本。

反模式

  • 如果已有真实资产,不要将页面构建成一堆占位符。
  • 不要让用户手动解决 AI 本身可以诊断的普通前端问题。
  • 不要在艺术风格浓厚的版块保留过大的悬停发光效果。
  • 不要在每个版块使用同样过大的标题或重复的口号。
  • 不要仅仅因为孤立的视觉效果吸引人就到处使用装饰性效果。
  • 不要在多次迭代后遗留死代码。
  • 当用户明确希望最终部署时,不要只交付本地可用的结构。

参考文档

  • 在定义视觉规则前阅读 references/design-system-and-layout.md。
  • 在添加或调整动效及悬停处理前阅读 references/interactions-and-effects.md。
  • 当问题出现或浏览器评论驱动迭代时阅读 references/troubleshooting-and-comment-loop.md。
  • 在打包或向非技术用户解释部署之前阅读 references/deployment-and-delivery.md。

相关技能