AI website docs

用一套文档,让 AI 稳定生成企业网站。

这个示例项目说明:在让 AI 写页面前,应该先准备哪些项目文档,以及这些文档如何约束目标、内容、结构、表现和验收。

PROJECT DOCS FIRST

先给上下文,再让 AI 动手。

否则 AI 只能凭感觉生成页面,目标、内容、结构和表现都容易漂移。

6 项目根目录核心说明文档
3 完整静态页面示例
3 对外 AI/爬虫识别文件

Why docs first

一句“做高级点”,不是需求。

AI 生成网站时,真正重要的是明确的长期约束:项目目标、内容边界、页面结构、页面表现和验收标准。

目标

先说明网站为什么做

`PRODUCT.md` 负责告诉 AI:项目是谁、给谁看、希望用户做什么。

表现

说明页面呈现规则

`DESIGN.md` 负责记录页面表现相关规则,和其它项目文档一起约束生成结果。

验收

最后说明怎么判断做对

`TESTING.md` 让 AI 生成后能自检,不只是写完就结束。

Two audiences

开发 AI 和外部 AI 看的文件不一样。

项目根目录里的 `.md` 文件主要给写代码的 AI 看;发布到网站根路径的 `llms.txt`、`robots.txt`、`sitemap.xml` 主要给访问网站的 AI 和爬虫看。

最小组合

  • 开发前:`AGENTS.md`、`PRODUCT.md`、`DESIGN.md`、`CONTENT.md`、`SITEMAP.md`、`TESTING.md`
  • 上线后:`llms.txt`、`robots.txt`、`sitemap.xml`
  • 页面:当前示例为 3 个完整 HTML 页面,不是单页长卷

Start

复制这套结构,再替换成你的企业信息。

不要让 AI 先写页面。先把项目事实、内容边界、页面结构、呈现规则和验收方式写清楚,再让 AI 执行。