$ ~/registry/skill/facebook-packages-starter-assets-claude-injections-skills-iwsdk-debug

SKILL

iwsdk-debug

Debug continuous behavior in WebXR scenes — physics, animations, collisions, game loops, or any real-time interaction that happens too fast for an agent to observe. Uses ECS pause/step/snapshot/diff to freeze time and inspect state frame by frame.

来源

GitHub

更新于

2026-06-06

// 安全评估低风险

仅提示词，不执行代码
开源可审计

正在进行安全审计…

凭证密钥
网络外发
代码执行
数据访问
来源供应链

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "iwsdk-debug" 技能：
1. 下载 https://raw.githubusercontent.com/facebook/immersive-web-sdk/main/packages/starter-assets/claude-injections/skills/iwsdk-debug/SKILL.md
2. 保存为 ~/.claude/skills/iwsdk-debug/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 文档

Debug Continuous Behavior

Real-time behavior (physics, animations, collisions, game loops) happens too fast for an agent to observe directly. By the time you take a screenshot, the action is over. This skill uses ECS time-control tools to freeze, step, and diff state frame by frame.

User request is in $ARGUMENTS.

Core Workflow

Every debugging session follows this pattern:

Set up the scenario (position objects, aim controllers, etc.)
ecs_pause — freeze ECS updates right before the interesting moment
ecs_snapshot({ "label": "before" }) — capture state before the action
Trigger the action (release grip, apply force, start animation, etc.)
ecs_step(count, delta) — advance a few frames at fixed timestep
browser_screenshot — visually verify what happened
ecs_snapshot({ "label": "after" }) — capture state after stepping
ecs_diff({ "from": "before", "to": "after" }) — see exactly what changed
Repeat steps 5-8, stepping further until the behavior completes
ecs_resume — return to normal execution when done

The key insight: pause BEFORE triggering the action, not after. If you pause after, you've already missed the first frames.

Tool Reference

Tool	Purpose
`ecs_pause`	Freeze all ECS system updates. Render loop continues — screenshots still work.
`ecs_step({"count":N,"delta":SECONDS})`	Advance N frames with fixed timestep (seconds). Must pause first.
`ecs_resume`	Resume normal execution. First frame uses capped delta to avoid physics explosions.
`ecs_snapshot({"label":"..."})`	Capture full ECS state. Stores up to 2 snapshots.
`ecs_diff({"from":"...","to":"..."})`	Compare two snapshots. Shows added/removed entities and field-level value changes.
`ecs_toggle_system({"name":"...","paused":true})`	Pause/resume a single system. Use `ecs_list_systems` to discover names.
`browser_screenshot`	Visual verification — works while paused since the render loop continues.

Stepping Guidelines

delta is in seconds. Common values: 0.016 (60fps), 0.0139 (72fps/Quest refresh rate).
Start small — step 1-3 frames first to catch the initial moment, then step more.
Don't overshoot — stepping 100 frames at once defeats the purpose. Step in batches of 5-20.

Patterns

Short domain-specific tips. Apply the core workflow above, plus these hints.

Physics (falling, bouncing, collisions)

Pause BEFORE releasing the object or applying force.
Step 1-3 frames at delta: 0.016 to catch initial acceleration.
In diffs, check PhysicsBody._linearVelocity and PhysicsBody._angularVelocity to see motion direction and speed.
Check Transform.position to track movement.
If an object falls through a surface: verify the surface entity has both PhysicsBody (Static) and PhysicsShape (TriMesh for complex geometry).
Use ecs_query_entity to inspect PhysicsShape and PhysicsBody on both the falling object and the surface.

Grab and Throw

Pause while the object is still held (trigger/grip engaged).
Release the input (set button value to 0) while paused.
Step frame by frame to observe the release velocity.
In diffs, PhysicsBody._linearVelocity shows the throw direction and speed.
If the object doesn't move after release: check that it has PhysicsBody with state: Dynamic.

Animations and Transitions

Step 1 frame at a time with delta matching your target framerate.

…

查看完整文档 ↗

// 同源资产

技能

test-grab

Test grab system (distance grab, one-hand grab, two-hand grab) against the grab example using the iwsdk CLI.

facebook装→

技能

test-interactions

Test XR interactions (ray, poke/touch, dual-mode, audio, UI panel) against the poke example using the iwsdk CLI.

facebook装→

技能

click-target

Find and click a target object in XR. Use when testing UI interactions, clicking buttons, or verifying interactable elements work correctly.

facebook装→

技能

iwsdk-planner

IWSDK project planning and best practices guide. Use when planning new IWSDK features, designing systems/components, reviewing IWSDK code architecture, or when the user asks about IWSDK patterns, ECS design, signals, or reactive programming in this codebase.

facebook装→

技能

iwsdk-ui-panel

Develop and iterate on IWSDK UI panels efficiently. Use when working on PanelUI components, debugging UI layout, or improving UI design in IWSDK applications.

facebook装→

技能

test-level

Test level system (LevelRoot, LevelTag, default lighting, scene hierarchy) against the poke example using the iwsdk CLI.

facebook装→

$ loading_

请帮我安装 askskill 上的 "iwsdk-debug" 技能： 1. 下载 https://raw.githubusercontent.com/facebook/immersive-web-sdk/main/packages/starter-assets/claude-injections/skills/iwsdk-debug/SKILL.md 2. 保存为 ~/.claude/skills/iwsdk-debug/SKILL.md 3. 装好后重载技能，告诉我可以用了

// 文档

Debug Continuous Behavior

User request is in $ARGUMENTS.

Core Workflow

Every debugging session follows this pattern:

Set up the scenario (position objects, aim controllers, etc.)
ecs_pause — freeze ECS updates right before the interesting moment
ecs_snapshot({ "label": "before" }) — capture state before the action
Trigger the action (release grip, apply force, start animation, etc.)
ecs_step(count, delta) — advance a few frames at fixed timestep
browser_screenshot — visually verify what happened
ecs_snapshot({ "label": "after" }) — capture state after stepping
ecs_diff({ "from": "before", "to": "after" }) — see exactly what changed
Repeat steps 5-8, stepping further until the behavior completes
ecs_resume — return to normal execution when done

The key insight: pause BEFORE triggering the action, not after. If you pause after, you've already missed the first frames.

Tool Reference

Tool	Purpose
`ecs_pause`	Freeze all ECS system updates. Render loop continues — screenshots still work.
`ecs_step({"count":N,"delta":SECONDS})`	Advance N frames with fixed timestep (seconds). Must pause first.
`ecs_resume`	Resume normal execution. First frame uses capped delta to avoid physics explosions.
`ecs_snapshot({"label":"..."})`	Capture full ECS state. Stores up to 2 snapshots.
`ecs_diff({"from":"...","to":"..."})`	Compare two snapshots. Shows added/removed entities and field-level value changes.
`ecs_toggle_system({"name":"...","paused":true})`	Pause/resume a single system. Use `ecs_list_systems` to discover names.
`browser_screenshot`	Visual verification — works while paused since the render loop continues.

Stepping Guidelines

delta is in seconds. Common values: 0.016 (60fps), 0.0139 (72fps/Quest refresh rate).
Start small — step 1-3 frames first to catch the initial moment, then step more.
Don't overshoot — stepping 100 frames at once defeats the purpose. Step in batches of 5-20.

Patterns

Short domain-specific tips. Apply the core workflow above, plus these hints.

Physics (falling, bouncing, collisions)

Pause BEFORE releasing the object or applying force.
Step 1-3 frames at delta: 0.016 to catch initial acceleration.
In diffs, check PhysicsBody._linearVelocity and PhysicsBody._angularVelocity to see motion direction and speed.
Check Transform.position to track movement.
If an object falls through a surface: verify the surface entity has both PhysicsBody (Static) and PhysicsShape (TriMesh for complex geometry).
Use ecs_query_entity to inspect PhysicsShape and PhysicsBody on both the falling object and the surface.

Grab and Throw

Pause while the object is still held (trigger/grip engaged).
Release the input (set button value to 0) while paused.
Step frame by frame to observe the release velocity.
In diffs, PhysicsBody._linearVelocity shows the throw direction and speed.
If the object doesn't move after release: check that it has PhysicsBody with state: Dynamic.

Animations and Transitions

Step 1 frame at a time with delta matching your target framerate.

…

查看完整文档 ↗