architecture-paradigm-hexagonal
隔离领域与基础设施的六边形架构方案
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：architecture-paradigm-hexagonal。 它的用途是：隔离领域与基础设施的六边形架构方案 完整的 Skill 内容见：https://321skill.com/skills/architecture-paradigm-hexagonal-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用六边形架构重构用户模块，将领域逻辑与数据库实现分离'，它会生成用户领域实体、仓库端口接口，以及基于Prisma或TypeORM的适配器实现，并自动创建依赖注入配置，让你直接替换原有耦合代码。
介绍
六边形架构（Hexagonal Architecture）是一种将业务领域逻辑与外部基础设施（数据库、API、UI等）彻底隔离的架构模式。实际开发中，业务逻辑常被框架、数据库或第三方服务耦合，导致代码难以测试、迁移和演进。本 Skill 提供了一套完整的代码模板和依赖注入示例，帮助你在项目中快速落地六边形架构，确保领域层独立于任何外部依赖。
使用方式非常直接：你只需定义核心领域模型和端口接口，Skill 会自动生成适配器实现骨架，并注入到依赖容器中。它支持常见语言（Java/Kotlin/TypeScript）和框架（Spring、NestJS），同时提供 CLI 命令一键初始化项目结构。无需手动编写端口适配器样本，大幅减少重复劳动。
适合后端开发工程师、全栈工程师以及架构师，尤其适合中大型项目、微服务拆分或需要长期维护的领域驱动设计（DDD）项目。如果你是初学者，可以通过生成的示例代码快速理解六边形架构的分层协作方式，提升代码质量和可测试性。
建议在项目初期就引入本 Skill，避免后期重构成本。配合依赖注入容器和单元测试框架使用效果最佳。注意：对于简单的 CRUD 应用，六边形架构可能带来过度设计，请根据项目复杂度评估是否采用。
核心特点
不仅提供架构模式的理论说明，更直接生成可运行的端口-适配器代码模板和依赖注入配置，让开发者从零开始就能写出符合六边形架构的隔离代码，避免手动编写样板文件。
注意事项
不适合极简单的 CRUD 应用或原型验证阶段，过度引入会增加代码量。
常见问题
六边形架构与整洁架构有什么区别？
六边形架构强调端口与适配器分层，整洁架构更强调用例与实体依赖规则，两者本质相同，六边形架构更侧重技术实现层面的隔离。
如何开始使用？
安装后在项目根目录运行 `hexagon init`，根据提示选择语言和框架，系统会自动生成领域层、端口层、适配器层的目录结构和示例代码。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/architecture-paradigm-hexagonal-x/raw/index.md 读取 architecture-paradigm-hexagonal 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/architecture-paradigm-hexagonal-x/raw/index.md（查看排版版本）