acc-create-facade

📁 dykyi-roman/awesome-claude-code 📅 2 days ago

总安装量

周安装量

#52459

全站排名

安装命令

npx skills add https://github.com/dykyi-roman/awesome-claude-code --skill acc-create-facade

Agent 安装分布

opencode 1

claude-code 1

Skill 文档

Facade Pattern Generator

Creates Facade pattern infrastructure for providing simplified access to complex subsystems.

When to Use

Scenario	Example
Complex subsystem simplification	Order facade combining inventory, payment, shipping
Multiple service orchestration	Notification facade coordinating email, SMS, push
Legacy system wrapping	Facade hiding complex legacy APIs
Layered system access	Application layer facade for domain services

Component Characteristics

Facade

Simple unified interface
Delegates to subsystem classes
No business logic, only orchestration
Lives in Application layer

Subsystem Classes

Independent complex operations
Can be used directly or through facade
Domain or Infrastructure services

Generation Process

Step 1: Generate Facade

Path: src/Application/{BoundedContext}/Facade/

{Name}Facade.php â Unified interface to subsystem

Step 2: Identify Subsystem Classes (Existing)

Paths: Domain or Infrastructure services

Services, Repositories, External APIs
Multiple components with related functionality

Step 3: Generate Tests

{FacadeName}Test.php â Facade orchestration verification

File Placement

Component	Path
Facade	`src/Application/{BoundedContext}/Facade/`
Subsystem Classes	`src/Domain/` or `src/Infrastructure/`
Unit Tests	`tests/Unit/Application/{BoundedContext}/Facade/`

Naming Conventions

Component	Pattern	Example
Facade	`{Name}Facade`	`OrderFacade`
Test	`{ClassName}Test`	`OrderFacadeTest`

Quick Template Reference

Facade

final readonly class {Name}Facade
{
    public function __construct(
        private {SubsystemA} $subsystemA,
        private {SubsystemB} $subsystemB,
        private {SubsystemC} $subsystemC
    ) {}

    public function {complexOperation}({params}): {returnType}
    {
        $stepA = $this->subsystemA->{methodA}({params});
        $stepB = $this->subsystemB->{methodB}($stepA);
        $stepC = $this->subsystemC->{methodC}($stepB);

        return $stepC;
    }
}

Usage Example

// Without facade - complex coordination
$inventory = $inventoryService->reserve($productId, $quantity);
$payment = $paymentService->charge($amount, $token);
$shipment = $shippingService->schedule($address, $inventory);
$order = $orderRepository->save(new Order(...));
$notificationService->sendConfirmation($order);

// With facade - simple call
$order = $orderFacade->placeOrder($command);

Common Facades

Facade	Purpose
OrderFacade	Coordinate inventory, payment, shipping, notifications
NotificationFacade	Send via email, SMS, push, Slack
ReportFacade	Generate PDF, Excel, CSV reports
UserRegistrationFacade	Validate, create account, send welcome email
PaymentFacade	Authorize, charge, record, notify
ExportFacade	Fetch data, transform, format, save file

Anti-patterns to Avoid

Anti-pattern	Problem	Solution
God Facade	Facade does too much	Split into focused facades
Business Logic in Facade	Facade makes decisions	Move logic to domain services
Tight Coupling	Facade depends on concrete classes	Inject interfaces
No Subsystem Access	Clients can’t bypass facade	Allow direct subsystem use
Stateful Facade	Facade holds state between calls	Keep facades stateless

References

For complete PHP templates and examples, see:

references/templates.md â Facade templates for order, notification, report systems
references/examples.md â OrderFacade, NotificationFacade, ReportFacade with unit tests

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台