create-repository
为领域实体持久性创建存储库接口和查找器接口。当实体需要包含命令(保存、删除)和查询(查找、查找全部)的持久层时使用。按照CQRS模式生成存储库(命令)和查找器(查询)。
📖 中文导读:为领域实体持久性创建存储库接口和查找器接口。当实体需要包含命令(保存、删除)和查询(查找、查找全部)的持久层时使用。按照CQRS模式生成存储库(命令)和查找器(查询)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: create-repository description: Create Repository interface and Finder interface for domain entity persistence. Use when entity needs persistence layer with commands (save, delete) and queries (find, findAll). Generates both Repository (commands) and Finder (queries) following CQRS pattern.
Create Repository
Generate Repository (commands) and Finder (queries) interfaces.
When to Use
- Entity needs persistence
- Implementing CQRS pattern
- Creating persistence layer ports
Inputs/Outputs
| Input | Example | Output |
|---|---|---|
| bc | Admin | BC/Entities/Repository/EntityRepository.php |
| entity | Article | BC/UseCases/Gateway/Finder/EntityFinder.php |
| entityPlural | Articles | Used in findAll{EntityPlural}() method |
| commands | ['save', 'delete'] | - |
| queries | ['find', 'findAll'] | - |
Note:
entityPluralhandles irregular plurals (Category→Categories, Entity→Entities).
Process
| Step | Action |
|---|---|
| Repository | Create interface in BC/Entities/Repository/ (template: repository.php.tpl) |
| Finder | Create interface in BC/UseCases/Gateway/Finder/ (template: finder.php.tpl) |
| Validate | make cs-fixer && make stan |
Structures
Repository (commands - throws exceptions):
interface EntityRepository {
public function getByUuid(ResourceUuid $uuid): Entity; // throws EntityNotFound
public function save(Entity $entity): void;
public function delete(Entity $entity): void;
}
Finder (queries - returns null/array):
interface EntityFinder {
public function find(ResourceUuid|string $uuid): ?Entity;
public function findAll(): array; // @return Entity[]
public function findByName(string $name): ?Entity;
}
See: docs/GLOSSARY.md#repository-vs-finder for detailed comparison
Rules
Repository (commands):
- Location:
BC/Entities/Repository/ - Methods:
get*()MUST throw exception if not found - Common:
getByUuid(),save(),delete() - Used in: Use cases that MODIFY state (Create, Update, Delete)
Finder (queries):
- Location:
BC/UseCases/Gateway/Finder/ - Methods:
find*()MAY return null or empty array - Common:
find(),findAll(),findBy*() - Used in: Use cases that READ state (List, Search, Find)
CRITICAL: Repository for writes (throws), Finder for reads (returns null/array)
Templates
repository.php.tpl- Repository interfacefinder.php.tpl- Finder interface
Location: .claude/templates/
References
- Repository vs Finder:
docs/GLOSSARY.md#repository-vs-finder - Repository pattern:
docs/QUICK_REF.md#repository-pattern - Finder pattern:
docs/QUICK_REF.md#finder-pattern
Related Skills
create-entity- Create entity firstcreate-use-case- Use repository/finder in use case