开发者说明¶

这页主要给维护者看。它解释的是文档边界，不是训练逻辑本身。

`specs/`、根目录文档和 `docs-site/` 各管什么¶

这里是实现约束来源。规则、数据格式、目录规划、训练边界都以这里为准。

根目录文档负责项目入口信息，例如：

这些文件本身已经是权威来源，因此文档站优先通过 symlink 接入，而不是再复制一份。

这里负责解释。解释的重点是：

也就是说，docs-site/ 应该帮助读者理解项目，而不是制造第二套事实来源。

文档重复最常见的问题不是“占空间”，而是后面没人能确定哪份才是最新的。

对这个项目来说，下面这些内容尤其不能复制两份：

所以只要已有 Markdown 已经是权威来源，就优先建立 symlink。

下面这些页面必须新写，因为它们的职责是解释，不是复述：

原因不是“英文不重要”，而是 specs/ 本身是开发约束文件，当前你已经明确要求：

因此文档站的做法是：

判断方法很直接：

这样分层后，维护者看到一个页面时，能直接知道这页是在“定义规则”还是在“解释规则”。