Communitygithub.com

Williampannn/用Claude Code搭建你的网站

一个从零到一的Claude Code技能,用于构建你自己的网站——作品集、落地页或博客——完全按照你自己的品味。这是一个过程,而非模板。

用Claude Code搭建你的网站 是什么?

这个Claude Code技能提供了一套完整、可重复的流程,帮助任何人使用Claude Code从零开始构建一个符合个人品味的网站。它强调“人是指挥,Claude是执行团队”的理念,将用户的审美偏好转化为可执行的指令,快速搭建并上线一个初始版本,然后通过持续的迭代循环不断改进。该技能支持多种技术栈(如Next.js、Astro、Vite)和托管平台(如Vercel、Netlify),并提供了详细的阶段指南,从构思和框架搭建到设计语言固化、内容填充、迭代优化和上线发布。其核心价值在于将开发过程中的决策权交还给用户,同时利用AI高效地处理实现细节。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add Williampannn/build-your-website-with-claude-code

在你喜欢的 AI 中提问

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

文档

用Claude Code搭建你的网站 是做什么的?

这是一个过程,而非模板。它教会任何人如何构建一个他们自己会引以为豪的网站——符合自己的品味,包含自己的内容,使用自己选择的技术栈——利用Claude Code作为构建工具。你来提供框架和步骤;他们提供愿景。

一切都基于一个转变:人是指挥,Claude是执行团队。 由他们来决定网站应该是什么感觉,以及什么才算足够好;Claude负责搭建骨架、编写代码、设计样式、验证和发布。你在运行这个技能时的任务是挖掘他们的品味,将其转化为Claude可以执行的指令,快速让网站上线,然后持续循环迭代。

主宰一切的规则: 先让一个真实、丑陋、已上线的网站跑起来,然后再通过你可见的小步骤进行改进。一个第一天就上线并迭代了50次的网站,胜过永远无法发布的杰作。


心态准备(尽早大声说出来)

  • 你指挥,Claude搭建。 用户永远不需要编写代码——甚至不需要知道相关术语。他们描述感受(“更温暖”、“感觉局促”、“太商业化了”),然后指出方向;Claude将其转化为像素。
  • 先上线,后美化。 在设定任何样式之前先部署一个空壳,这样你可以在没什么可破坏的时候调试一次发布流程。
  • 将品味固化为文件。 一旦他们喜欢某个外观,就将其写成一个设计系统,每次会话时他们和Claude都能读取——这能防止网站风格漂移。
  • 小步快跑,所见即所得。 一次只做一个连贯的改动;查看效果;然后提交。那些看不到的大改动往往是网站的坟墓。
  • 形成反馈闭环。 尽早发布,将其展示给真实用户,将他们的反馈直接作为下一个待办事项列表反馈给Claude。
  • 卡住了就问Claude。 下面的每一步——创建账户、修复终端报错、令人困惑的托管平台界面——都可以交回给Claude来解决,而不是自己硬扛。“我从没做过这个,带我一步步来”和“这是我看到的截图”是用户能说的最有用的两句话。

如何使用这个技能

大致按阶段顺序进行,但它们不是僵化的瀑布流程——阶段4(迭代循环)是底层持续运行的引擎:

阶段0 → 1 确定框架并上线 · 阶段2 → 3 打造个性化内容并填充 · 阶段5 → 6 使其令人难忘并倾听反馈 · 阶段4 全程运行。

每个阶段都提供了目标、步骤、一个用户可以直接复制粘贴给Claude的提示,以及一个最常见的陷阱。更深入的内容在参考文件中——当某个阶段变得复杂时,可以查阅它们。

随时可以停止。 一个简洁的单页网站——包含他们的名字、关于他们的一句话、一个链接——就是一个真实、完整的网站。如果用户在阶段4后觉得可以了,那就可以了。阶段5-6是为了让他们想要更多而准备的,并非必须跨越的门槛。


开始之前(Claude可以帮助完成所有这些)

在阶段1之前,用户需要准备好四样免费的东西。所有这些都可以通过请Claude引导他们完成设置——不要假设他们已经完成了任何一项:

  • Claude Code,已安装并在项目文件夹中打开。
  • Node.js + npm(适用于大多数现代技术栈)——Claude可以用node -v检查并安装。
  • 一个GitHub账号(免费)——代码存放的地方,也是托管平台关注的地方。
  • 一个托管平台账号——Vercel、Netlify或Cloudflare Pages(免费套餐很慷慨;有些即使免费也要求绑定银行卡——但个人普通网站不会扣费)。

如果对这些都不熟悉,第一个提示应该是:

我从未设置过任何编码项目。检查我电脑上是否已安装Node.js、npm和git,并带我一步步安装缺少的部分,创建免费的GitHub和[Vercel/Netlify]账号。告诉我具体需要点击哪里,并在每一步等待我完成。

快速开始(一个下午就让网站上线)

如果用户想要立刻获得成就感:

  1. 梳理品味简报。 问五个阶段0的问题;将答案写入一个简短的BRIEF.md。(约15分钟)
  2. 搭建骨架并部署空壳。 选择一个技术栈 + 一个推送即部署的托管平台(如果不确定,就选Next.js + Vercel并继续),使用官方CLI生成起始项目,推送到GitHub,连接托管平台,确认空白网站已在真实URL上线。(约30分钟,第一次时间更长——注册账号和关联GitHub与托管平台会增加约20–30分钟)
  3. 添加护栏文件。 创建AGENTS.md,告诉Claude在编写代码前阅读已安装的框架文档(阶段1)。(约2分钟)
  4. 仅构建Hero区域。 一个页面:他们的名字、关于他们的一句话、一个行动号召,颜色来自简报。在浏览器中查看。(约20分钟)
  5. 微调并提交。 “让标题更大”、“背景更温暖”,提交,推送——网站就上线了。(约15分钟)

现在他们拥有了一个真实URL的真实网站。之后的一切都是改进——这是最简单的部分。 (以上时间假设上述账号已经存在;首次设置会增加时间,这是正常的,不是失败。)


阶段0 — 构思:品味与范围

目标: 在编写任何组件之前,能够用通俗的语言和图片描述网站应该给人的感觉以及需要哪些页面。

步骤

  • 与用户进行访谈。不要急于设计;首先进行挖掘。问这五个问题:
    1. 它是为谁准备的,你想让他们做什么或感受到什么?(雇佣你、购买这个、阅读你的文章、“认真对待我”、“看到我很有趣”)
    2. 用2-3个词描述整体氛围。(“温暖且具有编辑风格”、“简洁且技术感”、“活泼且有趣”、“安静且昂贵”、“暗黑且粗犷”)。引导他们关注感受,而非功能。
    3. 给我看你喜欢的。 2-3个网站的URL,以及截图、情绪板或任何能捕捉这种感觉的图片——大多数人的品味是视觉化的,而非语言化的,所以让他们粘贴图片。另外,提供一个他们讨厌的网站。借鉴结构和氛围,但绝不抄袭内容。
    4. 这个网站必须确保做到的一件事是什么?(文字内容、视觉效果、作品展示、速度快)
    5. 你真正需要哪些页面/部分? 抵制范围蔓延——大多数个人网站只需要首页再加一两个页面。
  • 将答案写入仓库根目录下的BRIEF.md——这是你和Claude共同对照的北极星。如果他们提供了图片,注明每张图片可以借鉴什么。

给Claude的提示

在构建任何东西之前,先对我进行关于我想要的网站的采访。一个个问我:目标访客是谁,我希望他们感受到或做什么;用2-3个词描述氛围;我喜欢的网站(我会粘贴链接和截图/情绪板图片——也请对图片做出反应)加上一个我讨厌的;这个网站必须确保做到的一件事;以及我实际需要的页面。然后将我的答案写入BRIEF.md作为北极星。现在还不要编写任何网站代码。

陷阱: 在没人能描述感觉之前就开始构建。如果他们无法说出氛围或展示图片,Claude会默认使用通用的SaaS模板,之后的每次修复都在对抗这种惯性。先明确感觉——无论通过文字还是图片。


阶段1 — 基础:让空壳网站上线,然后加上护栏

目标: 一个空白但真实的网站,已部署到真实URL并设置了自动部署——这样之后的每个改动都会自动发布——同时加上护栏,确保Claude基于事实信息工作。

你不需要知道怎么做这些。 Claude会给你精确的点击步骤和命令,并等待你完成。当某个屏幕让你困惑时,截图并粘贴回来——这就是整个工作流程,不是失败。

步骤

  • 预先选择技术栈和托管平台(见下表)。优先选择与框架同源的托管平台,这样默认配置就能正常工作。任何选项都可以;最糟糕的选择是花一整天时间做选择。
  • 使用框架的官方CLI生成项目,而非手动搭建。
  • 先部署空白模板。 推送到GitHub,连接托管平台,在修改任何代码之前确认空白网站已上线——这样你可以在没有其他东西会出问题的时候调试发布流程。
  • 如果用户有域名,尽早绑定自定义域名(这才是真正的地址;免费的*.host.app URL是临时的)。DNS——即指向网站域名的那项设置——可能需要几个小时才能生效,因此请尽早开始。还没有域名?托管平台提供的URL是一个很好的起点;以后再购买。
  • 添加事实护栏。 编写一个AGENTS.md(以及一个只包含@AGENTS.md的单行CLAUDE.md),告诉任何AI代理:已安装的框架可能比其训练数据更新,在编写代码前阅读node_modules/<框架>/dist/docs中的真实文档。 这一个文件能防止一整类API幻觉错误。
  • 从一开始就将秘密信息排除在git之外。 .gitignore应排除环境变量文件和构建输出;永远不要提交API密钥或私有地址——将它们放在托管平台的环境设置中。让Claude在初始化仓库时设置好这些。
  • 记录Claude无法推断的部署信息: 生产URL、托管平台、自动部署的分支、确切的仓库slug、任何注意事项。保存到笔记/记忆文件中——通常无法从代码中发现线上域名。
  • 设置本地预览 + 健康检查: 一个运行配置(或文档化的dev命令+端口)和一个单行检查命令,用于确认本地URL返回HTTP 200状态码,这样你可以在推送前查看效果。

决策表——选择一个选项并继续

如果网站是…合理默认技术栈托管平台
作品集 / 个人网站 / 简历Next.js 或 AstroVercel / Netlify
主要是文字 / 博客Astro 或 Next.jsVercel / Netlify
单个落地页 / 营销页面Astro 或 Vite + ReactNetlify / Cloudflare Pages
想用手动编辑的纯文件纯HTML + CSS(无构建步骤)Netlify / CF / GitHub Pages
“我不知道,选个能用的”Next.js + VercelVercel

(最后一行选择Next.js + Vercel仅仅因为这是Claude最熟悉、文档最完善的路径——上面每一行同样都是合理的选择。)

给Claude的提示

使用官方工具创建一个全新的[Next.js / Astro / 纯HTML+CSS]网站,保持起始模板不变,然后带我完成:git init + 首次提交(包含排除环境变量/秘密的.gitignore)、创建GitHub仓库、连接[Vercel / Netlify]以便每次推送到main分支都自动部署。在我们编写任何代码之前,确认空网站已在真实URL上线。然后创建一个AGENTS.md,告诉任何AI代理已安装的框架可能比其训练数据更新,在编写代码前要阅读node_modules/[框架]/dist/docs中的文档,以及一个只包含`@AGENTS.md`的CLAUDE.md。最后,将我的生产URL、托管平台、部署分支和仓库保存到一个笔记文件中。告诉我精确的点击位置,并在每一步等待我。

陷阱: 在部署一次之前就构建整个网站(然后你同时调试代码和发布流程),或者让模型依赖其记忆中的快速变化的框架信息,而不是将其固定在已安装的文档上。

→ 媒体、大小限制、编码命令、验证生产环境:references/PLAYBOOK.md.


阶段2 — 固化你的设计语言

目标: 一个书面的、机器可读的设计系统——颜色、排版、间距、动效、语气——每次会话时用户和Claude都能读取,这样每个新页面都能保持一致风格,而不会漂移成五种略有不同的外观。

在你拥有一个真正喜欢的页面后才做这个,而不是在此之前。你从好的设计中提取系统;而不是凭空发明。

步骤

  • 先用语言描述氛围,然后从氛围推导出每条规则。两个简短的短语;如果两种氛围存在张力,这种张力就成为一条规则。(一次真实构建的短语是“温暖编辑的平静 + 活泼像素工艺”——但一个“安静且昂贵”或“暗黑且粗犷”的网站会定义自己的氛围并推导出非常不同的规则。)
  • 刻意且一致地使用颜色。 克制的调色板——通常只有一个强调色——能保持层级清晰,是安全默认选择。但如果品味是极繁、复古或粗犷的,多色系统也是合理的选择。规则不是“只能有一个强调色”;而是每种颜色都有明确的角色,并且在所有地方以相同方式使用。
  • 颜色应定义为基于角色的token,而不是散布在标记中的十六进制值。将浅色文本和边框表示为一种主要颜色降低不透明度,而不是发明五种几乎相同的灰色。
  • 按角色配对字体,而不是按字体名称(正文/UI、标题/“声音”、等宽、展示)。引用角色,以便日后可以更换实际字体而无需重写。
  • 固定间距节奏和z-index层级,并写明“不要发明新值”。
  • 制定与氛围相符的动效哲学:简单的环境动效用CSS,交互反馈用JS库;将非必要的动效置于prefers-reduced-motion之后。
  • 设定无障碍基准线(这是质量的一部分,而非附加项):正文文本对比度≥4.5:1,真实的标题层级顺序,可见的焦点状态,语义化的地标,有意义图片的替代文本。大胆/暗黑的调色板恰恰是对比度容易失败的地方。
  • 将语气和调性视为设计的一部分来书写——文案本身也是外观的一部分(使用句子格式?活泼?用词简单?没有公司式空话?)。
  • 将系统固化到两个已提交的文件中: 一个散文式的DESIGN_SYSTEM.md(原则+组件配方+构建清单)和一个tokens文件(原始值)。将其标记为仅向前适用——从现有页面提取,不是改造目标——这样Claude就不会“好心”地重构正常工作的代码。
  • 将其纳入上下文: 将DESIGN_SYSTEM.md和tokens文件引用到.cursorrules或AGENTS.md中,并在每次Claude会话开始时提醒:“在设计系统文件中查找角色和值。只有指出新设计不能匹配现有规则时,才能引入新颜色/字体/尺寸。”

给Claude的提示

[BRIEF.md的内容和设计参考URL的总结]
我们已经创建了一个我喜欢的页面。现在帮我将我们在该页面中使用的视觉选择提取到一个`DESIGN_SYSTEM.md`中,包含颜色token、排版角色、间距节奏、动效规则和无障碍基准。同时创建一个CSS变量或JS token文件。标记它是仅向前适用的,不要重构现有代码。

陷阱: 在拥有任何你喜欢的东西之前就设计系统(你会为空荡荡的房间发明规则),或者使系统变得过于规定性——留出空间供未来品味演变。

→ 色彩理论、无障碍对比度、排版比例:references/DESIGN_GUIDE.md.


阶段3 — 填充:将愿景转化为内容

目标: 每个页面都填充了真实、有意义的文字和媒体,这样网站就不仅仅是骨架——它是一个真实的表达。

步骤

  • 从页面结构开始。 使用BRIEF.md列出每个页面/部分,并为每个页面/部分创建占位内容(可以是设计工具中的低保真线框图,或是Markdown大纲)。目标是在开始写作之前看到完整的结构。
  • 写出真实文案。 不要使用Lorem Ipsum。写关于你自己、你的工作、你的想法的东西。如果写作很困难,请Claude根据要点来草拟文本。API副本?Claude可以处理。
  • 添加图片、视频和其他媒体。 照片、截图、gif。确保它们的大小和格式适合网络使用。使用reference/PLAYBOOK.md中的命令来优化、调整大小和转换媒体。
  • 构建导航。 确保用户知道如何从任何地方到达任何地方。添加面包屑、页脚链接、搜索(如果相关)。
  • 检查链接和拼写。 运行工具检查损坏的链接和拼写错误。没有什么比404或错字更破坏专业感了。

给Claude的提示

基于BRIEF.md和DESIGN_SYSTEM.md,帮我写内容:关于/简历页面的两段文字,项目部分的简要描述,以及行动号召。使用简单的词语和与氛围相符的语气。然后添加一些图片占位符并优化它们。

陷阱: 让内容成为事后想法。如果内容不好,再好的设计也没用。或者在写好文案之前就为每个可能的屏幕尺寸进行设计(文案改变布局,所以先写好文案)。


阶段4 — 迭代循环:发布、测试、修补、重复

目标: 一个实时反馈循环,让你不断改进网站——基于真实用户和Claude的建议。

步骤

  • 发布更改。 每次本地迭代后,提交并推送。Vercel/Netlify应该自动部署。(PS:考虑使用preview deployments预览部署功能,这样利益相关者可以在合并前看到更改。)
  • 在真实环境中测试。 在生产URL上使用网站。在不同设备上查看。联系朋友的意见。截图错误。
  • 收集反馈。 有两个渠道:直接(“我在手机上看到了这个……”)和隐式(分析——人们点击哪里,他们会在哪里离开?)。即使是plausible.io(或Google Analytics)的基本设置也能提供洞察。
  • 创建待办事项列表。 将反馈转化为Claude的下一个任务。优先处理那些最大程度改善用户体验(或转化率)的问题。
  • 重复。 修复一个问题。部署。测试。继续。每次迭代都应该感觉网站变得更好了一点点。

给Claude的提示

我收到了关于[具体问题/功能]的反馈。查看当前代码和设计系统,并提出实现此更改的计划。尽可能保持小改动。完成后,我将提交并部署。

陷阱: 陷入完美主义。一次只修复一件事。如果某件事感觉“太大”,将其分解。并且在让你感到尴尬之前就将其呈现在真实用户面前(早期反馈是无价的;完美主义是敌人)。


阶段5 — 使其令人难忘

目标: 提升体验,使其在人群中脱颖而出——通过动效、个性化和“我是谁”的细节。

步骤

  • 添加氛围。 细微的悬停效果、微妙的视差滚动、加载后的过渡动画。不要过度——应该增强而非分散注意力。
  • 塑造个性。 这些细节定义了你是谁:自定义头像插画、个人轶事、你使用的字符(标准问候语?用一些微妙的幽默?)。
  • 优化性能。 图片应该及时加载。代码应该经过压缩。网站应该能快速交付。如果它很慢,人们就不会留下来。
  • 优化SEO和社交媒体分享。 当你分享链接时,它会显示什么?确保Open Graph标签设置正确。

给Claude的提示

我想让我的网站更令人难忘。查看DESIGN_SYSTEM.md中的动效规则,并为英雄标题添加一个细微的悬停效果。此外,优化主图以获得更快的加载速度,并确保OG标签设置为在社交媒体上良好显示。

陷阱: 为了“酷”而添加动效,而不是为了清晰。动效应该引导眼睛并传达状态;如果只是装饰,它会减慢体验速度。


阶段6 — 发布:上线并推广

目标: 将网站交给世界——并确保它能被找到。

步骤

  • 最终检查和测试。 在不同浏览器和设备上检查损坏的链接、错字、性能。使用reference/PLAYBOOK.md中的playbook。
  • 设置分析。 了解谁在访问以及他们在做什么。(Plausible、Fathom、Umami、Google Analytics)。
  • 创建Sitemap。 提交给Google Search Console以便索引。
  • 配置自定义域名(如果尚未设置)。 确保其正确重定向(www vs non-www)。(PS:考虑在DNS提供商处添加A/AAAA记录,而不仅仅是CNAME,以获得更多控制权。) 获取SSL证书(大多数托管平台会自动完成)。
  • 分享。 告诉世界。在社交媒体上发布。添加到你的邮件签名。更新LinkedIn。
  • 监控。 设置基本正常运行时间监控或至少检查错误日志。

给Claude的提示

帮我为我的网站创建Sitemap,提交给Google Search Console,并在分析工具中设置基本追踪。此外,确保我的自定义域名[domain.com]正确重定向并具有SSL。然后创建一个简短的发布公告推文/帖子。

陷阱: 认为发布就是结束。发布是开始。持续更新、修复和成长。一个静态的网站是一个枯萎的花园。

→ 检查清单、域名配置、SEO:references/PLAYBOOK.md.


这个技能教了什么

到结束时,用户将完成:

  • 成功使用Claude Code和真实的技术栈——无需自己编写代码。
  • 通过迭代而非规划来构建真实的审美决策肌肉。
  • 知道如何调试和发布——全部通过将错误提示粘贴给Claude。
  • 拥有一个他们喜欢且真实用户使用的网站。
  • 理解基本的设计系统、性能和SEO。

他们带走的不是模板,而是一个过程——他们可以一次又一次地使用它。

这个技能是关于将权力从“编码知识”转移到“审美决策”和“有效提示”——这是AI时代的人应当做的。

最终检查: 三人一组的最后,他们是否能够开始一个新项目并自己构建一些东西?(即使借助AI的帮助)如果做到了,我们就成功了。


参考文件

(这些文件是可选资源;根据需要引用它们。)


完整资源

资源链接谁可能使用它
Playbook (媒体、编码、归因)references/PLAYBOOK.md开发者 / 内容创建者
设计指南 (颜色、配色方案、包容性原则)references/DESIGN_GUIDE.md设计师 / 部门负责人
提示 (现成的Claude命令)references/PROMPTS.md用户 / Claude Operator
词汇表 (术语)references/GLOSSARY.md初学者 / 任何人

相关技能