分层导航设计原文节选

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

memory.md 编写规范

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

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

设计原则

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