多模块架构协议 (Multi-Module Protocol)

多模块协议 (skills/references/multi-module.md) 用于协调跨越多个模块或仓库的变更。

概述

当一项功能影响多个仓库或工作区时，Praxis 会切换至 multi-module 拓扑。

praxis: scope=complex, topology=multi-module, loading=design,plan,worktree,subagents,review,ship

协议核心要素

1. Coordinator 协调仓库：用户显式指定一个现有的仓库作为 Coordinator，由其持有跨模块规范、工作区计划及变更清单（change-set）。
2. 磁盘模式标记：规范与计划文件顶部包含显式声明块：

   topology: multi-module
   change-set: <topic-id>
   coordinator: <repo path>
   repos: <repo paths>

   后续技能通过读取该声明重锚定模式，无需依赖会话上下文记忆。
3. 共享与局部规范：共享契约仅定义在 Coordinator 规范中；各模块在其仓库中维护局部规范并引用共享契约，严禁重复定义。
4. 集成与提交顺序：各模块独立构建并针对共享验收测试进行验证。提交按照依赖顺序执行，Coordinator 仓库最后提交，并在提交信息中共享 change-set ID。