ddd4j-core

Q: How do I install ddd4j-core?

Run npx skills add https://github.com/full-stack-skills/ddd-skills --skill ddd4j-core in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ddd4j-core/ (personal) or .claude/skills/ddd4j-core/ (project).

by full-stack-skills

DDD4J Boot 核心开发约定技能。覆盖实体继承链(BaseEntity→Model /PaginationEntity)、DDD注解规则(@DomainEntity是SOURCE/@DomainService≡@Service)、Controller层级(BaseController→BaseMapperController)、Service层级(IBaseService→BaseServiceImpl)、返回值约定(ApiRestResponse三态success/fail/error、分页返回rows非data)、查询参数位置(beginTime/endTime/keywords/params在Entity上)、国际化NestedMessageSource、审计字段自动填充、Dozer对象映射。当用户在 DDD4J 项目中编写 Entity/Service/Controller、处理返回值格式、使用 DDD 注解时需要此技能。与 ddd4j-jackson(序列化)、ddd4j-mybatis(持久层)、ddd4j-validation(校验)、ddd4j-satoken(鉴权)协同使用。

Installs: 52
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/full-stack-skills/ddd-skills --skill ddd4j-core

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads ddd4j-core automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

DDD4J Boot 核心开发约定

基于 ddd4j-boot 项目源码，编码那些 LLM 不知道的隐式约定。

为什么需要这个技能

LLM 训练数据中包含 Spring Boot/MyBatis-Plus 的 API 知识，但不知道 DDD4J 项目中的架构约定。直接让 LLM 写代码会产生架构上正确但风格上错误的胶水代码。本技能编码这些规则。

Capability Boundaries

✅ Strong Suits

实体定义规则 — 必须 extends BaseEntity→Model<T>(ActiveRecord)，审计字段已内置
DDD 注解规则 — 区分 SOURCE 和 RUNTIME 注解，知道哪个注解已经是 Spring Bean
Controller 层级 — BaseController(success/fail/error)→BaseMapperController(Dozer注入)
Service 层级 — BaseServiceImpl 已注入 MessageSource/Cache/EventPublisher/Dozer
返回值格式 — ApiRestResponse 三态(success/fail/error)，分页返回 rows 不是 data
查询参数约定 — beginTime/endTime/keywords/params 在 Entity 上，不是独立 QueryDTO
国际化 — NestedMessageSource，异常消息用 key 不用硬编码

⚠️ Requirements

实体必须 extends BaseEntity（或 PaginationEntity），不能直接 extends Model
使用 @DomainService 代替 @Service，使用 @ApplicationService 代替应用层 @Service
分页查询使用 PaginationEntity，不要直接使用 MyBatis-Plus Page

❌ Out of Scope

JSON 序列化规则（null处理、日期格式、@Sensitive） → ddd4j-jackson
MyBatis-Plus 类型处理器、@Param("model")约定 → ddd4j-mybatis
自定义校验注解 → ddd4j-validation
Sa-Token 扩展用法（StpKit扩建载荷） → ddd4j-satoken

LLM 最常犯的10个错误

#	错误	正确做法
1	把 `@DomainEntity` 当成 Spring Bean	它是 SOURCE 保留，仅作文档，不是 @Component
2	在 `@DomainService` 上再加 `@Service`	`@DomainService` 已经元标注了 @Service，重复会导致问题
3	创建独立的 QueryDTO 放查询参数	beginTime/endTime/keywords/params 直接放在 Entity 上拓展字段
4	分页返回 `data` 字段	使用 `rows`（bootstrap-table 协议）
5	直接 `new Page<T>()` 做分页	使用 `PaginationEntity<T>` 封装，默认15条/页
6	MyBatis XML 中写 `#{entity.beginTime}`	应写 `#{model.beginTime}`（@Param("model")）
7	实体 implements Serializable	必须 `extends BaseEntity<T extends Model<?>>`（ActiveRecord）
8	响应返回 `{code:200,data:{}}`	使用 `BaseController.success/fail/error` 返回 ApiRestResponse
9	硬编码错误消息	使用 `getMessage("error.key")` NestedMessageSource
10	手动 setter/getter 做对象映射	BaseMapperController 已注入 Dozer，直接用

核心规则速查

// ✅ 正确：实体定义
@Data
@TableName("sys_user")
public class SysUser extends BaseEntity<SysUser> {
    // createBy/createTime/updateBy/updateTime 已继承，不用再声明
    // isDeleted 已继承(@TableLogic)，不用再声明
    // beginTime/endTime/keywords 已继承(@TableField(exist=false))，用于查询
    private String username;
    private String password;
}

// ✅ 正确：DDD 注解
@DomainEntity          // SOURCE 保留 → 仅文档标注
public class Order { }
@DomainService         // RUNTIME 保留 → 已经是 @Service，不要再加
public class OrderService { }
@ApplicationService    // RUNTIME 保留 → 已经是 @Service，用于应用层
public class OrderAppService { }

// ✅ 正确：Controller 返回值
@RestController
public class UserController extends BaseMapperController {
    @GetMapping("/list")
    public ApiRestResponse<Result<UserDTO>> list(PaginationEntity<User> entity) {
        List<User> list = getBaseService().getPagedList(new Page<>(entity.getPageNo(), entity.getLimit()), entity);
        return success(new Result<>(list)); // 返回 {code:200, status:"success", rows:[...]}
    }
}

// ✅ 正确：分页查询
PaginationEntity<User> entity = new PaginationEntity<>();
entity.setPageNo(1); entity.setLimit(15); entity.setBeginTime(LocalDateTime.now().minusDays(7));
List<User> list = baseService.getPagedList(new Page<>(1, 15), entity);
// XML: <select id="getPagedList"> WHERE create_time >= #{model.beginTime} </select>

Gotchas

@DomainEntity 不能替代 @Component/@Service — 它是 SOURCE 保留的文档注解
@DomainService 已经包含 @Service — 不要重复添加
BaseEntity 的 beginTime/endTime 是查询辅助字段 — 不会持久化(@TableField(exist=false))
PaginationEntity 的 getOffset() 是 Oracle 风格 — ((pageNo-1)*limit+1)，不是0开头
ApiRestResponse 有三态 — success(200)/fail(业务失败)/error(系统错误=500)
分页返回字段是 rows 不是 data — bootstrap-table 协议要求
插入时审计字段自动填充 — createBy/createTime 由 MyBatis-Plus FieldFill.INSERT 处理
更新时 updateBy/updateTime 自动填充 — 由 FieldFill.INSERT_UPDATE 处理
BaseMapperController 注入的是 Dozer — 做对象映射用 mapper.map(source, Target.class)
所有 Controller 应继承 BaseController 或 BaseMapperController — 获得 success/fail/error 方法

Data Privacy

本技能不收集、存储或传输任何用户数据。

FAQ

What does the ddd4j-core skill do?

How do I install ddd4j-core?

Run npx skills add https://github.com/full-stack-skills/ddd-skills --skill ddd4j-core in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ddd4j-core/ (personal) or .claude/skills/ddd4j-core/ (project).

Which AI agents can use ddd4j-core?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is ddd4j-core safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains ddd4j-core?

It is published by full-stack-skills in full-stack-skills/ddd-skills. It has 52 recorded installs.

More from full-stack-skills/ddd-skills

View all →

ddd-code-reviewer

full-stack-skills/ddd-skills

DDD code review and anti-pattern detection — anemia model detection, layered compliance checking, aggregate design review, rich model verification, scoring system (5 dimensions), and ArchUnit automated validation. Use when user asks about code review, 代码审查, DDD review, 架构审查, anti-pattern detection, 反模式检测, or needs to check if code follows DDD.

Code Quality & Workflow146 installs

ddd-api-designer

full-stack-skills/ddd-skills

API design from domain model — CQRS command/query separation, REST API endpoint design, data object conversion chain (PO→DO→DTO→VO), unified response format, OpenAPI/Swagger generation, BFF pattern, API versioning, and security design. Use when user asks about API design, REST API, OpenAPI, BFF, DTO design, 接口设计, or data object conversion.

Backend & APIs139 installs

ddd-domain-designer

full-stack-skills/ddd-skills

Open the skill to read its SKILL.md instructions.

Frontend & Design133 installs

ddd-devops-integration

full-stack-skills/ddd-skills

DDD DevOps integration — CI/CD pipeline with ArchUnit automated architecture validation, multi-module build optimization for DDD projects, containerized deployment with Docker/K8s for layered/hexagonal/clean architectures, database migration strategies for domain events, and monitoring domain health. Use when user asks about DevOps, CI/CD, DDD deployment, ArchUnit CI, or needs to automate DDD project builds.

DevOps & Cloud131 installs

ddd-architecture-hexagonal

full-stack-skills/ddd-skills

Comprehensive guidance for Hexagonal Architecture (Ports & Adapters) — Alistair Cockburn's hexagonal architecture with domain core, port definitions, adapter implementations, and full Java/Spring Boot implementation steps. Covers primary/driving adapters, secondary/driven adapters, use case ports, repository ports, and dependency injection configuration. Use when user asks about hexagonal architecture, 六边形架构, ports and adapters, 端口适配器, Alistair Cockburn, or needs DDD with clean separation.

Code Quality & Workflow131 installs

ddd-event-storming

full-stack-skills/ddd-skills

Open the skill to read its SKILL.md instructions.

127 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs

ddd4j-core

Install

Install

Describe the task

Review the result

SKILL.md

DDD4J Boot 核心开发约定

为什么需要这个技能

Capability Boundaries

✅ Strong Suits

⚠️ Requirements

❌ Out of Scope

LLM 最常犯的10个错误

核心规则速查

Gotchas

Data Privacy

FAQ

More from full-stack-skills/ddd-skills

Popular other skills