用途:当侧边栏、领域子菜单、工作区标签与页面局部标签混在一起,同一标签出现在多个导航作用域,路由、深链、返回状态或上下文传递不清晰,局部修正可能改动整个导航层级,或生成页面反复改变菜单顺序、措辞与嵌套时使用。仅用于美化导航栏或挑选图标时不适用。
主要能力:以共享包边界细化 ui-design-spec 规范模式提供的规范导航与页面进入/返回部分,保留固定 ID、来源版本与任务引用;加载权威基线,优先采用已批准的 IA/注册表与明确决策而非截图中的偶然内容;按作用域盘点导航,为每项分配稳定 ID 并归类为全局、领域级、工作区级、页面局部或临时导航;将存在性与激活状态分离,独立记录固定项清单与某路由下激活项;定义路由,为每个导航动作指定来源、目标、所需上下文、规范路由、深链重建及未找到/禁止行为;定义上下文传递,在用户期望返回连续性时保留稳定标识与可序列化页面状态;定义返回行为,抽屉/模态关闭、下钻返回、浏览器后退与跨页返回均需明确契约;定义不变量,说明同一作用域内切换时不得改变的内容;对未解决的同步问题标记为 needs-decision 而非猜测。输出形态参考 references/navigation-contract.md,定稿前阅读 references/anti-patterns.md。
使用方式:直接仅需导航时无需路由器或 Harness;由 Harness 调度时,将导航阶段结果与证据返回活动数据包,不重启整体流程。
输出契约:按作用域的导航清单、路由注册表、激活矩阵、上下文与返回契约、深链/错误行为、不变量与待决策项,以及适用于 UI/E2E 验证的验收检查。
最佳实践与限制:不按标签去重,同一文本可合法存在于不同作用域;不动态镜像,工作区/页面局部集合不会自动成为侧边栏子项;不过度修正,停止新增不等于删除已批准的固定项;按稳定 ID 而非显示名路由;结构与激活状态保持分离;截图是视觉证据,不自动作为 IA 事实来源。资料未提供具体收费、平台与安装命令信息。