核心用法
agent-architecture-designer 是一款以验证驱动为核心的架构设计专家代理技能。与传统架构建议工具不同,它强制要求"先证明,再推荐"——任何架构决策都必须经过可运行的原型验证。
工作流程四步闭环:
1. 需求分析 — 调用 mcp__sequential-thinking__sequentialthinking 深度拆解需求
2. 模式选择 — 联动 architecture-patterns 技能,基于决策矩阵选择应用模式(单体/模块化单体/微服务)、API 模式(REST/GraphQL/gRPC)、数据模式(Repository/CQRS/事件溯源)
3. 强制验证 — 针对推荐元素执行最小验证集:API 需 curl 测试、微服务需容器通信验证、数据库需 EXPLAIN ANALYZE、消息队列需投递确认、缓存需命中率测量
4. ADR 归档 — 输出带验证证据的架构决策记录
输出交付物:
- 可运行的原型代码与 Docker 配置
- 负载测试/安全扫描/指标报告
- 附带验证证据的 ADR 文档
- 运维就绪方案(监控、告警、Runbook)
显著优点
- 反脆弱性设计:通过强制原型验证,在决策早期暴露集成风险与性能瓶颈
- 可量化决策:所有推荐附带实测吞吐量、延迟数据,告别"应该能扩展"的模糊承诺
- 完整链路覆盖:上游对接需求分析,下游移交经验证的实现方案,形成闭环
- 生产级交付:不仅设计架构,更交付运维就绪的完整方案
潜在局限
- 启动成本较高:强制验证要求额外时间与计算资源投入,不适合探索性草图阶段
- 技术栈锁定风险:原型验证可能隐含特定技术假设,迁移需重新验证
- 认知负荷:使用者需理解验证协议与 ADR 格式,有一定学习曲线
- 工具依赖:重度依赖 MCP 工具链(如
mcp__context7__resolve-library-id),环境配置复杂
适合人群
- 技术负责人/架构师:需在团队内推行证据驱动决策,建立技术公信力
- 高可用场景团队:金融、电商等核心系统,无法承受"纸上架构"的生产事故
- 遗留系统改造:通过原型验证降低迁移风险,渐进式演进架构
常规风险
- 验证偏见:原型可能无法完全模拟生产环境(如数据规模、网络分区),存在"验证通过但生产失效"的盲区
- 过度工程化:严格的验证流程可能导致对简单场景过度设计,需权衡投入产出比
- 安全误报:简介注明报告为系统占位生成、未执行真实安全扫描,实际部署前需补充独立安全评估