# 分层导航设计原文节选

下面节选自我整理的《Hub 架构与维护》，介绍各层入口怎样分工，以及资料怎样按需读取。整理日期：2026-10-17。

## memory.md 编写规范

每个 `.agent/memory.md` 文件遵循**层级委派、逐级下钻**的原则：

| 规则 | 说明 |
| --- | --- |
| **只管直系子级** | 目录树仅展开到当前目录的直接子文件夹，不得展开下一层的内部文件结构 |
| **细节下放** | 子文件夹内部的文件列表、操作规范等细节，由该子文件夹自己的 `.agent/memory.md` 负责维护 |
| **父级只做路标** | 父级 memory 对子模块的描述应是一句话概括 + 路由标签（帮助命中的关键词） + 指明详见该目录下的入口文件。路由标签不视为冗余 |
| **新增只改一处** | 普通项目或子模块只在直接父级的 memory 中登记；新增领域或用户明确要求全局快捷入口时，再按全局导航表维护规则更新总入口 |
| **导航不越级** | 目录 memory 导航表中，父级不直接指向孙级目录，而是通过中间层逐级路由（全局导航和关键词速查等扁平索引除外） |

## 设计原则

| 原则 | 做法 |
| --- | --- |
| **单一数据源** | 同一信息只存一处，其他地方用链接引用 |
| **单点维护** | 新增资料时，更新直接负责该内容的索引 |
| **两层索引** | 全局导航按领域路由到入口，再逐级下钻；关键词速查按具体主题定位条目 |
| **按性质归位** | 判断文件放哪时，看它是什么性质；同类内容放同一处 |