Create Cqrs Bulk Commands
Developmentcreate-cqrs-bulk-commandsCreate Cqrs Bulk Commands is an Agent Skill for development published in the PrestaShop/PrestaShop repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Create bulk action commands and their handlers. All bulk handlers extend AbstractBulkCommandHandler, catch errors per item, and report failures via BulkCommandExceptionInterface. Trigger: "create bulk commands for {Domain}".
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/PrestaShop/PrestaShop/blob/HEAD/.ai/Component/CQRS/skills/create-cqrs-bulk-commands/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/create-cqrs-bulk-commands, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
create-cqrs-bulk-commands
See CQRS/CONTEXT.md for the bulk handler pattern (AbstractBulkCommandHandler, BulkCommandExceptionInterface, continue after failure).
1. Bulk delete command
Create src/Core/Domain/{Domain}/Command/BulkDelete{Domain}sCommand.php:
- Constructor takes
array $ids(scalarint[]) - Single getter:
getIds(): array
2. Bulk status command
Create src/Core/Domain/{Domain}/Command/BulkToggle{Domain}StatusCommand.php:
- Constructor takes
array $ids(int[]) andbool $expectedStatus $expectedStatus = truemeans enable,falsemeans disable- Getters:
getIds(): arrayandgetExpectedStatus(): bool
3. Bulk handlers
All bulk handlers follow the same structure. Create in src/Adapter/{Domain}/CommandHandler/:
Bulk delete handler
BulkDelete{Domain}sHandler.php:
- For each ID, call the repository delete
- Collect failures, continue with remaining IDs
Bulk status handler
BulkToggle{Domain}StatusHandler.php:
- For each ID, load entity, set
active = $command->getExpectedStatus(), update - Use the target status from the command — do not flip the current value
4. Handler interfaces
Create in src/Core/Domain/{Domain}/CommandHandler/:
BulkDelete{Domain}sHandlerInterfaceBulkToggle{Domain}StatusHandlerInterface
Both return void. The bulk exception is thrown, not returned.
Rules
Conventions (AbstractBulkCommandHandler, continue after failure, BulkCommandExceptionInterface) are in CQRS/CONTEXT.md. Skill-specific reminders:
- Be consistent with the single-entity commands on ID typing
- Skip this skill entirely if the entity has no bulk grid actions