用途:本技能是纯文档型架构指南,讲解六边形架构(Ports & Adapters),即业务逻辑通过端口隔离、外部系统通过适配器接入,使应用可被用户、程序、自动化测试或批处理脚本平等驱动,并能在脱离最终运行设备和数据库的情况下开发与测试。
主要能力:提供六步工作流(主适配器协议转换→入站端口调用→应用服务编排→领域模型执行→出站端口持久化→次适配器技术实现);依赖规则(Adapter→Application→Domain,Domain 零外部依赖);端口粒度与异常转换规则;Strong/Weak 端口对比;分层目录结构;各层职责与代码规范;五阶段落地步骤;8 条常见陷阱与 8 条 FAQ;以及端口定义、主/次适配器、领域模型、应用服务、DI 配置、测试策略、渐进迁移等参考文件与多个示例。
使用方式:加载技能时建议先阅读 Workflow 与 When to Use 确认匹配度;技能提供技术栈、入口类型、团队规模三个配置维度。验证边界是否正确的方法是:不启动数据库和 HTTP,仅跑领域层单元测试即可通过。相关技能可通过 npx skills add full-stack-skills/ddd-skills --skill ddd-domain-designer 等命令安装。
适用场景:多入口系统(REST+CLI+MQ+gRPC)、基础设施频繁变更、追求极致可测试性、团队大于 5 人的微服务架构标准化。
限制:需要团队理解抽象设计、项目规模适中、配合 DDD 领域模型与良好 DI 容器支持;单一 REST API 加简单 CRUD、中文企业 MyBatis 生态、需 UseCase 与 Entity 严格分离、快速原型或 MVP 阶段均不适用,应改用其他架构。本技能不收集、不处理、不上传用户数据,代码模板仅为教学参考,外部服务 URL、密钥和凭证应配置为环境变量。