Document system

一个网站项目，需要两类 AI 友好文件。

一类放在项目根目录，帮助 AI 写代码；一类放在网站发布根路径，帮助外部 AI 和爬虫理解网站。文件职责、使用顺序和优先级都在这一页说明。

开发层

项目根目录文档

这些文件给写代码的 AI 看，告诉它怎么工作、做什么、写什么、怎么组织页面、怎么验收。

`AGENTS.md`：工作规则
`PRODUCT.md`：项目目标
`DESIGN.md`：页面表现规则
`CONTENT.md`：文案规则
`SITEMAP.md`：页面结构
`TESTING.md`：验收清单

访问层

网站公开文件

这些文件随网站一起发布，帮助搜索引擎、爬虫和外部 AI 更快理解站点内容。

`llms.txt`：给 AI 的网站摘要
`robots.txt`：爬虫访问规则
`sitemap.xml`：公开页面地图

Language rule

中文主体，英文文件名。

对中文项目，业务内容用中文更准确；文件名、路径、技术名保留英文，更符合工具习惯。

中文写需求

企业定位、受众、文案、页面偏好，用中文表达更少失真。

英文留给工具

`README.md`、`DESIGN.md`、`HTML`、`CSS` 这些名字保持英文，AI 和工具更容易识别。

结构比语言重要

真正影响 AI 效果的是分层清楚、规则可执行、禁区明确、验收具体。

Responsibilities

每个文件只管一件事。

不要把所有要求塞进一个超级文档。分层越清楚，AI 越不容易混乱。

AGENTS.md

管 AI 怎么工作：先读什么、不能做什么、冲突怎么处理、完成前怎么自检。

PRODUCT.md

管项目为什么做：项目是谁、用户是谁、网站目标是什么、转化动作是什么。

DESIGN.md

管页面表现规则：颜色、字体、间距、组件、布局和禁区。

CONTENT.md

管网站说什么：文案语气、栏目内容、SEO 关键词、哪些内容不能编造。

SITEMAP.md

管页面怎么组织：有哪些页面、导航顺序、每页区块顺序、URL 规划。

TESTING.md

管怎么验收：页面数量、导航、移动端、文案、表现、公开 AI 文件是否合格。

Workflow

从项目资料到完整网站。

实际使用时，先补齐文档，再让 AI 按顺序读取并生成页面。

Step 1

补齐项目事实

先写 `PRODUCT.md`，把项目名称、受众、目标、转化动作和不能编造的信息写清楚。

Step 2

补齐页面规则

写 `DESIGN.md`、`CONTENT.md`、`SITEMAP.md`，分别明确页面表现、文案内容和页面结构。

Step 3

补齐验收规则

写 `TESTING.md`，提前规定页面数量、链接、移动端、文案、公开文件等检查项。

Step 4

让 AI 读取文档

明确要求 AI 先读取全部项目文档，再创建或修改页面，不要边猜边写。

Step 5

生成完整网站

生成多个 HTML 页面、共享 CSS/JS，以及 `llms.txt`、`robots.txt`、`sitemap.xml`。

Step 6

按清单自检

完成后对照 `TESTING.md` 检查，不合格就继续改，不把半成品当完成。

Priority

文件之间要有优先级。

否则 AI 遇到冲突时会自己猜。最稳的方式是在 `AGENTS.md` 里写明优先级。