用途:在编码与 TDD 之前先完成系统化架构阶段。核心原则是“画不出图,就写不了这个功能”。
适用判断:单文件 bug 直接进入 TDD;少于 3 个文件的新功能做 10 分钟简短架构;超过 3 个文件的新功能、新模块或限界上下文、技术迁移、外部集成(API、MQ、DB)则必须执行该阶段。
五步流程:一、识别边界,包括领域、分层(Presentation/Application/Domain/Infrastructure)、进程(同步 HTTP/异步队列/事件驱动)、数据与归属边界。二、为每个边界定义契约:输入格式与不变量、输出与错误码、副作用、幂等性、事务性。三、绘制依赖方向,检查无循环、遵循依赖倒置、入口到业务侧调用不超过三层。四、记录非显而易见决策的权衡,产出简短 ADR(3—5 条)。五、定义架构测试,如依赖测试(ArchUnit、Dephpend、deptrac)、契约测试、性能目标与多租户隔离测试。
交付物:一页以内依赖图、边界契约(签名与 DTO)、简短 ADR、架构测试清单、原子任务拆分。完成后方可进入 Red/Green/Refactor。
集成与资源:/workflow:design 默认使用该技能,@tech-lead 代理可产出架构输出;正式 ADR 见 /common:architecture-decision;相关规则包括 SOLID、CQRS、多租户与文档规则。
反模式:无图直接编码、简单功能架构超过 2 小时、契约模糊、忽略权衡、闭门造车,应分别以先画图、YAGNI、严格类型、强制 ADR、同行或 subagent 评审应对。
限制:具体命令、安装步骤、收费与平台信息暂未提供。文档标注版本 1.0.0,最后更新 2026-04-15。