摘要：一份PRD让AI开发少返工
系列：AI建站与SEO/GEO营销完整教程｜第 05/20 篇
适合读者：准备用 Cursor、Claude Code、Codex 或其他 AI 编程工具搭建内容站、工具站、品牌站、产品站的跨境卖家和运营负责人
关键词：AI写需求文档、网站PRD、Cursor建站、Claude Code建站、Codex建站、AI开发网站
很多人第一次用 AI 编程工具做网站，都会经历一个很相似的过程。
第一天很兴奋。
你对 Cursor、Claude Code 或 Codex 说：
帮我做一个专业的 AI 建站和 SEO 网站。
几分钟后，它真的生成了项目。
首页能打开，卡片能显示，按钮也能点。
但第二天开始，你发现问题越来越多：
- 首页文案像模板站
- 栏目结构和你的业务不匹配
- 文章页没有 SEO 规则
- 工具页只是一个输入框
- 表单没有说明提交到哪里
- sitemap、robots、metadata 没有设计
- 你让它改一处，它顺手改坏另一处
- 你说“做得专业一点”，它不知道怎么验收
这不是 AI 工具没用。
问题通常是：你没有给它一份可执行、可验收的网站需求文档。
让 AI 开发网站，第一步不是写代码，而是写 PRD。PRD 写得越清楚，AI 越像开发助理；PRD 写得越模糊，AI 越像随机生成器。
这篇文章会给你一套可以直接复制使用的网站 PRD 方法。
目标不是写一份好看的文档，而是让 Cursor、Claude Code、Codex 这类工具能更稳定地理解项目、拆分任务、生成代码、保留 SEO 要求，并让你能检查它到底做完没有。
一、先说结论：AI开发网站需要三份文档
如果你要用 AI 开发一个网站，不建议只写一句“帮我做网站”。
至少准备三份文档：
| 文档 | 作用 | 给谁看 |
|---|---|---|
PRD.md | 写清业务目标、页面、功能、用户路径、SEO和验收标准 | AI编程工具、项目负责人 |
CONTENT-MAP.md | 写清栏目、专题、文章、工具、模板和内链关系 | 内容运营、SEO、AI写作工具 |
AGENTS.md / CLAUDE.md / Cursor Rules | 写清项目规则、代码风格、目录结构、测试命令和禁止事项 | Codex、Claude Code、Cursor |
简单说：
PRD.md决定做什么CONTENT-MAP.md决定内容怎么长- 项目规则文件决定 AI 开发时怎么做
如果只有 PRD，没有内容地图，网站容易变成页面功能堆砌。
如果只有内容地图，没有 PRD，AI 不知道怎么开发。
如果没有项目规则文件，AI 每次进入项目都要重新猜目录结构、代码风格和验收方式。
二、资料事实：AI编程工具为什么需要项目上下文
先把事实边界讲清楚。
资料明确写到：
Cursor 官方文档提供 Rules、Agent、MCP、Skills、CLI 等能力。Cursor 的 Rules 用于配置持久化指令，包括项目、团队和用户规则，也支持 AGENTS.md 这类项目说明。
OpenAI Codex 官方文档说明，Codex 是可以读取、编辑和运行代码的 coding agent；OpenAI 还专门提供 AGENTS.md 指南，说明 Codex 会在开始工作前读取 AGENTS.md 文件，用来获得项目指令和上下文。
Anthropic 的 Claude Code 文档说明，Claude Code 可以用于理解代码库、修 bug、重构、写测试、创建 PR 等工作。Claude Code 的 memory 文档也说明，项目级 CLAUDE.md 可以保存构建命令、测试说明、项目约定、架构决策、命名规范和常用工作流，并在会话开始时进入上下文。
Next.js 官方文档提供 metadata、sitemap.xml、robots.txt 等文件约定，用于 SEO 和分享信息管理。也就是说，如果你准备用 Next.js 做网站，PRD 里就不应该只写“做好SEO”，而要写清楚哪些页面需要 metadata、哪些 URL 进入 sitemap、robots 如何配置。
Google 的 SEO Starter Guide 强调，网站应该用有逻辑的方式组织页面，并让链接文字帮助用户和搜索系统理解页面关系。Google 的 helpful content 指南也强调内容要有原创信息、深入分析和真实帮助。
我们可以合理推断：
AI 编程工具越强，越需要清晰上下文。
以前你和外包沟通需求，需求模糊会返工。
现在你和 AI 协作，需求模糊也会返工，而且返工速度更快。
AI 能读代码、改文件、运行测试，但它不会天然知道你的业务目标、目标用户、转化路径、SEO策略和内容边界。
卖家实操建议：
不要把 AI 编程工具当许愿机。
你要把它当成一个执行很快、但需要清晰施工图的开发助理。
施工图就是 PRD。
三、PRD不是愿望清单，而是验收清单
很多人的“需求文档”长这样：
- 做一个专业网站
- 页面要好看
- SEO要好
- 要有博客
- 要有工具
- 要能转化
- 要适合AI搜索
这不是 PRD。
这是愿望清单。
真正能让 AI 开发的网站 PRD，必须能回答：
- 做给谁
- 解决什么问题
- 第一阶段做哪些页面
- 每个页面的主动作是什么
- 每个功能输入什么、输出什么
- SEO规则怎么落地
- 数据怎么存
- 什么叫做完成
- 什么不能做
- 怎么检查
你可以用一句话判断 PRD 是否合格：
如果 AI 做完后，你不能按文档逐项验收，这份 PRD 就不合格。
四、一个具体场景：做“AI建站与SEO”内容工具站
假设你要做一个网站，主题是“AI建站与SEO/GEO教程”。
你希望这个网站第一阶段实现：
- 发布系列教程文章
- 做专题页
- 提供网站PRD模板下载
- 做一个“网站类型选择器”
- 收集邮件订阅
- 未来可以扩展 SEO 检查器和 Schema 生成器
如果你只告诉 AI：
帮我做一个 AI 建站网站。
它可能会生成一个很通用的首页。
但如果你给它一份 PRD，它就能更稳定地执行。
下面是这个项目的 PRD 骨架。
五、网站PRD的10个模块
1. 项目背景
这一节不要写虚话。
要写清楚为什么要做这个网站。
示例：
我们要做一个面向跨境卖家和 AI 工具使用者的中文内容站，主题是 AI 建站、SEO/GEO 和 AI 搜索可见性。网站第一阶段不是卖课程，而是通过高质量专题文章、工具页和模板资料，建立专业信任，收集订阅和咨询线索。
这段话告诉 AI：
- 目标人群是谁
- 网站类型是什么
- 第一阶段不做什么
- 转化动作是什么
2. 项目目标
目标必须能衡量。
不要写：
做一个有影响力的网站。
要写：
| 目标 | 衡量方式 |
|---|---|
| 上线第一版内容站 | 10个核心页面可访问 |
| 建立AI建站专题 | 1个专题页 + 5篇文章 |
| 收集潜在用户 | 订阅表单可提交并记录来源 |
| 支持SEO基础 | 每页有title、description、canonical、sitemap |
| 支持后续工具扩展 | 工具页模板可复用 |
AI 开发要靠具体目标推进。
3. 用户角色
网站不是给所有人看的。
至少定义 3 类用户：
| 用户角色 | 需求 | 网站动作 |
|---|---|---|
| 跨境卖家老板 | 想知道AI建站值不值得做 | 阅读入门文章、下载检查表 |
| 运营负责人 | 想按步骤搭建内容站 | 阅读专题、使用模板 |
| 技术/AI工具用户 | 想用Cursor/Codex开发网站 | 查看PRD、复制提示词、执行开发 |
写用户角色的目的，是让 AI 知道页面不是为了“展示信息”，而是要服务不同动作。
4. 页面清单
页面清单是 PRD 的核心。
第一阶段不要超过 10-12 个页面。
示例：
| 页面 | URL | 目标 | 主CTA |
|---|---|---|---|
| 首页 | / | 说明网站定位和专题入口 | 进入AI建站专题 |
| AI建站专题页 | /ai-website/ | 汇总学习路径 | 下载PRD模板 |
| 文章页模板 | /ai-website/[slug]/ | 承接长尾搜索 | 阅读下一篇/下载模板 |
| 工具页：网站类型选择器 | /tools/website-type-selector/ | 帮用户选网站类型 | 邮箱接收结果 |
| 模板页：网站PRD模板 | /templates/website-prd-template/ | 提供可下载模板 | 留邮箱下载 |
| 关于页 | /about/ | 建立信任 | 订阅/联系 |
| 联系页 | /contact/ | 收集咨询 | 提交表单 |
AI 看到这张表，才知道要建哪些路由。
5. 页面结构
每个页面都要写模块。
以“网站类型选择器”为例：
| 模块 | 内容 | 验收标准 |
|---|---|---|
| 首屏 | 标题、副标题、使用场景 | 用户10秒内知道工具用途 |
| 输入区 | 业务类型、维护能力、SEO目标、是否需要工具功能 | 字段有label和说明 |
| 结果区 | 推荐网站类型、理由、第一阶段页面结构 | 根据输入显示不同结果 |
| 延伸阅读 | 链接到网站类型文章和工具选型文章 | 至少2个内部链接 |
| CTA | 邮箱接收完整报告 | 表单可提交 |
这比“做一个工具页”清楚得多。
6. 功能需求
功能需求要写输入、输出、异常。
比如订阅表单：
| 功能 | 输入 | 输出 | 异常 |
|---|---|---|---|
| 邮件订阅 | email、来源页面 | 保存记录，显示成功提示 | 邮箱格式错误时提示 |
| 模板下载 | email、模板id | 发送或展示下载链接 | 未输入邮箱不可下载 |
| 网站类型选择器 | 多个选择题 | 推荐网站类型和页面结构 | 未完成题目提示补全 |
AI 最怕你只写“加一个表单”。
它需要知道表单交到哪里、成功后显示什么、失败时怎么处理。
7. 内容需求
如果网站有文章和专题，PRD 必须写内容规则。
比如：
- 每篇文章必须有标题、摘要、关键词、发布时间、更新时间
- 每篇文章必须归属一个专题
- 每篇文章必须有至少 3 个内部链接
- 每篇文章必须有一个下一步动作
- 专题页必须显示学习路径，而不是简单文章列表
- 模板页必须说明适用场景、使用方法和下载方式
内容规则写进 PRD，后面 AI 做页面模板时才不会只做一个空列表。
8. SEO需求
不要写“做好 SEO”。
要写具体项。
Next.js 项目可以这样写：
| SEO项 | 要求 |
|---|---|
| metadata | 每个页面生成 title、description、OG title、OG description |
| canonical | 每个公开页面有规范URL |
| sitemap | 首页、专题页、文章页、工具页、模板页进入 sitemap |
| robots | 允许公开页面抓取，屏蔽后台或测试路径 |
| URL | 使用短、可读、稳定的英文路径 |
| JSON-LD | 文章页使用 Article，FAQ区域可考虑 FAQPage |
| 内链 | 文章页链接专题页，专题页链接核心文章和工具 |
| 404 | 有自定义404页面和返回路径 |
这里每一项都能检查。
9. 数据结构
即使你第一版不用数据库，也要写数据模型。
文章数据可以这样：
Article:
- id
- slug
- title
- description
- category
- topic
- keywords
- publishedAt
- updatedAt
- author
- coverImage
- body
- relatedArticles
- ctaType
工具结果可以这样：
WebsiteTypeResult:
- id
- createdAt
- email
- businessType
- updateOwner
- seoPriority
- needsToolFeature
- recommendedSiteType
- recommendedPages
- nextStep
AI 有了数据结构，才不会每个页面随便造字段。
10. 验收标准
这是最重要的一节。
示例：
| 验收项 | 通过标准 |
|---|---|
| 首页 | 能打开，首屏说明网站定位，至少3个专题入口 |
| 专题页 | 有学习路径、核心文章、工具和模板入口 |
| 文章页 | 有title、description、目录、正文、内链、CTA |
| 工具页 | 输入、输出、异常提示都可用 |
| 表单 | 正确提交，错误输入有提示 |
| SEO | sitemap、robots、metadata存在并可访问 |
| 移动端 | 主要页面在手机宽度下无明显错位 |
| 安全 | 不暴露API key、token、私有邮箱列表 |
| 可维护 | 页面数据和内容不硬编码在多个地方 |
没有验收标准，AI 做完以后你只能凭感觉判断。
有验收标准，你可以逐项检查。
六、给AI编程工具的项目文件结构
如果你用 Next.js + Cursor/Codex/Claude Code，建议项目里至少准备这些文档：
/docs/PRD.md
/docs/CONTENT-MAP.md
/docs/SEO-RULES.md
/docs/ACCEPTANCE-CHECKLIST.md
/AGENTS.md
/CLAUDE.md
/.cursor/rules/project-rules.mdc
不同工具读取规则不完全一样，所以不必每个项目都放满。
但至少要有：
- 一份 PRD
- 一份内容地图
- 一份项目规则
PRD.md 写什么
写业务目标、页面、功能、数据结构、SEO 和验收。
CONTENT-MAP.md 写什么
写栏目、专题、文章、工具、模板、内链和发布顺序。
SEO-RULES.md 写什么
写 URL、metadata、sitemap、robots、canonical、JSON-LD、内链规则。
AGENTS.md 写什么
给 Codex 或其他支持 AGENTS.md 的工具写项目指令：
# AGENTS.md
## 项目目标
这是一个面向跨境卖家和AI工具用户的AI建站与SEO内容工具站。
## 技术栈
- Next.js App Router
- TypeScript
- 内容第一阶段使用Markdown/MDX
- 样式使用现有CSS方案，不引入大型UI框架
## 开发规则
- 不要一次性重构无关文件
- 新页面必须包含metadata
- 公开页面必须进入sitemap
- 表单必须有错误状态和成功状态
- 不要暴露任何API key或私有数据
## 验收命令
- npm run lint
- npm run build
## 重要文档
- docs/PRD.md
- docs/CONTENT-MAP.md
- docs/SEO-RULES.md
- docs/ACCEPTANCE-CHECKLIST.md
CLAUDE.md 写什么
如果用 Claude Code，可以写项目说明、构建命令、测试命令、命名规范、架构决策和常用工作流。
示例：
# CLAUDE.md
本项目是AI建站与SEO内容工具站。
Claude在修改代码前必须：
1. 先阅读 docs/PRD.md
2. 先阅读 docs/CONTENT-MAP.md
3. 如涉及SEO，阅读 docs/SEO-RULES.md
4. 修改前简述计划
5. 修改后运行可用检查命令
不要：
- 不要删除已有文章内容
- 不要改动与任务无关的页面
- 不要把占位文案当最终内容
- 不要把密钥写入代码
Cursor Rules 写什么
如果用 Cursor，可以把项目长期规则放入 Cursor Rules。
规则应该短、具体、可执行。
比如：
所有新页面必须：
- 使用清晰的H1
- 有metadata title和description
- 有一个主CTA
- 移动端可读
- 如果是文章页，必须链接所属专题页
- 如果是工具页，必须包含输入说明、输出示例、错误状态和下一步动作
这些规则比“写得专业一点”有效得多。
七、用AI写PRD的完整SOP
下面这套流程可以直接使用。
第一步：先让AI提问，不要直接写文档
你是一个懂跨境电商、SEO、内容站和AI编程工具的网站产品经理。
我准备做一个网站，但需求还不完整。
请先不要写PRD。
请先向我提出20个必须回答的问题，覆盖：
1. 业务目标
2. 目标用户
3. 网站类型
4. 页面清单
5. 内容结构
6. SEO目标
7. 工具/表单/下载功能
8. 技术栈和维护能力
9. 转化路径
10. 验收标准
问题要具体，不要泛泛而谈。
这一步非常关键。
很多人跳过提问，直接让 AI 写 PRD，结果文档看起来完整，实际全靠猜。
第二步：把答案变成PRD
请根据我刚才的回答，写一份可交给 Cursor、Claude Code 或 Codex 执行的网站PRD。
要求包含：
1. 项目背景
2. 项目目标和非目标
3. 用户角色
4. 第一阶段页面清单
5. 每个页面的模块、主CTA、验收标准
6. 功能需求：输入、输出、异常状态
7. 内容需求：栏目、专题、文章、工具、模板
8. SEO需求：metadata、URL、sitemap、robots、canonical、JSON-LD、内链
9. 数据结构
10. 技术栈建议
11. 风险和边界
12. 第一阶段任务拆分
13. 验收清单
请用Markdown格式输出，尽量写成开发可执行文档。
第三步：让AI检查PRD漏洞
请用严苛产品经理和技术负责人视角审查这份PRD。
请指出：
1. 哪些需求仍然模糊
2. 哪些页面缺少转化动作
3. 哪些SEO规则不可验收
4. 哪些功能缺少输入/输出/异常状态
5. 哪些地方会导致AI编程工具误解
6. 哪些需求第一阶段不该做
7. 哪些验收标准还不够具体
最后给出修订版PRD。
第四步：拆成开发任务
请把这份PRD拆成适合AI编程工具分阶段执行的任务。
要求：
1. 每个任务只改一个明确范围
2. 每个任务说明要读哪些文件
3. 每个任务说明要创建或修改哪些文件
4. 每个任务说明验收标准
5. 每个任务说明不要改什么
6. 按依赖顺序排序
请输出 Task 01 到 Task 10。
第五步：生成项目规则文件
请根据PRD生成三份项目规则文件草稿：
1. AGENTS.md：给Codex或通用coding agent使用
2. CLAUDE.md：给Claude Code使用
3. Cursor Rules：给Cursor项目规则使用
要求：
- 简洁
- 可执行
- 不写空泛口号
- 包含技术栈、目录结构、SEO规则、验收命令、禁止事项
八、AI开发网站时，任务要小，不要一次做完整站
很多人写完 PRD，又犯第二个错误：
让 AI 一次把整个网站做完。
不建议。
更好的方式是按任务推进。
推荐任务顺序
| 任务 | 目标 | 验收 |
|---|---|---|
| Task 01 | 初始化项目结构和基础样式 | 首页能打开，目录清晰 |
| Task 02 | 建立页面路由和metadata规则 | 核心页面有title/description |
| Task 03 | 建立内容模型和文章页模板 | 示例文章可渲染 |
| Task 04 | 建立专题页模板 | 专题页显示学习路径 |
| Task 05 | 建立工具页模板 | 输入、输出、错误状态可用 |
| Task 06 | 建立订阅/联系表单 | 表单可提交并有提示 |
| Task 07 | 生成sitemap和robots | 文件可访问 |
| Task 08 | 添加内链和CTA规则 | 文章能导向专题/工具/模板 |
| Task 09 | 移动端和基础可访问性检查 | 手机端无明显错位 |
| Task 10 | 上线前验收 | 按清单逐项检查 |
每个任务都应该独立验收。
不要让 AI 在一个任务里同时改首页、工具页、SEO、表单和样式。
范围太大，出错后很难定位。
九、PRD里必须写“不做什么”
“不做什么”非常重要。
第一阶段一定要写非目标。
示例：
第一阶段不做：
- 不做用户登录系统
- 不做付费会员
- 不做完整CMS后台
- 不做多语言
- 不做复杂动画
- 不接真实支付
- 不做AI实时生成工具，只做规则型网站类型选择器
- 不抓取第三方网站数据
为什么要写？
因为 AI 很容易为了“完整”加一堆你暂时维护不了的功能。
非目标能让它收敛。
十、网站PRD模板：可以直接复制
下面是一个简化版模板。
# 网站PRD
## 1. 项目背景
[这个网站为什么要做，面向谁，解决什么业务问题]
## 2. 项目目标
- 目标1：
- 目标2：
- 目标3：
## 3. 非目标
- 第一阶段不做：
- 暂不考虑：
## 4. 目标用户
| 用户角色 | 痛点 | 访问入口 | 期望动作 |
|---|---|---|---|
## 5. 网站结构
| 页面 | URL | 页面目标 | 主CTA | 优先级 |
|---|---|---|---|---|
## 6. 页面需求
### 页面名称
- 页面目标：
- 用户问题：
- 页面模块：
- 主CTA：
- 内链：
- 验收标准：
## 7. 功能需求
| 功能 | 输入 | 输出 | 异常状态 | 验收标准 |
|---|---|---|---|---|
## 8. 内容需求
- 栏目：
- 专题：
- 文章：
- 工具：
- 模板：
- 内链规则：
## 9. SEO需求
- URL规则：
- metadata：
- sitemap：
- robots：
- canonical：
- JSON-LD：
- Open Graph：
- 404：
## 10. 数据结构
[列出文章、工具结果、订阅、模板下载等数据字段]
## 11. 技术栈
- 框架：
- 内容管理：
- 样式：
- 表单：
- 部署：
## 12. 验收清单
| 项目 | 通过标准 |
|---|---|
## 13. 风险和边界
- 风险：
- 需要人工确认：
- 不能暴露的数据：
## 14. 开发任务拆分
| 任务 | 范围 | 输入文档 | 输出文件 | 验收 |
|---|---|---|---|---|
十一、跨境卖家做产品站时，PRD要多写这些内容
如果你做的不是 AI 内容站，而是跨境产品站，比如厨房收纳、宠物用品、户外装备，PRD 要增加产品和询盘相关内容。
产品站必须写清
- 产品分类
- 产品详情字段
- SKU 或系列关系
- 图片和视频素材
- 规格参数
- 材质说明
- 安装说明
- FAQ
- 批发询盘字段
- 样品申请流程
- 证书和资质
- 退换货政策
产品页字段示例
Product:
- slug
- name
- category
- useCase
- shortDescription
- dimensions
- material
- colors
- packageIncludes
- installation
- careInstructions
- certifications
- faq
- gallery
- inquiryCTA
询盘表单验收
询盘表单必须包含：
- name
- email
- country
- company
- productInterest
- quantityRange
- message
验收：
- 必填项校验
- 邮箱格式校验
- 提交成功提示
- 提交失败提示
- 不在前端暴露收件邮箱或API密钥
这些写清楚，AI 才不会只给你做一个“Contact Us”空表单。
十二、不要误读
不要误读一：PRD越长越好
不是。
PRD 要具体，不是冗长。
好的 PRD 是能执行、能验收、能减少歧义。
不要误读二：有PRD就可以不用人工验收
AI 做完以后必须人工检查。
尤其是：
- SEO规则
- 表单提交
- 移动端页面
- 公开页面和私有数据
- 业务文案
- 转化路径
不要误读三：AI会自动理解SEO
不会。
你必须把 metadata、sitemap、robots、URL、内链、Schema、OG 图这些规则写清楚。
不要误读四：一次生成完整网站效率最高
不是。
AI 开发更适合小任务、短反馈、逐步验收。
不要误读五：PRD写完就不改了
PRD 是活文档。
每次上线、复盘、发现新问题，都应该更新。
对 AI 工具来说，更新 PRD 和项目规则，就是在给下一次开发减少错误。
十三、今天就能做的30分钟练习
你不需要一开始写完完整 PRD。
先完成这张表。
| 问题 | 你的答案 |
|---|---|
| 网站第一阶段目标是什么？ | |
| 目标用户是谁？ | |
| 第一阶段必须上线哪些页面？ | |
| 每个页面的主CTA是什么？ | |
| 是否有文章、专题、工具、模板？ | |
| 表单提交后发生什么？ | |
| SEO必须包含哪些项？ | |
| 哪些功能第一阶段不做？ | |
| 什么叫做开发完成？ | |
| 哪些内容必须人工确认？ |
填完以后，再让 AI 根据表格写 PRD。
你会发现，AI 的输出质量会明显提高。
结论
AI 编程工具越强，越需要你把需求写清楚。
Cursor、Claude Code、Codex 可以帮你写代码、改文件、跑检查、修 bug，但它们不能替你决定网站目标、用户路径、SEO策略和转化动作。
网站 PRD 的价值，不是形式。
它的价值是让 AI 知道：
- 做什么
- 为什么做
- 怎么做
- 不做什么
- 做到什么程度算完成
不要让 AI 从一句模糊愿望开始写网站。先用 AI 帮你把 PRD 写清楚，再让 AI 按 PRD 分阶段开发。
参考资料
- Cursor Docs：Cursor Docs
- Cursor Docs：Rules
- OpenAI Developers：Codex web
- OpenAI Developers：Custom instructions with AGENTS.md
- Anthropic Docs：Claude Code overview
- Anthropic Docs：How Claude remembers your project
- Anthropic Docs：Claude Code common workflows
- Next.js Docs：Metadata and OG images
- Next.js Docs：sitemap.xml file convention
- Next.js Docs：robots.txt file convention
- Google Search Central：SEO Starter Guide
- Google Search Central：Creating helpful, reliable, people-first content