Agent Skillsjasonkneen/tiny-world-builder › tinyworld-visual-qa

tinyworld-visual-qa

GitHub

用于 Tiny World Builder UI 的视觉测试,涵盖相机、透明度、建筑及前端细节,确保渲染正确与交互流畅。

.codex/skills/tinyworld-visual-qa/SKILL.md jasonkneen/tiny-world-builder

Trigger Scenarios

需要验证前端 UI 视觉效果时 检查浏览器中相机、透明度或建筑渲染问题时

Install

npx skills add jasonkneen/tiny-world-builder --skill tinyworld-visual-qa -g -y
More Options

Non-standard path

npx skills add https://github.com/jasonkneen/tiny-world-builder/tree/main/.codex/skills/tinyworld-visual-qa -g -y

Use without installing

npx skills use jasonkneen/tiny-world-builder@tinyworld-visual-qa

指定 Agent (Claude Code)

npx skills add jasonkneen/tiny-world-builder --skill tinyworld-visual-qa -a claude-code -g -y

安装 repo 全部 skill

npx skills add jasonkneen/tiny-world-builder --all -g -y

预览 repo 内 skill

npx skills add jasonkneen/tiny-world-builder --list

SKILL.md

Frontmatter
{
    "name": "tinyworld-visual-qa",
    "description": "Use when visually testing Tiny World Builder UI, camera, ghost opacity, buildings, tile geometry, or frontend polish in the browser."
}

Tiny World Visual QA

Use the browser route http://localhost:3000/tiny-world-builder when available. For Worlds screen/API QA, run the local build first and launch through Netlify on 8888:

./publish.sh
npx --yes netlify dev --dir dist --functions netlify/functions --port 8888 --staticServerPort 3998

Worlds cards should use real /api/worlds preview data. Do not invent seeded or hardcoded island layouts in the client; the 2D isometric renderer may draw the default grass base for the world grid, then overlay only API-provided terrain / object tuples.

Checks:

  • Console has no app errors.
  • Toolbar shortcuts still work: 0, 1-9, letter tools, E.
  • Left-click places only on the editable home board.
  • Right-drag and Space+drag pan smoothly.
  • Dragging/clicking the minimap canvas pans the camera target while dragging the minimap chrome/footer still moves the widget.
  • Minimap colours should track live scene materials plus time/weather theme tint, not a stale fixed palette.
  • Tinyverse world-map orientation must match the synced island view and card previews. The room minimap uses direct grid coordinates (x * CELL, z * CELL) for drawing and the same direct inverse for clicks; do not rotate or mirror it to chase a camera angle.
  • Tinyverse world picker is a carousel overlay, not an in-world board or a flat admin grid. It must use real /api/worlds preview data, keep legacy multi-gate data collapsed to the single center world-selection stargate, and keep search/filter/arrow/dot navigation reachable on desktop and mobile.
  • New-world reveal QA: the collectible island card and the step-through guide should read as separate surfaces; Common rarity should be silent; Uncommon+ uses a restrained rarity border treatment; resource highlights should render as small labeled stat pins, not large unexplained rings over whole tiles.
  • Multiplayer avatar name tags should stay a fixed on-screen size while zooming in perspective or orthographic camera modes.
  • Orbit still works with normal left-drag.
  • Ghost boards do not become editable.
  • The opacity torch is smooth and does not reveal square board seams.
  • Tilt-shift overlays have pointer-events: none, stay below UI controls, and remain visible during pan/orbit/zoom movement.
  • Cloud shadow at 0% / low values should reduce ground shadow strength without hiding visible cloud puffs.
  • At night/dusk, the star vault should appear behind the world without covering objects or UI, cloud rim lighting should warm cloud edges, and accent lights should brighten nearby foreground objects without adding shadow-map cost.
  • The brand WAVE countdown should sit in the brand stack below the wordmark, never fixed over the logo, and body.ui-theme-dark should give it the same dark pill surface/text treatment as the rest of the top chrome.
  • Lamp/spotlight stamps should show a blurred warm haze plus a ground spill at night. The spotlight spill must be narrow at the fixture and wider/fainter in front of it; window spill decals should not render through buildings or lose their additive material during fade/reveal.
  • Blast shield QA: open ?shield=1, confirm window.VoxelShield exposes the supplied class/API names, has 4 keystones and 32 panels, blue rune faces point outward, open() / close() / toggle() / setProgress() work, and the bottom toolbar Home and Shield buttons sit side by side with Shield reflecting raised/lowered state.
  • Garden Fence should be selectable from the Infra group, render with dark posts/vine/fruit accents, persist through export/import, and batch contiguous same-style runs as one span anchor.
  • Building details should be believable: manor portico columns stay entry-scale, windows have frames/crossbars, and tall buildings do not stretch entry features unrealistically.
  • Toolbar flyouts should sit clear of the toolbar (about 10px), avoid vertical clipping, and reduce empty thumbnail air via camera/frustum framing rather than negative CSS margins inside scrollable flyout containers.
  • The Stamps panel should open as a compact floating canvas panel, stay open while placing items, drag by its header, avoid AI/create/enhance controls, and keep darker thumbnail previews readable.
  • Dialog titles should use the shared Fraunces .modal-head strong treatment, with explanatory body copy in .modal-copy / .confirm-copy and readable darker muted text.
  • Selection preview in the floating agent panel should show useful property chips for the primary selected kind. Supported properties (e.g. tower Top/Body colour, building Shape, Size) should apply immediately through setCell; unsupported creative edits can fall back to prompts.
  • Selection preview must render the same object/stamp factory as the world view. Voxel-build/custom objects should not fall back to a generic blue cube.
  • Selection preview markup and wiring must stay connected: selection-preview-canvas, selection-preview-actions, and the Preview/Details tabs should exist in the panel, and renderSelection() should call updateSelectionPreview() as the selected target changes.
  • Selection colour controls should offer a broad palette for supported object parts, not just 3-4 legacy swatches.
  • Planet-underlay visual proof should use deterministic proof URLs such as http://localhost:3000/tiny-world-builder?planet=desert&planetStyle=lowpoly&planetDrop=60&seed=skytest&planetProof=1 and http://localhost:3000/tiny-world-builder?planet=desert&planetStyle=realistic&planetDrop=60&seed=skytest&planetProof=1: they hide non-canvas chrome, dismiss the welcome modal, widen the perspective camera, apply the underlay horizon haze and between-layer atmosphere sheets, and leave a small proof badge. Prefer this over judging one-shot screenshots where normal UI panels or default camera framing obscure the underlay.

Useful browser probes:

pickTile(window.innerWidth / 2, window.innerHeight / 2)
getComputedStyle(document.body, '::before').pointerEvents
getComputedStyle(document.body, '::after').pointerEvents

Version History

  • 2ffaf91 Current 2026-07-06 00:20

Same Skill Collection

.agents/skills/lightweight-3d-effects/SKILL.md
.agents/skills/threejs-primitive-reconstructor/SKILL.md
.agents/skills/tinyworld-i18n/SKILL.md
.claude/skills/tinyworld-i18n/SKILL.md
.codex/skills/threejs-primitive-reconstructor/SKILL.md
.codex/skills/tinyworld-25d-template-sprites/SKILL.md
.codex/skills/tinyworld-asset-editing/SKILL.md
.codex/skills/tinyworld-auto-batching/SKILL.md
.codex/skills/tinyworld-block-button-style/SKILL.md
.codex/skills/tinyworld-cctv-truman/SKILL.md
.codex/skills/tinyworld-ghost-world-gen/SKILL.md
.codex/skills/tinyworld-integrations/SKILL.md
.codex/skills/tinyworld-island-and-planes/SKILL.md
.codex/skills/tinyworld-island-viewer/SKILL.md
.codex/skills/tinyworld-lowpoly-stylized-3d/SKILL.md
.codex/skills/tinyworld-lowpoly-world-prompt/SKILL.md
.codex/skills/tinyworld-mesh-terrain/SKILL.md
.codex/skills/tinyworld-opacity-torch/SKILL.md
.codex/skills/tinyworld-render-performance/SKILL.md
.codex/skills/tinyworld-runtime-state/SKILL.md
.codex/skills/tinyworld-settings/SKILL.md
.codex/skills/tinyworld-shader-fx/SKILL.md
.codex/skills/tinyworld-single-file/SKILL.md
.codex/skills/tinyworld-tile-variation/SKILL.md
.codex/skills/tinyworld-tinyverse-collectibles/SKILL.md
.codex/skills/tinyworld-tinyverse-race-track/SKILL.md
.codex/skills/tinyworld-tool-icons-and-modes/SKILL.md
.codex/skills/tinyworld-webxr/SKILL.md
.agents/skills/3d-modeling/SKILL.md
.agents/skills/fractal/SKILL.md
.agents/skills/poly-pizza-api/SKILL.md

Metadata

Files
0
Version
8afdf00
Hash
5b30dd95
Indexed
2026-07-06 00:20

trang chủ - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-05 02:37
浙ICP备14020137号-1 $bản đồ khách truy cập$