个人作品集网站 · Vibe Coding 全流程实录
这个网站本身
就是一份作品。
它的第一版是一个很无聊的网站:缺乏个人风格。
问题不在 AI,在我没能用语言精确告诉它"我想要什么"。所以我做了四件事:
-
1
重新获取灵感来源
浏览 GitHub、Godly 等大量个人网站素材,提炼吸引我的网站在字体、配色、布局、交互、记忆点五个维度的特征。
-
2
编写 design-spec.md
把视觉调性、字体规范、配色 HEX、布局规则、禁止事项写进一份 Markdown 文档,让 AI 每次写代码前先读它,减少 AI 幻觉和不必要的沟通消耗。
-
3
编写 website-bible.md
另起一份 Markdown,定义网站的页面结构、叙事调性、每一页要放什么、每一段文字怎么写——把"我想说的"和"我想看到的"彻底分开管理。
-
4
让 Claude Code 同时读取两份文档再生成代码
每次迭代前先让模型重读 spec 和 bible,再让它写代码。错了就改 Markdown 再让它重读,不让它"凭感觉发挥"。
踩坑记录 · 展开查看
a. Contact 链接踩坑:
点击导航菜单的 contact 没有反应。和 AI 来回对话排查,最终定位到菜单 JS 对所有链接统一做了 preventDefault(),把 mailto 也一起拦截了。AI 建议加协议判断绕过,但 mailto 在没有邮件客户端的设备上本身就打不开。最终我选择改成点击直接复制邮箱到剪贴板,任何设备都能用。
b. 地图板块踩坑:
耗时最多的板块。第一版让 AI 生成 SVG 地图,结果完全无法用。
换成从 GitHub 下载开源 SVG 内联,轮廓对了,但坐标一直偏:和 AI 反复调试,经纬度换算偏移,getBBox() 在 file:// 下返回错误值,百分比定位也因投影方式不同而失准,每条路都走不通。最终我换了思路,图片底图加百分比热区,坐标问题直接消失。
工具链Cursor · Claude Code · GitHub
这个项目让我明白:对 AI 工具来说,最稀缺的能力不是写代码,而是用语言对齐颗粒度。这恰恰是中文系训练我做的事,精准表达需求也是我擅长做的事。