architecture-paradigm-hexagonal
应用六边形架构隔离领域与基础设施
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：architecture-paradigm-hexagonal。 它的用途是：应用六边形架构隔离领域与基础设施 完整的 Skill 内容见：https://321skill.com/skills/architecture-paradigm-hexagonal-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用六边形架构重构我的用户模块，定义用户Repository端口，并生成一个基于JPA的适配器实现'，它会生成端口接口、适配器类以及Spring Bean配置，确保领域层不直接引用任何JPA注解，实现完全解耦。
介绍
六边形架构（端口与适配器模式）解决传统分层架构中领域逻辑与数据库、UI、外部API等基础设施深度耦合的问题。通过将业务核心暴露为纯接口（端口），所有外部依赖通过适配器注入，使领域层彻底独立，提升可测试性、可维护性和可替换性。
使用该Skill时，首先定义领域层的端口（如Repository接口、Service接口），然后编写适配器实现（如JPA适配器、REST适配器），最后通过依赖注入容器装配。该Skill通常提供项目模板、代码示例和架构指南，帮助开发者快速搭建符合六边形架构的代码骨架。
适合后端开发、全栈开发以及需要长期维护中大型系统的架构师。尤其适用于采用领域驱动设计（DDD）的项目，或需要频繁切换数据库、消息队列等基础设施的场景。
建议在项目初期引入，避免后期重构成本。对于简单CRUD或原型验证项目，可能过度设计。注意保持端口粒度适中，避免过度抽象导致开发效率下降。
核心特点
同类架构Skill多关注分层或微服务，而该Skill严格聚焦于领域层零依赖，通过纯接口定义端口，不绑定任何框架或ORM，适配器可完全独立替换，实现真正的领域与基础设施隔离。
注意事项
不适合小型原型或快速迭代项目，因为引入额外抽象层会增加初始开发成本和认知负担。
常见问题
六边形架构和传统分层架构有什么区别？
传统分层架构中上层依赖下层，领域层常耦合数据库；六边形架构通过端口反转依赖，领域层完全不依赖任何外部技术，测试时只需Mock端口即可。
这个Skill如何与依赖注入框架配合？
端口定义在领域层，适配器实现在基础设施层，通过依赖注入容器（如Spring、Guice）将适配器装配到端口上，运行时即可按需切换。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/architecture-paradigm-hexagonal-x-4/raw/index.md 读取 architecture-paradigm-hexagonal 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/architecture-paradigm-hexagonal-x-4/raw/index.md（查看排版版本）