Skills Directory精选自 GitHub 的开源 Skills
中文

hexagonal-architecturecommit d29cf65SKILL.md · 架构设计

六边形架构

按端口与适配器模式设计、实现或重构系统，让业务逻辑独立于框架、传输和持久化细节。

npx skills add affaan-m/ECC --skill hexagonal-architecture
权限
  • read-repo
  • write-files
  • shell
  • network
兼容工具
Claude Code, Codex, Cursor, Copilot, OpenCode
GitHub
294.3k
来源
社区 · Affaan Mustafa
状态
扫描通过
许可证
MIT
分类
架构设计
代码仓库
github.com/affaan-m/ECC/skills/hexagonal-architecture

核心规则

依赖方向永远向内：领域不依赖任何外部事物，适配器在边缘实现端口。

执行阶段

  1. 阶段 01划定用例边界

    为单个用例定义清晰的输入输出 DTO，把 req、GraphQL context 等传输细节挡在边界外。

  2. 阶段 02先定义出站端口

    把持久化、外部调用、日志和时钟等每个副作用都建模为端口，端口描述能力而非技术。

  3. 阶段 03编排用例

    用例通过构造函数或参数接收端口，只负责校验不变量、协调领域规则并返回普通数据结构。

  4. 阶段 04适配器与装配

    在边缘实现入站和出站适配器，映射逻辑留在适配器中，并在唯一的组合根集中装配依赖。

  5. 阶段 05按边界测试

    用假端口做用例单元测试，用真实基础设施做适配器集成测试；改造既有系统时逐个切片迁移，不做大爆炸式重写。

权限说明（据 SKILL.md 整理）

能力是否需要说明
文件写入需要创建或重构领域、用例、端口、适配器、组合根和测试代码。
命令执行不需要技能未要求运行命令。
网络外发不需要不访问网络。

SKILL.md 头部信息（YAML）

SKILL.md 头部信息（YAML）commit d29cf65
---
name: hexagonal-architecture
description: Design, implement, and refactor Ports & Adapters systems with clear domain boundaries, dependency inversion, and testable use-case orchestration across TypeScript, Java, Kotlin, and Go services. Use when introducing or refactoring toward Ports and Adapters, or when domain logic has become entangled with I/O.
metadata:
  origin: ECC
---

相关技能

规则扫描无法覆盖所有风险，安装前请阅读此技能的 SKILL.md，确认权限后再使用。
Markdown 版本 GitHub