菜单
Use when adding or renaming a real-time broadcast event — walks the full PHP→Echo→scene chain so all three names stay aligned and the shape test exists.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | scaffold-broadcast-event |
| description | Use when adding or renaming a real-time broadcast event — walks the full PHP→Echo→scene chain so all three names stay aligned and the shape test exists. |
A broadcast event spans four files. Missing any one fails silently in production. Work through ALL steps in order.
app/Events/<Name>.php:
ShouldBroadcastNow for latency-sensitive gameplay events (hits, charging, joins); queued ShouldBroadcast only with a stated reason.broadcastOn(): array → [new Channel('battlefield')]broadcastAs(): string → PascalCase name, e.g. 'FighterStunned'broadcastWith(): array → snake_case scalars only, never models. Resolve user display fields the way sibling events do.resources/js/battlefield/index.js: add the ECHO_EVENT_MAP entry mapping the broadcastAs name to a kebab-case bus key (FighterStunned → fighter-stunned).resources/js/battlefield/scene.js: register the bus key in _busHandlers; the handler must be released on shutdown like its siblings.tests/Feature/Events/BroadcastShapeTest.php locking channel, broadcastAs, and broadcastWith keys. Write it FIRST (tdd skill).rescue() if fired from the ingestion path.broadcastAs() string === ECHO_EVENT_MAP key (Echo subscribes with a leading .)scene.js and torn down on shutdownbroadcastWith()rescue() around dispatch on the hook pathspin exec php php artisan test --compact --filter=BroadcastShape + npm run buildThen request review from the broadcast-reviewer agent.
Use when committing changes in this repo — enforces the Angular commit convention with project scopes, staging discipline, and the files that must never be committed.
Use for EVERY behavior change in this repo — enforced red/green workflow with the project's source→test path mapping. Write the failing test first, watch it fail, then implement.
Use when running or scoping tests in this repo — correct commands, how to scope runs, environment gotchas, and how to read failures.
Use when working in resources/js/battlefield/ — the Phaser 3 real-time battlefield game (scene, snapshot, leaderboard, projectile, attacks, layout, bus) or wiring a Laravel broadcast event to it. Covers the Echo→bus→scene data flow, the event-name/payload contract, snapshot round-trip, and Phaser teardown rules.
Develops real-time broadcasting with Laravel Echo. Activates when setting up broadcasting (Reverb, Pusher, Ably); creating ShouldBroadcast events; defining broadcast channels (public, private, presence, encrypted); authorizing channels; configuring Echo; listening for events; implementing client events (whisper); setting up model broadcasting; broadcasting notifications; or when the user mentions broadcasting, Echo, WebSockets, real-time events, Reverb, or presence channels.
Use for any task or question involving Livewire. Activate if user mentions Livewire, wire: directives, or Livewire-specific concepts like wire:model, wire:click, wire:sort, or islands, invoke this skill. Covers building new components, debugging reactivity issues, real-time form validation, drag-and-drop, loading states, migrating from Livewire 3 to 4, converting component formats (SFC/MFC/class-based), and performance optimization. Do not use for non-Livewire reactive UI (React, Vue, Alpine-only, Inertia.js) or standard Laravel forms without Livewire.