> 译文仅供阅读便利。具有规范效力的是英文原文。

# AGENTS.md - 以 AI 智能体的身份来读元宇宙

本文件是 AI 智能体（或任何自动化工具）吞入本仓库时的入口。它告诉你先读什么，以及哪
些产物是机器可读的。

## 这是什么

元宇宙是一**族开放标准**，面向联邦式的语义系统：讲的是彼此独立的意义"宇宙"如何描
述现实、如何建元模型、如何联邦知识，同时保全身份、语境、所有权、信任与可追溯性。它
是一份规范，不是一套运行时。

## 按这个次序读

1. **`spec-index.yaml`** - 所有文档的机器可读索引（id、类别、状态、路径）。要枚举
   这份规范，从这里起头。
2. **`00-foundation/Terminology.md`** - 规范性的词汇表。术语到这里来解，不要从文字
   里去猜。
3. **`01-constitution/Meta-Universe-Constitution.md`** - 那些根本大法（21 条）。每
   条规范性语句都有编号（`MUC-Rnn`）。
4. **`REQUIREMENTS-INDEX.md`** - 所有规范性文档中每一条 RFC 2119 要求，带稳定编号。
   引用时请用这些编号。
5. **`02-architecture/MMAS-Interchange.md`** + **`schemas/`** - MUIF 序列化与各份
   JSON Schema：模型那副具体、可校验的面孔。
6. **`03-federation/MUFP-Messages.md`** - 联邦所用的线上协议（信封、状态机、错
   误）。

## 机器可读的产物

| 产物 | 用途 |
|----------|-----|
| `spec-index.yaml` | 枚举各份文档及其状态。 |
| `schemas/*.schema.json` | 校验 MUIF 模型、MUFP 信封、发现文档与校验报告（JSON Schema 2020-12）。 |
| `REQUIREMENTS-INDEX.md` | 按编号称引单条规范性要求。 |
| `mu-fingerprint`（见 `tools/`） | 算出一份模型可复现的语义指纹。 |
| `mu-validate`（见 `tools/`） | 依 V0-V2 各项检查校验一份 MUIF 模型。 |
| `/.well-known/meta-universe.json` | 一个宇宙的发现文档（见 `examples/well-known/`）。 |

## 走通的示例

- `examples/minimal-person/` - 最小的模型，以及指纹的可复现性。
- `examples/federation-acme-govtax/` - 两个宇宙从头到尾做一场联邦。
- `examples/federation-handshake/` - 一份 MUFP 的消息记录。
- `examples/interop/` - 映射到 RDF/OWL、Schema.org、FHIR、FOAF。

## 在一份合规模型上作业（而不是在这份规范仓库上）

若你被指向的是一个*模型仓库*（其中有 `BOOTSTRAP.md`、`manifest.yaml`、
`sources.yaml`），你的操作说明是 **`07-guides/Agent-Operations.md`**：先读
BOOTSTRAP → 清单 → 来源，再读内容；按声明的次序走各个包；**只**写入该数据集所声明
的主；绝不手改 `raw/`、镜像或 `artifacts/`；结构有变之后重跑覆盖巡查器；执掌未经声
明时，拒绝写入。整套标准那份连贯的、给人读的地图是
**`00-foundation/Overview.md`**。

## 在元宇宙之上建造智能体

见 **`07-guides/AI-Integration-Patterns.md`** 与
**`07-guides/AI-Agent-Guide.md`**：把元模型当作工具架构载入，经投影与事件取回意义
（而不是原始行），在回路之内强制执行可执行语义合约，并给出可追溯的结果。

## 交手时的规矩

- 把**术语表**与**宪章**当作权威；不要从说明性的文字里去推规范性的含义。
- 一份模型"意思相同"，当且仅当它的**语义指纹**相合。
- 绝不要把架构可被发现，误当成数据可被访问。