# Universe 迁移增量学习包 v1（active）
> **文档类型**：增量治理对齐学习包（非全量 re-onboarding）
> **状态**：active（R 审定 2026-08-08 08:54，正式发包）
> **版本**：v1 · 2026-08-08
> **落位**：`Nebula/99_System/agents/Onboarding/`
> **审定**：珍珍（Ray）主控审定
> **依据**：R 批准 B 方案（2026-08-08）——P2 系列不触发全量 re-onboarding；但因跨库 canonical、路由、状态机与旧位 pointer 发生实质变化，触发一次"增量治理对齐学习"。既不把文件迁移夸大成身份重构，也不留下"字面触发但未闭环"的审计债。
---
## 0. 定性声明（先读这个）
- 本次**不是**重新入职（onboarding），**不是**身份/设备/数据域/权限变更，不重跑历史 onboarding；
- 本次是**增量治理对齐**：P2-1 ~ P2-10（Universe P2 候选治理件迁移工程）已全部封板，治理文件的 canonical 位置、四线边界、状态机、脚本纪律发生实质变化；
- 未完成本学习包回执的 agent，**不算"已对齐"**；但未签不改变任何既有身份与权限（仅影响对齐状态记录）；
- 学习范围固定为 5 件（见 §1-§5），不扩展、不重学历史。
---
## 1. 新 canonical：治理文件去哪了（P2 系列迁移结果）
迁移工程后，**治理件以 Universe 库为 canonical**，Nebula 旧位只留兼容 pointer。
### 1.1 新主路径总表（读/写/引用一律用这些）
| 板块 | canonical 位置 | 文件 |
|------|----------------|------|
| 宪法层 | `Universe/99_System/Blueprint/` | `Universe_Blueprint_v0.2.md`（跨库冲突以它为准） |
| 治理规则 | `Universe/99_System/Governance/` | `Universe_Content_Routing_Rules_v0.3.md`（路由/信号回流）
`Universe_Library_Access_Boundary_v0.2.md`（权限边界）
`Universe_Mechanism_Layer_Map_v0.2.md`（机制分层 + §7 前置审查门槛）
`Universe_Control_Panel_v0.2.md`（**只读视图/指挥舱**，不写数据） |
| 规则细则 | `Universe/99_System/Governance/Rules/` | `Universe_Skill_Naming_Rules_v0.2.md`（命名/alias）
`Universe_Skill_Canonical_Scope_Clarification_v0.2.md`（能力分类/挂载边界） |
| 治理待办 | `Universe/99_System/Governance/Backlog/` | `Universe_Governance_Backlog_v0.2.md`（看板 + 状态机）
`Universe_Backlog_Batch_Rules_v0.2.md`（批处理规则） |
| 登记注册 | `Universe/99_System/Registry/` | `Components_Registry.md` / `Library_Registry.md`（P2-1）
`Agent_Capability_Registry.md` / `Platform_Capability_Matrix.md`（P2-5） |
| 变更索引 | `Universe/99_System/Changes/Agent_Change_Index/` | 每日 `YYYY-MM-DD.md` + `INDEX.md`（P2-6） |
### 1.2 核心规则
- **先找新主，不引用旧位**：遇到旧位 pointer 时，先读其头部的 canonical/承接说明，再实查新主位置；**不得把 pointer 当作可写正文**（P2-8 教训）；
- **内容定位 vs 权限边界是两套维度**，不能混（P2 系列固定口径）；
- 新机制必须先过 `Mechanism Layer Map §7` 前置审查门槛，不能直接落地。
---
## 2. 四线边界：治理待办 / 执行任务 / 决策事项 / 变更索引
P2-9 之后四线正式拆开，**互不替代、互不自动生成**。边界以 `Backlog v0.2 §0` 为 canonical：
| 对象 | 正式职责 | 关键纪律 |
|------|----------|----------|
| **Governance Backlog** | 跨库治理、架构、规则、历史债务、待复核事项的**治理待办队列** | 入队走 §7 规则；拍板 ≠ 自动重启 |
| **Task-Queue** | 已明确执行主体与动作的**执行任务队列**（`Nebula/99_System/Task-Queue/`） | 与 Backlog 分开，不混放 |
| **Decision Backlog** | Backlog 中等待 JR/珍珍拍板的**决策子类** | 不另造平行总表 |
| **Decision Layer** | 决策记录、采纳权重与流转**原则**（`Rules/Decision_Layer_通用原则.md`） | 是原则不是队列 |
| **Agent Change Index** | **已发生实质变更的索引**（`Universe/99_System/Changes/Agent_Change_Index/`） | **不自动生成 Backlog**；只有明确触发规则（`backlog_candidate: true` + 理由 + 审定）才创建治理待办 |
---
## 3. Backlog v0.2 状态机：五态 + 7 字段
### 3.1 五态枚举
`active`（进行中） / `pending`（等待条件） / `blocked`（被阻塞） / `deferred`（延后） / `closed`（关闭）
### 3.2 条目 schema（对新增条目生效）
| 字段 | 含义 |
|------|------|
| `status` | 五态之一 |
| `owner` | 责任人 |
| `entry_reason` | 入队理由 |
| `reentry_trigger` | 重新激活触发条件 |
| `exit_condition` | 退出/关闭条件 |
| `last_reviewed` | 上次复核时间 |
| `next_review_date` | 下次复核时间 |
### 3.3 存量纪律（重要）
- **存量 31 条不批量补填**上述字段——在状态复核或真实触发时渐进补齐；
- **不自动重启**任何暂停/等待条目——19 条 + 8 批 Batch 计划进入复核，**拍板 ≠ 自动重启**，任何条目转可执行仍需单独放行指令；
- 状态非 `active` 不开批（Batch Rules v0.2 §0）。
---
## 4. 脚本纪律：新主必检（FAIL）/ 旧位兼容（WARN）
两套巡检脚本（`Nebula/99_System/scripts/`）统一语义：
| 脚本 | 新主（Universe canonical） | 旧位（Nebula legacy pointer） |
|------|---------------------------|-------------------------------|
| `Registry_Automation/registry_check.py` | `UNIVERSE_GOVERNANCE_FILES` 存在性缺失 = **FAIL**；Backlog 家族/Control Panel 严格三字段（`scope: universe_governance` / `hosted_by: universe` / `system_layer: universe_governance`）缺失 = **FAIL** | 旧 `GOVERNANCE_FILES` 条目保留兼容检查 |
| `nebula_system_audit.py` | `uni_keys` 存在性缺失 = **FAIL** | `legacy_pointers` 缺失 = **WARN**（不阻断） |
- 退出码语义：**FAIL > 0 → exit 1；FAIL = 0 → exit 0**（WARN 不阻断）；
- 支持 `--root` 参数（跨设备指定库根）；
- 遇到旧位文件缺失：**先查是不是迁移/冻结/归档**，再判断是 WARN 还是真异常。
---
## 5. 旧位三种文件语义与查找新主
迁移后 Nebula 旧位只保留三类"非正文"文件，**都不再作为规则正文维护**：
| 类型 | status | 含义 | 遇到它怎么办 |
|------|--------|------|--------------|
| `legacy_pointer`（含 `legacy`） | 兼容位 | 正文已迁 Universe，旧路径仅供历史引用/旧流程可读 | 读文件头 → 找到 `canonical 位置` / `新主路径` 行 → 去新主读正文 |
| `frozen` / `frozen_split_pointer` | 冻结 | 内容已过时或已被拆分承接（如 Roadmap v1.0、Operating Loop v1.1） | 只作历史参考；承接位置见文件内说明（如 Loop §7 → Backlog v0.2 §7） |
| `archived` | 历史归档 | 草案/设计稿已归档（如 Blueprint v1.0 DRAFT、架构设计稿） | 原文在 `Nebula/99_System/Backup/` 时间戳目录；仅审计/回溯用 |
**查找新主的通用路径**：
1. pointer 文件头（`canonical 位置` / `新主路径` / `承接` 行）；
2. `Governance/README.md` 候选池与落地清单；
3. `Universe_Document_Canonicalization.md` 追踪表（逐文件处置状态）。
---
## 6. 回执要求
每个覆盖对象提交一份轻量回执（模板如下），**不需要全量入职报告**：
```markdown
## agent_id:
agent_name:
signed_at:
read_scope: Universe Migration Incremental Alignment v1
acknowledged_changes:
- （列出已确认的变化点，可写"5 件 + 第 6 项全部确认"）
questions_or_conflicts:
● 无 / （列出疑问或冲突）
```
**回执回挂位置**：`Universe/99_System/Changes/Agent_Change_Index/`（每日文件或 Receipt Tracker，见 Agent Change Index Rules）。
**流程**：阅读学习包 → 提交回执 → 珍珍审定是否完成对齐。**未签不算已对齐**。
---
## 6. 通讯协议增量对齐（Agent Communication Protocol 补充项）
随本学习包一并部署的轻量通讯协议（详见 `Universe/99_System/Governance/Agent_Communication_Protocol_v0.1.md` 草案），**增量对齐、不全员重入职**：
- active agent **自选一个唯一固定 Emoji**（由本人选定后登记，不由系统代选）；
- 内部协作完整消息以该 Emoji 收尾（轻量身份水印 + 完结标记，**不是权限证明、不替代正式签名**）；
- 提交一行轻量确认（agent_id / agent_name / emoji / 生效时间）；
- `Universe/99_System/Registry/Agent_Communication_Emoji_Registry.md` 登记后生效；
- **不改**身份、权限或工作域；Emoji 修改属治理变更，需记录。
---
## 7. 执行边界（R 批准口径，不可逾越）
- 学习包落 Neb 可见治理区，经 Neb 实查；
- 回执统一回挂 Universe Agent Change Index / Receipt Tracker；
- 未签不算"已对齐"；
- **不改** agent 身份、设备、数据域或权限；
- 这不是全量 re-onboarding，不重跑历史 onboarding；
- 覆盖对象以 Universe Agent Capability Registry / 当前 roster 为准，不把 retired、不接触该路径的 agent 强拉进来。
---
> **版本说明**：v1（2026-08-08）· 经 R 审定（08:54）：内容通过、5+1 项范围不扩展、措辞微调 §1.2 → 正式发包，状态升 active。按覆盖对象逐个发包；回执收齐后交汇总表，由 R 审定，不自动宣告全员已对齐。