CQRS 实现指南

什么时候该上 CQRS

业务里读和写的比例、模型形状往往不一样：列表页要宽表聚合，写侧要保护不变量；报表要扫大量历史，交易路径又要低延迟。若仍共用一套 CRUD 模型，查询要么拖慢写入，要么为了读性能把领域模型拆得面目全非。CQRS（命令查询职责分离）把写模型（命令）和读模型（查询）拆开，中间用投影或事件流同步，让你可以分别优化扩展路径。

技能在帮你做什么

本技能是一份落地 CQRS 的检查清单与模式说明，而不是替你在框架里写代码：

• 先对齐约束：识别读写工作负载、一致性是强即时还是最终一致，以及能否维护独立的读库/读表。
• 划清边界：为命令定义变更意图与不变量，为查询定义只读视图与索引策略，避免「查询里偷偷改状态」。
• 读侧投影：设计读模型如何从写侧或事件日志更新（同步、异步、重放），并考虑 lag 与重建。
• 验证与运维：压测读写路径、演练故障（投影停更、重复投递、部分失败）与恢复流程。

需要更细的模板与模式时，按 SKILL 指向打开 resources/implementation-playbook.md。

适用边界

领域简单、CRUD 已够用，或组织上无法操作独立读写存储、又要求处处强即时一致时，不要硬上 CQRS——同步与运维成本会盖过收益。