К основному содержанию
скилл CX Codex

dart-test — скилл для Claude Code: тесты, CI и отладка

Скилл dart-test для Claude Code и Codex: написание и отладка тестов Dart. Содержит команды для unit-тестов, интеграционных тестов, проверки CI и визуальной верификации симуляций.

BSD-2-Clause 1 установок ★ 1 232 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dartsim/dart --skill dart-test -a claude-code
Открыть на GitHub

Что делает dart-test

Включает быстрые команды для запуска тестов через Pixi: pixi run test для быстрой проверки, pixi run test-all для полной сборки и C++/Python тестов, pixi run test-gui для GUI-тестов. Тесты организованы по типам — unit в tests/unit/, интеграционные в tests/integration/, регрессионные в tests/regression/.

Для написания используется GoogleTest. Перед отправкой PR нужно запустить pixi run lint, pixi run test-all и при изменениях совместимости с Gazebo — pixi run -e gazebo test-gz. Отладка начинается с pixi run test для изоляции ошибки, затем смотрят логи CI через gh run view.

Главная хитрость: pixi run build собирает только библиотеки, не бинарники тестов. Нужно либо pixi run build-tests, либо сначала собрать конкретный target. GUI-тесты, требующие видеокарты, пропускаются в test-all, но включаются в test-gui. Для изменений сцены, динамики или отрисовки Filament загружайте вместе со скиллом dart-verify-sim.

Какие задачи решает

  • запустить unit-тесты проекта DART через Pixi
  • проверить интеграционные тесты перед отправкой PR
  • отладить отказавший тест через логи CI
  • протестировать изменения GUI и визуальный вывод
  • убедиться в совместимости с Gazebo при изменении коллизий

Примеры запросов агенту

  • Запусти быструю проверку с pixi run test
  • Выполни полный набор тестов и линтера перед PR: pixi run lint и pixi run test-all
  • Проверь GUI-тесты командой pixi run test-gui

Как установить dart-test

1Через Skills CLI (Vercel)

npx skills add dartsim/dart --skill dart-test -a claude-code

2Вручную: положить файлы

~/.claude/skills/dart-test/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/dart-test/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о dart-test

Как установить dart-test в Claude Code?

Выполни npx skills add dartsim/dart --skill dart-test -a claude-code, затем открой ~/.claude/skills/dart-test/SKILL.md.

Что делает dart-test?

Предоставляет команды Pixi для запуска unit-тестов, интеграционных тестов, проверки CI-валидации и визуальной отладки симуляций DART. Включает конфигурацию для GoogleTest и пути к тестовым директориям.

Зачем нужно загружать dart-verify-sim вместе с dart-test?

Когда изменения касаются структуры сцены, динамики, коллизий, отрисовки Filament или визуального примера, dart-verify-sim добавляет текстовый оракул и инструменты для захвата с DebugOverlay.

Исходный текст

SKILL.md · BSD-2-Clause
---
name: dart-test
description: "DART Test: unit tests, integration tests, CI validation, and debugging"
---

# DART Testing

Load this skill when writing or debugging tests.

## Quick Commands

```bash
pixi run test         # Quick test run
pixi run test-py      # Python tests
pixi run test-all     # Build defaults and run C++/Python tests
pixi run test-gui     # GUI tests except native-window tests; needs a graphics device
pixi run -e gazebo test-gz # Gazebo/gz-physics compatibility gate
```

## Full Documentation

For complete testing guide: `docs/onboarding/testing.md`

For CI/CD troubleshooting: `docs/onboarding/ci-cd.md`

## Test Organization

- Unit tests: `tests/unit/`
- Integration tests: `tests/integration/`
- Regression tests: `tests/regression/` (start from `test_Issue000Template.cpp`)

## Writing Tests

1. Follow existing patterns in the test directory
2. Use GoogleTest framework
3. Name tests descriptively, in the style of the neighboring tests in that file

## CI Validation

Before submitting PR:

```bash
pixi run lint         # Must pass
pixi run test-all     # Default build plus C++/Python runtime aggregate
pixi run -e gazebo test-gz # Must pass when Gazebo/gz-physics compatibility could be affected
```

## Debugging Test Failures

```bash
# Run the smallest existing Pixi test task that covers the failure
pixi run test

# Get CI logs
gh run view <RUN_ID> --log-failed
```

## Simulation And Visual End-to-End Checks

When a failure or change depends on scene structure, dynamics,
collision/contact, simulation stepping, Filament output, or a visual example, also
load `dart-verify-sim`. Use its text-first oracle and then an assessed,
claim-tied capture through `DebugOverlay`. Record a concrete no-visual reason
only when capture is unavailable or not applicable.

## Gotchas

- `pixi run build` builds libraries only, NOT every test binary. If you run
  `ctest` directly, build the relevant test target first; `pixi run build-tests`
  builds the branch test targets.
- `pixi run test-all` builds the default CMake `ALL` graph. The branch config
  pins `BUILD_TESTING=ON`, so that graph also runs CTest and pytest. Pair it
  with `pixi run lint`; use `pixi run test` or `pixi run test-py` for focused
  reruns and clearer failure attribution.
- `pixi run test`, `test-py`, and `test-all` build the GUI but skip tests that
  need a graphics device (CTest label `gui-device` and the Python GUI rendering
  tests). Device-free GUI tests remain in the default gates; the `gui` label
  covers all GUI tests.
  GUI, Filament, and `dartpy.gui` changes also need `pixi run test-gui`, which
  selects `-L gui -LE filament-native` in the same `build/<env>/cpp/Release`
  tree. Native-window tests need a desktop session or Xvfb:
  `ctest --test-dir build/<env>/cpp/Release -L filament-native`
  (`ctest --test-dir build/<env>/cpp -C Release -L filament-native` on
  Windows).
- For package, collision, constraint, or dependency changes that could affect
  downstream users, run `pixi run -e gazebo test-gz`.

© dartsim · BSD-2-Clause · dartsim/dart

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
dart-add-unit-test dart-lang Скилл dart-add-unit-test для Claude Code, Codex и других агентов пишет и организует юнит-тесты на package:test. Включается при добавлении логики или исправлении багов, чтобы избежать регрессий. CX Codex +1 21 400установок dart-generate-test-mocks dart-lang Скилл dart-generate-test-mocks для юнит-тестов на Dart: агент выносит внешние зависимости в конструктор, генерирует моки через mockito и build_runner, потом пишет тесты. CX Codex +1 20 300установок dart-test-fundamentals kevmoo Скилл dart-test-fundamentals для Claude Code и Codex задаёт стандарты работы с библиотекой package:test в Dart. Инструмент следит за структурой тестов, вызовами setUp и очисткой ресурсов через addTearDown. CX Codex +1 455установок dart-test-coverage kevmoo Скилл dart-test-coverage для Claude Code запускает сбор покрытия Dart-пакета, разбирает пропущенные строки и помогает наметить тесты. Помогает выявить непроверенный код в lib/. CX Codex +1 163установок cpp-testing affaan-m Скилл cpp-testing для Claude Code ведёт агента по циклу red-green-refactor и настраивает GoogleTest с CMake/CTest. Восстанавливает стабильность падающих тестов на C++17/20. CX Codex +1 6 500установок cpp-pro Seth Hobson Субагент cpp-pro пишет код на C++ по стандартам от C++11 до C++23 с упором на RAII, умные указатели и алгоритмы STL. Помогает при рефакторинге и поиске проблем с памятью. CX Codex 781установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой