AgentSkillsCN

bevy-brp-instrumentation

在 Bevy 项目中添加并验证 BRP 钩子，使 BRP 消费者（尤其是 bevy-eyes-on）能够驱动确定性的状态转换，并捕获可靠截图。适用于需要实现可复现的相机/玩家姿态、基于帧的稳定化、状态探针、确定性截图，或为 Bevy 应用明确报告功能特性的场景。

SKILL.md
--- frontmatter
name: bevy-brp-instrumentation
description: Add and validate BRP hooks in Bevy projects so BRP consumers (especially bevy-eyes-on) can drive deterministic state transitions and capture reliable screenshots. Use when a task requires reproducible camera/player pose, frame-based stabilization, state probes, deterministic screenshots, or explicit capability reporting for Bevy apps.

Bevy BRP Instrumentation

Overview

Instrument an existing Bevy app so deterministic BRP control and state-probe paths are available and testable.

Keep edits minimal, additive, and feature-gated so normal app behavior stays unchanged.

Workflow

  1. •Enable Bevy remote support in the app.
  2. •Add deterministic BRP methods for the required contract.
  3. •Wire methods to existing game state systems with stable semantics.
  4. •Validate capability discovery and deterministic flows through BRP scenario runs (for example with bevy-eyes-on).

For the exact method list and behavior, read references/capability-contract.md.

For a practical implementation sequence, read references/implementation-workflow.md.

Guardrails

  • •Preserve existing controls and gameplay loops unless the task explicitly allows behavior changes.
  • •Return deterministic unavailability explicitly when a required capability is not implemented.
  • •Keep BRP exposure local-first for development (localhost endpoints).
  • •Add small integration checks for capability discovery and deterministic calls.

Validation

After instrumentation, verify deterministic paths with BRP scenario execution:

  • •At least one action call mutates state as expected.
  • •At least one probe call returns machine-readable state for gating (until).
  • •Frame-based wait/progression behaves deterministically when implemented.
  • •Screenshot capture succeeds after a state gate condition is met.

Use references/validation-checklist.md for a step-by-step validation pass.