# 智能体如何读取模型

*面向 AI 智能体的 Vercy · 第 1 课，共 4 课 · 约 10 分钟*

## 你将学到

冷启动协议：面对一个从未见过的合规模型，智能体在最初五分钟里该做什么。

## 智能体为何需要协议

被指向陌生仓库的智能体，面临的风险与人相同，只是被放大了：它读得快、漏得静、答得笃定。标准的回应是：一个合规的模型*会告诉你该怎么读它*，而智能体的首要职责就是接受这份邀请，而不是即兴发挥。

## 冷启动的顺序

1. **先读 `BOOTSTRAP.md`。** 这个模型希望被如何阅读、本地约定、硬性禁止事项。如果这个生态另有自己的入口文件（`CLAUDE.md`、`AGENTS.md`），随后再读：那份承载运行状态，BOOTSTRAP 承载结构。
2. **`manifest.yaml`。** 身份、有序的包、分类规则、排除项。现在你在打开任何文件之前，就已经知道每个文件*是什么*。
3. **`sources.yaml`。** 哪些数据集以此处为主，哪些是镜像、有多新鲜、冲突时谁胜出。要在*读内容之前*读它：否则你分不清权威知识与某人 wiki 的陈旧副本。
4. **按声明的顺序遍历。** 包以基础为先，层按顺序，层的 README 先于记录。这个顺序就是依赖顺序：定义先于用法出现。
5. **如果有遍历器就跑一遍**（`tools/mu-walk*`）。遍历亮红灯，说明这个模型自己的地图坏了：先报告这件事，再谈信任任何内容。

整个流程不过是三个小文件加一条命令，全部发生在读任何内容之前：一份对付后续所有错误的廉价保险。

## 带着权威意识作答

依据模型作答时，智能体会把主张追溯到记录，并把每条记录所属的数据集对照登记册核查：

- **以模型为主** → 直接作答；这就是经由声明确立的真相。
- **镜像，且新鲜** → 作答时点出主："据运维 wiki，采集于 2026-07-30"。
- **镜像，已陈旧** → 明说；宁可触发一次重新采集，也不要靠猜。
- **`status: declared`** → 这是意图，不是数据；绝不可当作事实呈现。
- **`status: retired`** → 冻结的历史："截至最终导出时"，绝非当前状态。

还有一个能避免微妙谬误的区分：`raw/` 中的抓取是*某个来源说了什么*的证据；而记录是*模型自己的陈述*。二者可能故意不一致（模型可以持有一条带批注的偏离）；引用时请据此区分。

## 这让每个人得到什么

人类团队得到的是：绝不会把线框图当成规范、也绝不会把死掉的追踪器导出当成活跃待办的智能体。智能体得到的则是更稀缺的东西：*证明*自己读得完整的能力——覆盖检查会点名它没读的每一个文件，以及原因。

## 要点

- 冷启动：BOOTSTRAP → 清单 → sources → 有序遍历 → 遍历器；然后才是内容。
- 每一个回答都带着权威上下文：以模型为主、镜像（多新鲜）、已声明，还是已退役。
- 证据（`raw/`）与陈述（记录）是不同的言语行为；不要把它们混在一起。

## 深入阅读

- [智能体操作指南](/spec/#07-guides/Agent-Operations.md)（本课的规范级版本）
- [模型遍历（ARCH-017）](/spec/#02-architecture/Model-Traversal-and-Layout.md)

下一课：[写入规则](02-writing.md)