给会用 AI、但不会写代码的你

你负责说人话,
AI 负责写代码。

你已经用 Codex、Claude Code、Google AI Studio 做出过网站——这说明你缺的从来不是编程能力,而是一套完整的「氛围」:看得懂设计风格、说得出专业术语、走得通上线流程、写得好提示词。从入门到进阶,七个章节逐步补齐。

22种设计风格与提示词
54条氛围编程术语
9站完整上线流程
0行需要背的语法
"帮我做个网站"
✦ 设计 token + Bento 网格
npm run dev ▸ 本地跑起来了
git push → Vercel 部署成功
🚀 上线!
01

前端风格图鉴

STYLE ATLAS · 每种风格都是一段可以直接抄给 AI 的话

从 10 种扩展到 22 种设计方向。先看小样识别视觉差别,再看适用场景,最后把“怎么跟 AI 说”复制过去。已有小样可点击体验;新增小样重点展示配色、排版与材质。

先定一个主风格,再补具体细节。风格名是索引,配色、字体、布局、材质和动效才是画面。下面把设计流派、设计系统、布局方式和视觉气质放在一起,方便选用;它们不是互斥分类,也不是流行榜单。

把喜欢的风格,说给 AI 听。

填用途 → 选风格 → 复制提示词。默认只调整现有页面的设计,适合继续优化自己的网站。

PROMPT WORKSHOP

      
更换选项后,提示词会自动更新。
只会说“高级一点”?把感觉换成这几句话。

“高级一点” → 字体与留白标题只保留一个最强层级;正文 16px、行高 1.8;区块间距 48px;全页只用一个强调色,去掉多余阴影和装饰。

“更清爽” → 信息与密度减少同时出现的按钮;一张卡片只讲一件事;弱化次要信息;统一左右边界与间距,手机改为单栏。

“科技感” → 材质与色彩用深灰背景、清楚的浅色正文、一个蓝色强调色和 1px 细边框;只在首屏加少量光晕,不要给所有文字发光。

“温暖一点” → 颜色与形状用米白背景、深绿正文、陶土色强调;卡片圆角 16px;标题有书卷气,正文易读;避免大片高饱和色。

有参考图时:把截图一并发给 AI,指出“借用它的标题比例、配色与留白,保留我自己的内容”。仅报网站名容易理解不一致。混搭时:明确“瑞士排版做主风格,只在功能展示区用 Bento 布局”,不要一次堆四五个互相冲突的风格。

第一次沟通可以这样收尾:“先复述你理解的设计方向,再做一个可预览的版本;完成后检查手机布局,把预览和修改点给我看。”这能减少理解偏差,但仍需要你看实际效果。

共 22 种风格

LESS IS MORE

极简主义 Minimal

把一切装饰砍到只剩内容本身:大留白、少颜色、克制的字体层级。看似什么都没做,其实每个像素都经过了争吵。苹果官网是祖师爷。

适合:作品集、高端品牌、摄影/设计展示、内容阅读型产品——想让内容自己发光的一切场合。
做一个极简风格的个人作品集网站:大留白、黑白灰主色、无多余装饰、衬线大标题,参考 Apple 官网的克制感。
留 白 即 态 度
MINIMALISM
FROSTED GLASS

玻璃拟态 Glassmorphism

半透明磨砂玻璃质感:背景是彩色渐变或模糊光斑,卡片像一块块浮在彩色雾气上的毛玻璃。Apple 的 iOS 风潮带火的,高级、轻盈、有未来感。

适合:SaaS 仪表盘、登录页、工具类产品首页——需要"科技感但不冰冷"的场合。卡片自带悬浮动画。
用玻璃拟态风格做一张数据卡片:半透明白色磨砂背景、backdrop-filter 模糊、圆角 20px、悬浮彩色渐变光斑背景,hover 时轻微放大。
📊 本月活跃用户

较上月 +23.4% · 玻璃质感让数据也变轻盈

REAL-LIFE TEXTURE

拟物 Skeuomorphism

把现实世界的材质搬进屏幕:纸张的纹理、旋钮的立体、皮革的缝线。2010 年代苹果带火又亲手埋葬,如今以"新拟物(Neo-Skeuomorphism)"的身份回潮——用于点缀复古与手工感。

适合:复古主题、音乐/音频产品、拟真小部件。慎全站使用,容易显得"老"。试试拧一下右边的旋钮。
做一个拟物风格的便签卡片:米黄纸张渐变、内阴影立体感、轻微旋转 1.5 度、衬线手写感字体,像贴在桌上的一张真实便签。
今天的待办:
让 AI 写个网站,然后假装是自己写的。
SOFT UI

新拟态 Neumorphism

元素从背景里"长"出来:同一颜色的背景,靠柔和的双向阴影做出凸起/凹陷。像一块软软的橡皮泥。2019 年爆红,如今适合做控件与设置面板的点缀质感。

适合:音乐播放器、设置面板、计算器等控件密集界面。注意对比度别太低,可访问性是它的老毛病。按住右边的按钮试试。
用新拟态风格做一组控制按钮:浅灰背景、双向柔和阴影(凸起),按下时切换为内凹阴影,参考 Soft UI 的橡皮泥质感。
FLOWING COLOR

渐变 Gradient

两种以上颜色自然过渡,2023 年起被 Linear、Stripe 玩出新高度:深色底 + 大面积流动渐变 + 发光边缘,是当下 AI 产品最爱穿的"战袍"。

适合:AI/科技产品落地页、开发者工具、发布会页面——需要一眼"贵"的场合。渐变文字配深色背景是无敌组合。
做一个深色背景的 AI 产品落地页:流动的多彩渐变大标题(background-clip: text),渐变发光按钮,参考 Linear 和 Stripe 的质感。
流光溢彩
BENTO BOX

Bento 网格

像日式便当盒一样,把信息切成大小不一的圆角格子拼在一起:有大有小、错落有致、一格一事。Apple 发布会页面的御用排版,2024 年起席卷整个科技圈。

适合:产品功能展示、个人主页、数据概览。格子内容可以是文字、数字、图表任意混搭,天然适合"吹功能"。
用 Bento Grid 布局做产品功能展示区:12 列网格、大中小格子错落拼贴、圆角 24px、每格一个功能点配图标,参考 Apple 发布会页。
🤖 AI 代码生成
一句话 → 一个应用
⚡ 3 秒
生成首屏
54
个术语词条
🔒 安全
📈 一次学会,终身受用
MAGAZINE LAYOUT

Editorial 杂志排版

把网站当一本高级杂志来排:超大衬线标题、分栏正文、首字下沉、细线分隔、编号章节。2024–2025 年内容型网站的顶流风格,"知识分子感"拉满。

适合:博客、独立媒体、深度内容站、品牌故事页。文字多反而越好看,是内容创作者的最佳战衣。
用杂志编辑排版风格做一个博客首页:超大衬线标题、两栏正文、首字下沉、章节编号、细分隔线,像《纽约客》的数字版。
EDITORIAL · VOL.01
把网页排成一本杂志
衬线字体是这个风格的主角,标题大到失焦、正文分栏对齐。首字下沉是它的仪式感,如同翻开一本纸质刊物的第一页。留白与文字密度之间的张力,正是编辑排版的呼吸感所在。
DARK MODE

暗黑模式 Dark Mode

不是"把背景改黑"那么简单:深灰而非纯黑、低饱和霓虹点缀色、发光态强调。开发者工具和 AI 产品的默认皮肤,程序员看了会心一笑的"自己人暗号"。

适合:代码工具、AI 产品、开发者社区,以及一切"夜里用得多"的应用。右边的开关是真的,拨一下。
做一个暗黑模式设置面板:深灰背景(#16191e)而非纯黑、低饱和霓虹绿强调色、圆角卡片、开关用发光态,参考 Vercel 控制台。
深色界面Deep gray, not pure black
霓虹强调色Neon accent #3fe1a8
发光开关态Glowing toggle state
3D / WEBGL

3D / WebGL 氛围

用 Three.js 等 3D 引擎渲染沉浸式场景:漂浮的几何体、景深光斑、可拖拽的星球。2024–2025 年 AI 编程工具(v0、Lovable、bolt)已能直接生成,是"哇塞感"性价比最高的路线。

适合:产品首屏英雄区、活动页、元宇宙概念产品。做整站太重,做首屏氛围刚好。晃晃右边的卡片。
首屏做一个 3D 氛围英雄区:Three.js 渲染漂浮的发光几何体与景深粒子,鼠标移动时轻微视差,背景深紫渐变,参考 Lovable 官网首屏。
深度,是可以摸到的

鼠标在此区域滑动 · 卡片实时 3D 透视跟随

LOUD & PROUD

新粗野主义 Neo-Brutalism

故意的"糙":粗黑边框、硬阴影、高饱和撞色、歪斜排版。像小孩用马克笔画的,但每一处"错误"都是故意的。Gumroad 带火,2024 年在独立工具圈疯狂流行。

适合:独立开发者工具、创意社区、想要"反精致"人设的品牌。它是极简主义的反义词,性格外向者的选择。
用新粗野主义风格做落地页:亮黄背景、3px 纯黑粗边框、6px 硬投影(无模糊)、高饱和撞色、标题轻微旋转,参考 Gumroad。
NO BORING UI
LOUD!
GRID & TYPE

瑞士国际主义 Swiss Style

靠网格和文字建立秩序:左对齐的无衬线大标题、清晰的比例、少量红色。和极简的区别是更强调对齐、信息结构与不对称构图。

适合:知识导航、课程目录、设计作品集。信息可以很多,但所有内容要有共同的对齐线。
可用关键词:瑞士国际主义 / Swiss Style / International Typographic Style
请采用瑞士国际主义 Swiss Style的视觉方向设计页面。白色 #fafafa 为底、黑色 #171717 为文字、红色 #df3228 只强调关键位置;标题用粗无衬线,正文用清晰的中文无衬线;桌面采用严格网格与不对称两栏,内容左对齐,细线分区;方角、基本无阴影;动效只做 160ms 的颜色变化。 不要把极简做成所有内容居中;不要为了视觉错位打乱手机阅读顺序。
COLOR & FEEDBACK

Material 清晰交互

这是一套设计系统的视觉方向:有层次的表面色、语义明确的主按钮、圆润组件与清楚的状态反馈。适合需要持续操作的应用。

适合:待办、日历、学习打卡、手机工具。比起装饰,重点是用户一眼知道哪里能点、点后发生什么。
可用关键词:Material Design 3 / 色彩角色 / 状态层 / 层级表面
请采用Material 清晰交互的视觉方向设计页面。采用 Material Design 3 的视觉原则:浅紫灰 #f5f2fa 为底、紫色 #6750a4 为主色、深灰 #211c28 为正文;用无衬线字体与清晰的标题/正文/标签层级;卡片圆角 20px,主按钮为实心胶囊形;通过表面色和轻阴影区分层级;按钮有按下、焦点、禁用状态,反馈约 200ms。 不要把 Material 理解成给所有卡片加大阴影;不必为了外观更换现有技术栈或安装组件库。
今日学习

慢慢来,也会到达。

✓ 阅读一节新知识
DENSE BUT CLEAR

企业工作台 Enterprise UI

一种适合业务工具的实用方向:中性配色、侧栏导航、紧凑表格、统一间距和清楚的状态。与展示页相比,它把操作效率放在首位。

适合:后台管理、资料库、数据看板、文件管理。数据密集时也能快速查找、筛选和比较。
可用关键词:Enterprise UI / Admin Dashboard / 企业后台 / 数据密度
请采用企业工作台 Enterprise UI的视觉方向设计页面。浅灰 #f4f4f4 背景、白色内容区、深灰文字、蓝色 #0f62fe 强调主要操作;采用中性无衬线字体、8px 间距节奏、小圆角 4px;桌面侧栏 + 顶部操作区 + 表格,表头、状态和筛选层级明确;手机将侧栏收进菜单,表格转成带字段标签的列表;不要依靠阴影区分所有区域。 不要把每条数据都装进大卡片;不要在手机上保留固定宽度的桌面侧栏。
TEXT IS THE INTERFACE

终端风 Terminal

把命令行的表达方式用于网页:等宽文字、命令提示符、线框分区、少量绿色或琥珀色。它可以是正常的网页,不要求用户真的输入命令。

适合:开发者主页、工具集合、技术笔记。气氛来自文字和秩序,别用花哨动画遮住内容。
可用关键词:Terminal UI / CLI Aesthetic / Monospace / 命令行美学
请采用终端风 Terminal的视觉方向设计页面。近黑 #101510 背景、浅灰 #e5eee5 正文、绿色 #86efac 点缀;英文和数字用等宽字体,中文用清晰的系统字体回退;采用命令提示符与日志式列表、1px 线框、方角;主操作仍是明确的网页按钮;光标闪烁只用于装饰且在减少动态模式下停止。 不要强迫普通用户记命令;不要用低对比度的暗绿色做正文。
SAVE YOUR PROGRESS

像素游戏 Pixel / 8-bit

把游戏中的像素边缘、格子和等级感搬进学习工具。方块边框与阶梯式阴影比“套一款游戏字体”更能说明风格。

适合:小游戏、学习闯关、打卡进度。正文仍用易读字体,像素字体只适合少量英文标题或数字。
可用关键词:Pixel Art UI / 8-bit / 像素风 / 方块边缘
请采用像素游戏 Pixel / 8-bit的视觉方向设计页面。深蓝 #202b52 为底、浅黄 #fff2b2 为文字、珊瑚红 #ff786b 为主操作;方角、阶梯边缘、4px 无模糊投影和像素图标;进度用分格条表示;标题与数字可以有像素感,中文正文使用系统无衬线;触屏操作有明显按压反馈。 不要把全部中文正文变成小号像素字;不要放自动播放的音效。
学习任务 / LEVEL 03
♥ ♥ ♥

知识 +1

CHROME & DREAMS

千禧未来 Y2K

银色金属、酸性亮色、胶囊形元素和早期数字文化的想象。它和霓虹暗黑不同,也可以在明亮的银白背景上出现。

适合:音乐、潮流、活动页面、年轻创作者主页。把金属效果放在标题和少量图形上,正文保持稳定。
可用关键词:Y2K / 千禧风 / Chrome / 银色金属 / 酸性亮色
请采用千禧未来 Y2K的视觉方向设计页面。银白 #e6e8ef 背景、深紫 #32264c 正文、酸性黄绿 #d6ff44 点缀;大标题可做银色金属渐变,但保持清楚的深色描边;采用胶囊按钮、椭圆线框、少量星形图案;正文用无衬线,布局保持明确分区;只给装饰图形小幅浮动。 不要把玻璃拟态和 Y2K 当成同一风格;不要让金属渐变影响正文可读性。
SOFT & PLAYFUL

黏土软糖 Claymorphism

像捏出来的小玩具:饱满圆角、柔和立体边缘、粉彩颜色。与新拟态不同,组件和背景通常有明显的颜色差异。

适合:儿童教育、轻松打卡、可爱的个人小工具。让插画和主卡片柔软,表单与正文保持清楚。
可用关键词:Claymorphism / Clay UI / 黏土风 / 软糖质感
请采用黏土软糖 Claymorphism的视觉方向设计页面。浅蓝 #eaf4ff 背景、桃粉 #ffd3c1 卡片、深蓝 #263958 正文;卡片圆角 32px,组合柔和外阴影与顶部内高光,做出饱满黏土感;标题圆润,正文无衬线;配少量立体几何插画,按钮按下轻缩至 0.98,移动端不依赖悬停。 不要把阴影堆到文字周围;不要因圆润而降低文本对比度或缩小点击区域。
✦
小小进步,也值得记录

今天学会了!

QUIET BY NATURE

自然暖色 Organic / Warm

这是一组气质和材质的组合:米色纸感、鼠尾草绿、低饱和配色、柔和曲线。比纯黑白极简更温暖,适合长时间阅读。

适合:阅读记录、生活方式、植物、慢节奏学习工具。自然感来自色彩和空间,不是塞满叶子图标。
可用关键词:Organic Design / Warm Minimalism / 自然暖色 / 纸感
请采用自然暖色 Organic / Warm的视觉方向设计页面。米色 #f5f0e6 背景、深绿 #354c3f 正文、鼠尾草绿 #a4b49c 配陶土色 #b86f52;标题采用中文衬线,正文清晰无衬线,行高 1.8;布局留白宽松,圆角 16px;低对比度纸纹只做背景,加入少量有机曲线;动效慢而少。 不要用浅棕小字当正文;不要用大量植物装饰替代内容布局。
INK & SPACE

现代中式 Modern Chinese

把东方的留白、纸墨色和文字气质融入现代网页。这里讲的是可实现的视觉方向,避免把“中式”简化成大红大金和龙纹。

适合:诗词、历史、传统文化、茶与文创。标题可以有书卷气,主要内容仍按正常阅读顺序排列。
可用关键词:Modern Chinese Design / 东方留白 / 宣纸色 / 朱红点缀
请采用现代中式 Modern Chinese的视觉方向设计页面。宣纸白 #f6f2e9 背景、墨黑 #242823 正文、朱红 #a6372b 少量点缀;中文宋体或系统衬线用于标题,无衬线用于正文;以横排阅读为主,细线、印章式小标签和水墨抽象图形做点缀;宽松留白,小圆角或方角;手机上保持单栏阅读。 不要全站竖排或铺满龙纹;不要把正文做成无法选择的文字图片。
LESS, BUT REFINED

静奢品牌 Quiet Luxury

低调的高级感来自文字比例、材质与空间。深色底、细衬线、少量香槟金只是其中一种做法,颜色不能替代好的内容。

适合:摄影作品、精品品牌、展览、预约服务。首屏集中展示一件作品或一个明确主张。
可用关键词:Quiet Luxury / Luxury Editorial / 静奢 / 香槟金
请采用静奢品牌 Quiet Luxury的视觉方向设计页面。近黑 #191b19 背景、暖白 #f1e9dc 正文、香槟金 #c5ad7a 仅作细线和按钮点缀;使用优雅中文衬线大标题与无衬线正文,适度字距;大面积留白、少量细边框、避免密集卡片;图片用真实作品,没有图片时保持纯文字;只做短暂淡入。 不要铺满金色渐变、闪光和皇冠;不要为了高级感把正文缩小或变灰。
FORM & FUNCTION

包豪斯几何 Bauhaus-inspired

借用几何、原色与功能秩序的视觉语言:圆、三角、矩形构成醒目的海报感。这里是网页中的设计借鉴,并非完整复现历史流派。

适合:设计展览、创意课程、艺术主页。几何图形有辨识度,但导航和阅读顺序仍要清楚。
可用关键词:Bauhaus-inspired / 几何构成 / 红黄蓝 / 功能优先
请采用包豪斯几何 Bauhaus-inspired的视觉方向设计页面。暖白 #f4efdf 为底,黑色文字,红 #d8382b、黄 #efc335、蓝 #244ac6 为少量几何色块;标题用粗无衬线;桌面采用不对称但对齐的网格、圆形与三角形构成;方角、无复杂渐变和发光;手机按内容顺序堆叠,图形缩放且不遮挡文字。 不要把几何图形压在主要文字上;不要把所有模块都变成撞色装饰。
KEEP THE MOMENT

手账拼贴 Scrapbook

像一页真实手账:纸片、胶带、贴纸、小幅旋转和手写旁注。拼贴用于营造个人感,文章正文保持端正。

适合:日记、旅行记录、摘抄本、个人主页。和杂志排版相比,它更亲近、随性、有手工痕迹。
可用关键词:Scrapbook / Collage / 手账风 / 纸片拼贴 / 胶带
请采用手账拼贴 Scrapbook的视觉方向设计页面。米白 #f4eddf 背景、深棕 #493e34 正文,低饱和黄与粉作点缀;纸片卡片、胶带装饰、虚线框与轻微阴影;局部旋转不超过 2 度,正文不旋转;旁注可有手写感,长文保持无衬线或清楚的宋体;手机减少叠放,纸片按顺序排列。 不要让贴纸遮住文字和按钮;不要为了手账感用难读的手写字体排整篇文章。

延伸阅读:设计系统的原则可参考 Google Material DesignIBM Carbon 网格指南。本页的小样与提示词是教学示例,可按自己的品牌调整。

02

氛围编程词库

VIBE CODING DICTIONARY · 会说黑话,AI 才会认真听

跟 AI 沟通的隐藏规则:你用词越准,它干活越顺。说"帮我调好看点"它只能瞎猜;说"加个微交互、留白不够、上 Bento 布局"它立刻心领神会。这 54 个词条按场景分好类,搜索你遇到的词,抄走提示词用法。

共 64 条 · 全部分类
HTMLHyperText Markup Language
前端基础
网页的骨架。浏览器读它来知道页面上有什么:标题、图片、按钮各就各位。
在提示词里一般不用主动提,但可以说「用语义化 HTML 标签」让结构更规范。
CSSCascading Style Sheets
前端基础
网页的皮肤和化妆师。管颜色、字体、间距、动画——一切「好不好看」都归它管。
说「用 CSS 实现悬浮渐入动效」,而不是笼统的「加动效」。
JavaScriptJS
前端基础
网页的大脑。让页面「动起来」:点击弹出菜单、滚动加载内容、实时计算价格。
一般由框架代劳;需要原生时说「用原生 JS 实现滚动监听」。
响应式设计Responsive Web Design / RWD
前端基础
一套代码自动适配手机、平板、电脑:手机单栏、电脑三栏,字体图片跟着缩放。
必说关键词:「响应式布局,移动端优先」。不说这句,AI 可能只照顾电脑端。
移动端优先Mobile First
前端基础
先设计手机版,再放大到桌面版。因为多数流量来自手机,反着做容易翻车。
和响应式连用:「移动端优先的响应式设计」。
单页应用Single Page Application / SPA
前端基础
整个网站其实只有一个页面,点来点去内容原地切换,不用整页刷新,体验丝滑。
说「做成单页应用(SPA),切换不刷新」。
静态网站Static Site
前端基础
内容写死在代码里的网站:只能看、不能存数据。部署最快最便宜,个人主页首选。
个人展示站直接说「纯静态站即可,无需后端」。
骨架屏Skeleton Screen
前端基础
内容加载前先显示的灰色占位块,像内容的「剪影」。比干等白屏体面得多。
说「加载时显示骨架屏」提升细节质感。
暗色模式Dark Mode
前端基础
深色背景的界面主题。注意:是深灰不是纯黑,强调色要低饱和发光才高级。
「支持暗色模式,深灰底 + 霓虹强调色」。
视口Viewport
前端基础
浏览器里实际显示网页的那块区域大小。手机视口小,所以布局要跟着变。
很少直接说;AI 提到时知道是屏幕可见范围即可。
ReactReact.js
框架与库
2025 年最主流的前端框架。把页面拆成一个个「组件」拼装,AI 生成代码的事实标准。
「用 React 实现」——加上这句,生成代码质量和部署兼容性都更稳。
VueVue.js
框架与库
另一大主流前端框架,国内生态尤其好。和 React 二选一,都能做出一样的网站。
国内项目可说「用 Vue 3 + 组合式 API」。
Next.jsNext.js
框架与库
React 的「全家桶升级版」,自带路由、服务端渲染,做正经产品首选,部署 Vercel 亲儿子。
做完整产品时说「用 Next.js(App Router)」。
ViteVite
框架与库
现代前端构建工具,负责把项目跑起来、打包上线。快到法语名字(读「维特」)的意思就是快。
「用 Vite 脚手架初始化项目」。
Tailwind CSSTailwind
框架与库
用「工具类」写样式的 CSS 框架:不写 CSS 文件,直接在标签上堆 class。AI 极其擅长它,生成效率翻倍。
高频词!「用 Tailwind CSS 实现响应式布局」。
组件Component
框架与库
页面的乐高积木:导航栏是一个组件、按钮是一个组件,拼在一起成页面。改一处,全站生效。
说「把导航栏抽成独立组件,便于复用」。
组件库Component Library
框架与库
别人做好的成套组件(按钮、弹窗、表格…),拿来就用。代表:shadcn/ui、Ant Design、Radix。
「用 shadcn/ui 组件库」——2025 年 AI 工具最默契的组件库。
状态管理State Management
框架与库
应用里「会变的数据」(如购物车内容)的统一管理处。小项目可无视,大项目离不开。
复杂应用说「用 Zustand 管理全局状态」。
TypeScriptTS
框架与库
JavaScript 的「安检加强版」,变量类型先声明,错误在写代码时就暴露而非上线后。
说「用 TypeScript,类型完整」,AI 生成代码更严谨。
Node.jsNode
框架与库
让 JavaScript 脱离浏览器、直接在电脑上运行的环境。npm、构建工具全靠它。本地预览的第一块基石。
环境问题排查时说「Node 版本为 LTS」。
npmNode Package Manager
框架与库
前端界的应用商店。npm install 把别人写好的代码包下载到项目里,造轮子的事基本不用自己干。
报错时的救命词:「已执行 npm install,仍报以下错误…」。
设计 TokenDesign Tokens
设计与视觉
设计的「中央变量库」:主色 #e8452c、圆角 16px、字号体系,全部集中定义一处,全站引用。改一处,换全站皮肤。
「先定义设计 token(色板/圆角/间距/字号),再写页面」——防止 AI 每个页面颜色都对不上。
视觉层级Visual Hierarchy
设计与视觉
通过大小、颜色、位置引导视线:最重要的最大最显眼,次要的往后站。页面「乱」通常是层级塌了。
「建立清晰的视觉层级,主标题最重」。
留白White Space / Negative Space
设计与视觉
元素之间的呼吸空间。新手最容易犯的错是塞太满——高级感的一半功劳在「什么都没放」。
批评稿子时说「留白不足,呼吸感不够,间距放大一档」。
网格系统Grid System
设计与视觉
把页面切成看不见的列(常用 12 列),元素对齐到列上,页面自然整齐。
「基于 12 列网格排版」。
Bento 网格Bento Grid
设计与视觉
大小不一的圆角卡片错落拼贴的布局,像日式便当盒。Apple 带火的 2024 顶流布局。
「用 Bento Grid 布局做功能区展示」。
玻璃拟态Glassmorphism
设计与视觉
半透明磨砂玻璃卡片浮在彩色背景上,自带模糊和光边。科技感的平价速效药。
「卡片用玻璃拟态:半透明 + backdrop-filter 模糊」。
微交互Micro-interaction
设计与视觉
小而精的反馈动效:按钮按下微缩、点赞爱心弹跳、卡片悬浮上浮。高级感的另一半功劳。
「加克制的微交互:hover 上浮 + 阴影加深」。
动效Motion / Animation
设计与视觉
页面元素的运动设计:滚动渐入、数字滚动、视差漂浮。要「克制」——全屏乱飞是灾难。
「加滚动渐入动效,时长 300ms,克制不花哨」。
视差滚动Parallax Scrolling
设计与视觉
滚动时背景和前景以不同速度移动产生的立体感。首屏氛围神器。
「首屏加鼠标视差效果」。
字体系统Typography Scale
设计与视觉
一套字号、字重、行高的搭配规范。中文站常见「衬线大标题 + 无衬线正文」的组合拳。
「标题用衬线字体,正文无衬线,建立字号系统」。
FigmaFigma
设计与视觉
主流在线 UI 设计工具。设计师画图的地方;v0、Lovable 都支持把 Figma 稿转成代码。
「这是我的 Figma 设计稿,按稿实现」(有稿时)。
SVGScalable Vector Graphics
设计与视觉
矢量图形格式:放大一万倍不糊,代码就能画图标,还能做动画。
「图标用内联 SVG,不用图片」。
LottieLottie
设计与视觉
把 After Effects 动画导出成网页可播放的轻量动画格式。Loading 转圈的精致替代品。
「加载动画用 Lottie」。
无障碍访问Accessibility / a11y
设计与视觉
让视障、色弱等所有用户都能用你的网站:图片有文字描述、对比度达标、键盘可操作。专业度的试金石。
「符合 WCAG 无障碍标准,对比度达标」。
GitGit
工程与部署
代码时光机:每次 commit 存一个档,改崩了一键回退。跟 AI 结对编程的安全绳。
开工就说「初始化 Git 仓库,重要节点提交」。
GitHubGitHub
工程与部署
存代码的云端平台 + 全球最大程序员社区。也是 Vercel 等部署工具的信号源:push 上去就自动上线。
「项目推送到 GitHub,仓库设为公开」。
仓库Repository / Repo
工程与部署
一个项目在 Git 世界里的家,包含全部代码和修改历史。
「在 GitHub 新建仓库并关联」。
commit / push / pullGit 三连
工程与部署
commit=本地存档;push=把存档传上云端;pull=把云端最新版拉下来。日常节奏:改→commit→push。
引导 AI:「这次改动完成后 commit 并 push,信息写清楚」。
分支Branch
工程与部署
从主线复制出的平行宇宙,在分支上随便折腾,弄好了再合并回主线。主线(main)永远保持可用。
大改动时说「新建分支开发,验证后再合并」。
Pull RequestPR
工程与部署
「请求合并」的协作流程:改动先给别人审一眼再进主线。团队开发的礼貌。
个人项目可无视;开源协作时「提交 PR」。
部署Deploy
工程与部署
把网站从「我电脑上能跑」变成「全世界都能访问」的动作。2025 年:点一下按钮的事。
「部署到 Vercel,连接 GitHub 自动部署」。
VercelVercel
工程与部署
2025 年最流行的前端部署平台。连上 GitHub 仓库自动部署、自动配 HTTPS,push 即上线。
「部署到 Vercel」五个字搞定。
Cloudflare PagesCF Pages
工程与部署
部署平台另一选项:免费额度大方、全球节点快。和 Vercel 二选一。
「部署到 Cloudflare Pages」。
CI/CD持续集成/持续部署
工程与部署
「每次 push 自动测试、自动上线」的流水线。用了 Vercel 你就已经在享受 CD 了。
说「push 后自动部署」即可。
环境变量Environment Variables / .env
工程与部署
密码、密钥等敏感信息的正确存放处:放在 .env 文件里,不进代码、不上 GitHub。
安全必说:「密钥放环境变量,严禁硬编码」。
域名Domain Name
工程与部署
网站的正式门牌号(如 linear.app)。买一个一年几十块,绑到 Vercel 上秒变正规军。
「绑定自定义域名,配置 DNS」。
DNSDomain Name System
工程与部署
互联网的电话簿:把域名翻译成服务器 IP。绑定域名时加的那条记录就是 DNS 记录。
听 AI 指挥操作即可,知道它是「门牌指向」就行。
HTTPS / SSLHTTPS
工程与部署
网址前的小锁:数据加密传输。Vercel 部署自动配好,零基础无需操心,知道它代表「安全」即可。
一般无需提;自建服务器时「配好 SSL 证书」。
后端Backend
后端与数据
网站看不见的那半边:存数据、算逻辑的地方。当网站需要「记住」东西时登场。
说「需要一个后端来存储用户数据」。
APIApplication Programming Interface
后端与数据
程序之间的点餐窗口:前端「点菜」(发请求),后端「上菜」(返回数据)。调 AI 模型也是走 API。
「调用天气 API 获取数据」、「接入 Gemini API」。
REST APIREST
后端与数据
最通用的 API 风格:用网址表达要什么(GET 拿 / POST 存 / DELETE 删),像一套礼貌用语。
「提供 REST API 接口」。
数据库Database
后端与数据
数据的仓库:用户的账号、发的帖子、下的订单都存这里。就像网站的长期记忆。
「用 Supabase 建表存储留言」。
SupabaseSupabase
后端与数据
2025 年最火的开源后端平台:数据库、用户登录、文件存储一条龙,免费档够个人玩。零基础接后端的第一选择。
「后端用 Supabase,给我配置步骤」。
JSONJavaScript Object Notation
后端与数据
数据交换的通用格式,长得像「键: 值」的清单。API 传数据基本都说这门语言。
AI 自带;看到报错里的 JSON 知道是数据格式即可。
鉴权 / 登录Authentication / Auth
后端与数据
「你是谁」的验证系统:邮箱登录、微信扫码都算。Supabase 自带,不用从零造。
「用 Supabase Auth 实现邮箱登录」。
Serverless无服务器架构
后端与数据
写一段后端逻辑但不用租服务器:代码睡在云上,有人访问才醒来干活、才计费。Vercel Functions 白送额度。
「用 Vercel Serverless Function 写接口」。
提示词Prompt
AI 协作
你发给 AI 的指令。氛围编程时代的「源代码」——五要素结构见第四章。
它本身就是提示词。写作结构:角色+目标+风格+技术栈+验收标准。
上下文Context
AI 协作
AI 一次对话里能「记住」的内容范围。项目规则写在 CLAUDE.md 等文件里,就是给 AI 的长期记忆。
「项目规则见 CLAUDE.md,遵循其中约定」。
Agent智能体
AI 协作
不止回答、还能动手的 AI:自己读文件、跑命令、改代码、验证结果。Claude Code、Codex 都是 Agent。
对 Agent 说话可以直接下达任务:「创建项目、跑通、修复报错」。
MCPModel Context Protocol
AI 协作
给 AI 接外部工具的标准插口(协议):连浏览器、连数据库、连设计工具。2025 年 AI 工具生态的 USB 接口。
配置工具时说「通过 MCP 接入 xx」。
AI 结对编程AI Pair Programming
AI 协作
人机搭档写代码:你出主意和验收,AI 出手速。氛围编程的正式学名。
迭代时说「我们来结对改这个功能,你改一版我验收一版」。
代码审查Code Review
AI 协作
合并前的互相检查。让 AI 自查:<b>「审查刚才的改动,找出隐患」</b>——它挑自己毛病时意外地认真。
「review 这次改动,列出风险点」。
版本回退Revert / Rollback
AI 协作
撤销某次改动,回到之前的存档。氛围编程的后悔药:AI 改崩了不慌,回退重来。
「这次改动有问题,回退到上一个 commit」。
03

全流程指南

FROM IDEA TO ONLINE · 从一句话到一个上线的网站

把整个旅程想象成一条地铁线,共 9 站。每站告诉你干什么、用什么工具、踩什么坑。工具均以 2024–2025 年主流选择为准:前端 React/Next.js + Tailwind,部署 Vercel/Cloudflare,数据库 Supabase。

第 1 站IDEA

把需求说清楚 难度 ★

90% 的翻车发生在这一站——不是 AI 不行,是需求没说清。
  • 一句话定义核心:"给谁,解决什么问题",例如"给零基础的人,用一个页面讲清 10 种网页设计风格"
  • 列出必须有的一页内容清单(首页/功能页/关于页),先做最小版本,别一上来要"微信全家桶"
  • 找 2–3 个喜欢的参考网站丢给 AI:"风格参考这个站的排版感觉"
  • 写下验收标准:手机上打开不乱、加载快、没有死链接
纸笔 / 备忘录参考网站截图
第 2 站GENERATE

让 AI 生成项目 难度 ★★

2025 年的生成工具分两派:对话式 Agent 和可视化生成器。
  • 对话式 Agent(Claude Code、Codex CLI、Cursor):你说需求,它直接写整个项目文件,适合认真做一个产品
  • 可视化生成器(v0.dev、bolt.new、Lovable):打字→右边实时出网页,适合快速试风格、做原型
  • Google AI Studio:适合做带 Gemini API 的 AI 功能(聊天、识图)
  • 策略:小站用生成器 10 分钟出活;正经项目用 Agent + git init 初始化版本管理
  • 一次不满意就继续追问改,不要自己重启新对话——上下文丢了等于重新排队
Claude CodeCodex CLICursorv0.devbolt.newLovableGoogle AI Studio
第 3 站PREVIEW

本地预览 难度 ★★★

在自己的电脑上跑起来,改完即时看到效果——这是"氛围"的开始。
  • 安装 Node.js(LTS 版本),它让电脑能运行现代前端项目,装一次管很久
  • 在项目目录打开终端,跑 npm install(装依赖,只需第一次)
  • 再跑 npm run dev,浏览器打开它提示的地址(通常 localhost:5173 或 3000)
  • 改一行代码,页面自动刷新——所见即所得,Agent 工具还能自己看页面改页面
  • 常见报错先别慌:80% 是没 install、端口被占用、Node 版本太旧(详见第 9 站)
Node.js LTSnpm / pnpmVS Code
第 4 站GIT

Git 与 GitHub:给代码上保险 难度 ★★★

Git 是时光机(记录每次改动),GitHub 是云盘+社交网络(存代码、给别人看)。
  • 为什么重要:AI 改崩了可以一键回退;换电脑/换工具,代码都在云端
  • 在 GitHub 建一个仓库(repository),复制它的地址
  • 本地项目目录里执行:git init → git add . → git commit -m "第一版" → git push
  • 日常节奏就是这三连:改 → commit(存档)→ push(上云),大事小事都存档
  • 心法:每次 commit 写清这次改了什么;commit 是免费的,多多益善
GitGitHubGitHub Desktop(免命令行)
第 5 站DEPLOY

部署上线 难度 ★★

2025 年最爽的一站:连上 GitHub 仓库,30 秒后你就有公网网址了。
  • Vercel:Next.js/React 项目首选,登录 GitHub → Import 仓库 → 点 Deploy,完事
  • Cloudflare Pages:免费额度大方、全球速度快,静态站好选择
  • GitHub Pages:纯静态小站的最简方案
  • 最妙的是自动部署:以后每次 git push,线上自动更新,你不用再管"怎么发版"
  • 部署成功先做三件事:手机打开试试、分享给朋友、截图发朋友圈(重要)
VercelCloudflare PagesNetlifyGitHub Pages
第 6 站BACKEND

后端与数据库接入 难度 ★★★★

当网站需要"记住东西"——用户注册、留言、收藏——就该上后端了。
  • 判断标准:数据要不要存下来给别人看?要,就需要数据库;只是个人展示,静态站够用
  • Supabase:2025 年最流行的开源后端平台,数据库+登录+文件存储一条龙,免费档够玩
  • 让 AI 接入:"帮我把留言功能接到 Supabase,建好表,做好提交和展示"
  • 数据库密钥等敏感信息放环境变量(.env 文件),绝不写死在代码里、绝不传到 GitHub
  • 进阶:Serverless 函数(Vercel Functions)能跑后端逻辑,不用租服务器
SupabaseFirebaseVercel Functions环境变量 .env
第 7 站DOMAIN

绑定域名 难度 ★★

从 xxx.vercel.app 升级成你自己的 .com——品牌感的最后一块拼图。
  • 在注册商(Cloudflare、Namecheap、阿里云)买域名,一年几十块,.com 优先
  • 在 Vercel/Cloudflare 的项目设置里 Add Domain,按提示加一条 DNS 记录
  • DNS 生效需要几分钟到几小时,HTTPS 证书自动配好,不用管
  • 验证:等生效后,让别人用手机打开你的域名——正式"有门牌号"了
Cloudflare RegistrarNamecheap自动 HTTPS
第 8 站ITERATE

迭代与维护 难度 ★★

网站是养出来的,不是建出来的。上线只是第一天。
  • 小步快跑:每次只改一件事 → commit → push → 自动上线,随时可回退
  • 把用户反馈原封不动丢给 AI:"用户说手机上按钮太小,帮我改"
  • 定期让 AI 做体检:"帮我检查性能、无障碍访问和 SEO,列出待办"
  • 给 AI 维护上下文:项目里放一个 README 或规则文件(如 CLAUDE.md),写清技术栈和约定,每次对话它都能秒懂项目
git commit 习惯CLAUDE.md / READMEVercel Analytics
第 9 站DEBUG

排错心法 难度 ★★★

一定会出错。区别高手和新手的不是"不出错",而是出错的姿势。
  • 第一步永远是:把完整报错原文贴给 AI,加上"这是运行 xxx 时出现的",别只说"报错了怎么办"
  • 浏览器按 F12 打开控制台,红色报错截图也是线索金矿
  • 改之前先 git commit 存档——改崩了 git checkout . 一秒回到改之前
  • 一次只改一个地方,改完马上验证,别攒一堆改动再测
  • 高频错误速查:依赖没装→跑 npm install;端口占用→换端口或重启终端;白屏→看控制台报错;部署失败→看 Vercel 的 Build 日志
  • AI 连续 3 次修不好同一个错:停下,回退到上一个能跑的 commit,换个思路重新描述问题
F12 控制台git checkout 回退Vercel Build 日志
04

提示词心法

PROMPT KUNG-FU · 一次做对的五要素结构

同一个 AI,为什么别人一次做对你改十遍?差别就在提示词的结构。五要素公式:角色 + 目标 + 风格约束 + 技术栈 + 验收标准。缺一个要素,AI 就多一分"自由发挥"——而它的自由发挥,通常不是你想要的。

1

角色 Role

先给 AI 定人设,激活对应领域的知识浓度。资深设计师和实习生,输出质量天差地别。

"你是一位资深前端工程师兼 UI 设计师…"
2

目标 Goal

说清做什么、给谁用、解决什么问题。一句话讲完,别铺垫剧情。

"为零基础用户做一个单页学习站…"
3

风格约束 Style

视觉关键词全丢这里:风格流、配色、字体感觉、参考网站。词库第一章就是为这里服务的。

"极简风、大留白、暗黑模式,参考 Linear…"
4

技术栈 Stack

指定工具与框架,防止 AI 用十年前的老古董技术应付你。

"React + Tailwind CSS + Vite…"
5

验收标准 Criteria

定义"什么叫做对了"。有标准的活,AI 才会自查;没标准的活,全靠缘分。

"手机端适配、Lighthouse 90+、无占位文本…"

❌ 模糊型提问

"帮我做个好看的网站,要高级一点,功能多一点,你看着办。"
AI 内心:什么是好看?什么算高级?功能是几个?——只能瞎猜一版,然后你俩开始漫长的"改改改"拉锯战。

✅ 五要素提问

"你是一位资深前端工程师。[角色] 帮我做一个给咖啡店的单页官网,目标是提升到店转化。[目标] 风格:Editorial 杂志排版 + 暗色背景 + 衬线大标题,参考 Linear 的质感。[风格] 用 React + Tailwind。[栈] 验收:手机端完美适配、有菜单/位置/联系方式三个区块。[标准]"
AI 内心:需求明确,边界清晰,一次给到位。

📋 模板一 · 落地页 / 个人网站 复制即用

[角色] 你是一位资深前端工程师兼 UI 设计师,擅长现代网页美学。
[目标] 为「____(你的项目,如:独立咖啡店 / 个人作品集 / 新产品)」制作一个单页网站,
      核心目标:____(如:展示作品吸引客户 / 促成购买 / 收集邮箱)。
[风格] 视觉风格:____(如:Bento 网格 + 玻璃拟态 / Editorial 杂志排版 / 新粗野主义);
      配色:____(如:深灰底 + 霓虹绿强调 / 米白纸感 + 朱红点缀);
      字体:____(如:中文衬线大标题 + 无衬线正文);
      参考质感:____(如:Linear / Apple 官网 / Gumroad)。
[技术栈] React + Tailwind CSS + Vite,使用响应式布局,加入滚动渐入的微交互动效。
[验收标准] 1. 手机/平板/桌面三档完美适配;2. 首屏包含价值主张与 CTA 按钮;
      3. 所有文案为真实内容,禁止 lorem 占位;4. 代码结构清晰,方便后续迭代。

📋 模板二 · 带数据的工具型应用 进阶

[角色] 你是一位全栈工程师,熟悉现代 BaaS 后端服务。
[目标] 制作一个「____(如:习惯打卡 / 留言墙 / 记账本)」Web 应用,
      用户可以:____(如:注册登录 / 提交数据 / 查看所有人提交的内容)。
[风格] 界面走 ____(如:暗黑模式 + 霓虹强调 / 极简白 + 单一品牌色),克制、不花哨。
[技术栈] 前端 Next.js + Tailwind;后端用 Supabase(数据库 + 邮箱登录);
      数据库密钥一律走环境变量,禁止硬编码。
[验收标准] 1. 未登录用户只能看不能写;2. 提交后数据实时显示;
      3. 手机端可用;4. 给我一份"如何配置 Supabase"的分步说明。

📋 模板三 · 排错 / 修 Bug 救命用

[角色] 你是一位擅长调试的资深工程师。
[现状] 我在运行「____(命令,如 npm run dev)」时出现以下报错:
      ----(此处粘贴完整报错原文)----
      项目技术栈:____(如 React + Vite + Tailwind),系统:____。
[目标] 找到报错根因并修复,同时解释这个错误为什么会发生(用零基础能懂的话)。
[约束] 只改动与该问题相关的文件,不要顺手重构其他代码;
      每一步修改说明改了哪个文件、为什么这么改。
[验收标准] 修复后 npm run dev 能正常启动,原有功能不受影响。

最后一条心法:提示词不是许愿,是下单。菜单写得越清楚,后厨越不会上错菜。写完先自查一遍五要素齐不齐——30 秒的自查,省掉三轮返工。

05

从做出来,到交付得好

ADVANCED PATH · 学会判断、组织与验收

零基础也可以借助 AI 做出有专业观感的小产品。真正的进阶,是知道给谁做、怎么使用、怎样确认可靠,以及上线后怎么改。

展开看:目标、边界与学习方式

先在一个明确的小场景里做到专业质量,再扩大范围。顶级团队还需要长期积累的领域理解、复杂系统经验、真实用户反馈与持续运营;没有一条提示词或一个 Skill 能保证补齐这些能力。

这份路线聚焦个人内容网站和小型网页产品。你不必先背整套语法,但要逐渐看懂基本结构、数据去向和验证证据。

内容网站:像认真维护的一份出版物。

重点放在信息结构、内容准确性、长文阅读、查找与更新。先做好一篇真实文章及其图示,再形成稳定的分类、模板和发布流程。

先交付:首页 + 文章页 + 查找入口 + 来源与修订记录。
点着学 / LEARNING MAP

一件作品,怎样变成可交付的产品?

点一个环节,看它要留下什么。

先做一个范围小但完整的版本,再沿着这条路径反复改善。

当前环节 · 1 / 8

产品定义

先说清谁会用、为哪一个具体任务而来。定义第一版只做什么,以及哪些要求留到以后。

这一关要留下什么一页需求说明:目标用户、主任务、核心功能、明确不做的事、验收标准。
复制这项能力的练习提示词
先不要写代码。请根据我的想法,整理目标用户、核心任务、第一版最小范围和五条可以实际检查的验收标准。指出哪些需求还不清楚,给我可选择的方案。
06

把进阶变成一个实际项目

PRACTICE & EVIDENCE · 每次只补一块真实能力

先做范围小但完整的作品。每完成一个阶段,都留下可预览的结果和可检查的证据;不必为了“专业”把所有框架和工具装进同一个项目。

动手看 / 01

同一份内容,排版能改变多少?

点两种版本,比较标题、间距与主次。

阅读清单 · 版式演示
我的阅读角3 篇收藏

今天,读一点新知识。

从一个有意思的问题开始。

⌕ 搜索阅读笔记
光
物理 / OPTICS光为什么会拐弯?折射的日常观察 · 4 分钟
↗
读
阅读 / NOTES把理解,留在一页里。今天的读书笔记 · 3 分钟
↗
问
提问 / QUESTIONS好问题,从哪里来?一次思考练习 · 5 分钟
↗

初稿:标题、说明和次要信息比较接近,内容挤在一起。试试“整理后”。

这是同一份内容的 HTML 小样,用来观察视觉层级;搜索框和文章只是示意。
动手看 / 02

点“保存”以后,数据去了哪里?

以一个多人收藏工具为例,走完一趟请求。

浏览器你正在使用的界面输入与反馈
请求 →
服务器处理这次操作身份与权限
读写 →
数据库保存共享的数据记录与策略
你在浏览器里填写内容。浏览器显示界面并发送请求;私有密钥不应放在这一层。
这是原理演示,没有实际调用服务器。纯静态内容站可以只用浏览器和静态托管,不必照搬这套结构。
动手试 / 03

失败时,用户已经写的内容还在吗?

试一次保存失败,再点重试,看看状态怎样变化。

本地模拟 · 不发送网络请求

先点“保存笔记”,体验一次失败。

↗等待操作状态反馈会在这里出现
本页的演示记录 0

还没有记录。

✓ 失败保留输入✓ 等待时阻止重复提交✓ 提供可理解的恢复入口
三个练习项目:从内容站到多人产品
第一阶段 / 内容完整

一份知识专题站

用你熟悉的主题,做首页、文章、分类与搜索。明确每段内容从哪来。

  • 用真实文章和图示打样,手机可读。
  • 标出来源、更新时间与反馈入口。
  • 检查搜索、外链、空结果和图片加载。
第二阶段 / 交互完整

一个个人收藏工具

练习添加、编辑、筛选、删除和恢复。先决定数据只存当前设备还是要同步。

  • 添加错误、重复输入和删除撤销有反馈。
  • 刷新后数据按预期保留。
  • 提供导出/导入,并真正试一次恢复。
第三阶段 / 服务完整

一个多人使用的小产品

在确有需求时再加入账号、同步和权限。先让少量真实用户完成同一项任务。

  • 未登录、用户 A 与用户 B 的权限可验证。
  • 失败、重复提交、会话过期能处理。
  • 发布可回退,重要数据可恢复。

学会给 AI 一份“项目工作包”。

准备真实内容、需求说明、参考截图、设计规则、任务清单和验收条件。让 AI 做一个可预览的小版本,再根据实际页面迭代。需要时才引入专业组件、自动测试或后端服务。

提示词:这一次做什么

说明当前目标、输入、约束和验收条件。一次任务一个重点。

项目规则:长期怎样合作

记录已经确认的技术栈、设计和内容规范。在 Codex 中可参考 AGENTS.md 的官方加载规则。

Skill / MCP:方法与工具

Skill 组织可复用的流程与资源;MCP 连接外部工具能力。是否能调用、在哪里生效,仍取决于当前工具和权限。

开始时只挑一个设计方法和一个验证方法,先会用。第三方 Skill 可能带脚本;先看原始说明、来源与许可证。以下只是学习资源和模板,不会自动安装或执行。

把一句想法变成可交付需求
先不要写代码。请根据我的想法,整理目标用户、核心任务、第一版最小范围和五条可以实际检查的验收标准。指出哪些需求还不清楚,给我可选择的方案。
把参考截图变成设计规则
请结合网站用途和参考截图,提炼颜色、字体、间距、圆角与组件状态。先用同一套规则做首页和一张详情页,说明哪些参考元素适合借鉴。保留我自己的文案和素材。
先展示一组代表性的组件和两种屏幕宽度的预览。不要把网页截图当作功能已经完成的证据。
让产品补齐失败与边界状态
请为最重要的一条操作流程列出完整状态:初始、加载、空结果、输入错误、请求失败、成功和重复点击。每种状态说明用户看到什么、下一步能做什么;失败时保留已经输入的内容。
给出一张状态表,并实际验证其中最关键的成功路径和失败路径。
把内容网站做得像长期维护的出版物
请将现有内容网站整理成可长期更新的结构。保留原文与已确认的素材;明确文章标题、稳定链接、分类、搜索、引用、更新时间和修订规则。检查手机长文、图片说明、外链失效与示例标注。先选一篇文章打样,验收后再批量处理。
要求证据,而不是一句“已经完成”
请从真实用户的视角验收这个版本:完成主要操作、验证一个输入错误或网络失败场景,在 320px、390px 和 1280px 宽度检查布局,检查键盘焦点与控制台错误。按“检查项—执行方式—实际结果—证据”报告。不要把没跑过的检查写成通过。若有多用户数据,再验证未登录、用户 A 和用户 B 的权限边界。
上线前准备与回滚演练
请先确认这个项目的托管方式、数据存储和现有部署流程,然后整理预发布检查、上线核对、错误观察与回滚步骤。验证的是正式域名和实际使用功能;不要把 Git push 当作网站已上线。有数据库变更时,先备份、验证迁移并演练恢复。发布权限和范围以我对本项目的明确要求为准。
项目协作约定示例

先填写自己的项目事实;这是可编辑的示例,不会自动成为当前项目的规则。

# 项目协作约定(示例,按自己的项目修改)

## 项目事实
- 用途和目标用户:填写已确认的事实。
- 技术栈、启动与验证方式:先读取项目文件,记录实际可运行的方法。
- 第一版范围:填写核心任务与暂时不做的功能。

## 内容与设计
- 保留已确认的文案、素材、链接与品牌规则。
- 示例内容必须标明;新增事实与引用应给出来源。
- 字体、配色、间距与组件状态遵循项目的设计规则。

## 实现与验收
- 大任务拆成可预览、可独立验证的小改动。
- 验证关键用户路径与相关失败状态,保留证据。
- 不把未运行的检查写成通过;重要数据变化需备份和恢复验证。
- 发布、外部写入和不可逆操作遵循用户对当前任务的明确授权范围。
一个小 Skill 应该写些什么

展示格式与工作步骤;如需使用,请按所用工具的官方文档创建和验证。

---
name: site-acceptance-notes
description: 当用户要验收内容网站或小型网页工具时,整理并执行与当前改动相关的质量检查。
---

1. 先明确网页的目标用户、主要任务和本次修改范围。
2. 根据项目类型列出相关检查;不要强加用不到的登录、支付或数据库流程。
3. 实际运行页面,检查关键操作、手机布局以及一个相关失败场景。
4. 对文字与图示核对来源、示例标注和表达;对多用户产品另查权限边界。
5. 输出执行方式、实际结果、证据、未验证项目与待修复问题。

验收记录不是对任意产品质量的保证;工具使用与操作权限遵循用户授权和当前工具的规则。

验收记录:给“做好了”留下证据。

这是你手动填写的自评记录,不会自动测试任何网站,也不会颁发“专业级”认证。选“已核验”时补一个截图名、地址或检查记录,才计入有证据的完成项。

0项有证据
把检查结果留下来。

每完成一项验证,填一个截图、地址或记录。圆环只表示你的记录进度。

展开验收清单,填写检查证据

记录保存在当前浏览器。它不是所有设备共享的项目状态。

已经做好一个小版本,下一步只补一个薄弱环节:按问题查参考资源 →

07

精选参考资源

REFERENCE SHELF · 用来解决具体问题,而不是收藏更多链接
先看图,再挑一份资料试一试。这里收录 34 份官方资料、作者实践、开源项目与社区讨论,每份都写了学什么、怎样用、适用边界。检索核对日期:2026-10-14。
封面均为本站绘制的教学示意,不是原网站截图。
这是按用途整理的参考库,热度不代表适合你的技术栈。未能直接读取的帖子不做效果背书;X 原帖的读取限制已单独标出,Reddit 作者身份与经验不能代替官方规范。

首读专业机构通用
图解示意保存
反馈,让人知道发生了什么。

NN/g:十大可用性原则

学什么:理解状态反馈、错误恢复、一致性和用户控制。

怎么用 · 适用边界

用到项目里:选出你网页最重要的一条操作流程,逐条找出哪里会让人困惑。

打开原始资源 ↗已读原文 · 核对 2026-10-14
首读官方文档通用
图解示意HTMLCSSJS
结构 + 样式 + 行为。

MDN:Web 开发基础

学什么:补足 HTML、CSS、JavaScript、浏览器与网络的基本认识。

怎么用 · 适用边界

用到项目里:让 AI 结合你的实际项目,解释一个按钮从点击到显示结果经历了什么。

打开原始资源 ↗已读原文 · 核对 2026-10-14
首读官方文档通用
图解示意Aa
把字体、间距和颜色定成规则。

OpenAI:前端提示词指南

学什么:学习如何给出明确的前端设计约束和遵循已有设计。

怎么用 · 适用边界

用到项目里:先提炼成你的设计要求,再提供页面用途、参考截图和验收条件。

原文针对特定模型编写;不要把其中所有要求当作每个工具的通用规则。

打开原始资源 ↗已读原文 · 核对 2026-10-14
首读官方文档通用
图解示意SKILL.md
触发条件 → 步骤 → 验收。

OpenAI:Build skills

学什么:理解 Skill 的触发条件、SKILL.md 与配套资源。

怎么用 · 适用边界

用到项目里:把反复使用的“内容校对”或“页面验收”流程写成一个小 Skill。

使用和安装方法以你所用工具的当前官方说明为准。

打开原始资源 ↗已读原文 · 核对 2026-10-14
首读作者原文通用
图解示意✓ 点击✓ 输入? 结果
检查行为,而不只看截图。

Simon Willison:Agentic Engineering Patterns

学什么:学习测试、Git、人工操作验证和理解 AI 改动的习惯。

怎么用 · 适用边界

用到项目里:先看 First run the tests 与 Agentic manual testing 两节,再让 AI 实际点按钮验证。

这是作者的方法论;具体测试强度要匹配你的项目。

打开原始资源 ↗已读原文 · 核对 2026-10-14
首读官方项目通用
图解示意✓ 点击✓ 输入? 结果
检查行为,而不只看截图。

Playwright:浏览器测试

学什么:让浏览器执行点击、输入、页面跳转和结果断言。

怎么用 · 适用边界

用到项目里:把“输入关键词后出现正确结果”变成可以重复运行的检查。

先测试关键用户路径;用例应验证行为,而不是只检查元素是否存在。

打开原始资源 ↗已读原文 · 核对 2026-10-14