用途:从代码、配置、部署清单和架构产物中反向推断分布式系统的权衡,产出基于证据的报告,说明系统优先什么、牺牲什么、哪些选择是有意还是默认、哪些风险值得关注。
主要能力:按六个权衡轴分析——一致性/可用性、延迟/吞吐、数据分布、事务边界、韧性/故障隔离、可观测性与安全与成本。证据分三层:A层硬承诺(API/SLA、一致性或事务保证、法定人数/复制规则、schema 不变量、协议要求)、B层机制证据(共识协议、租约、重试状态机、outbox 表、熔断配置、压缩策略、GC 标志)、C层运行特征(仪表盘、告警、runbook、复盘、采样配置、SLO)。证据冲突时优先靠近运行时行为的 B/C 层。
使用方式:整系统分析时执行 explain-system-tradeoffs,默认分析全部六个轴,并并行启动六个子代理(需在同一消息中发出六个 Task 调用);单轴分析使用对应命令,如 explain-system-consistency-tradeoffs、explain-system-latency-tradeoffs、explain-system-data-tradeoffs、explain-system-transaction-tradeoffs、explain-system-resilience-tradeoffs、explain-system-operations-tradeoffs,各自读取 references/ 下对应文件。先确定要分析的具体文件或目录,再逐轴收集证据台账并输出报告。
适用场景:审阅现有分布式系统架构、排查配置默认值带来的生产风险、判断权衡是否有意为之、跨轴张力分析。
限制:需要提供具体代码或配置路径;资料不足时报告“证据不足”而非猜测;默认配置被视为“未调优”而非错误;不建议对单服务 CRUD 应用套用同等严谨度。安装命令等资料暂未提供。