用途:该技能为软件架构设计提供建议、评估、文档化与迁移支持,属于单一职责的原子技能,声明为幂等。
主要能力:通过 action 参数提供四种操作:recommend(推荐架构模式)、evaluate(评估现有架构)、document(生成架构文档)、migrate(制定迁移方案)。可结合需求(功能与非功能指标)、团队规模、约束条件给出主推荐模式及备选方案,并说明权衡取舍。内置模式目录包括 layered、hexagonal、clean、cqrs、event_sourcing,记录其复杂度、可扩展性、可测试性及适用场景。决策矩阵覆盖简单 CRUD、复杂领域、高可扩展性、审计需求等情形。输出格式支持 text、diagram、adr,可实现 ADR 文档生成。
使用方式:调用时传入 action 参数;recommend 需提供 requirements(含功能列表和非功能项:scalability、maintainability、testability、performance,以及 domain_complexity);evaluate 和 migrate 需提供 current_architecture;migrate 还需 target_architecture。可选参数含 constraints、team_size、output_format。重试逻辑最多 3 次,指数退避,初始 2000ms、上限 20000ms、乘数 2,仅对 TIMEOUT 与 RATE_LIMIT 重试;INVALID_REQUIREMENTS 与 UNKNOWN_PATTERN 不重试。错误码 400,并提供恢复提示。依赖 pattern_matcher 与 adr_generator,发出 architecture_recommended、architecture_evaluated、adr_generated 事件。
适用场景:简单 CRUD 且小团队宜用 layered;复杂业务逻辑与高可测试性宜用 hexagonal;企业级长期系统宜用 clean;读多写多且扩展需求差异大宜用 cqrs;有审计或时间查询需求宜用 event_sourcing。
限制:未提供价格、平台支持范围、具体效果数据及外部集成细节,暂未提供。