dart-ci — скилл для Claude Code: отладка CI в GitHub Actions
Скилл dart-ci помогает агенту разобраться, почему упал CI в DART: команды gh для логов, таблица типовых сбоев по платформам и порядок локального воспроизведения.
BSD-2-Clause 1 установок ★ 1 232 обновлён 2026-10-29
npx skills add dartsim/dart --skill dart-ci -a claude-codeЧто делает dart-ci
Скилл включается, когда падает проверка в PR или что-то не так с GitHub Actions. Внутри набор команд gh: список прогонов по ветке, лог упавшего джоба через gh run view <RUN_ID> --job <JOB_ID> --log-failed, статус и ссылка в JSON. Перезапускать упавшие джобы скилл велит только после явного согласия мейнтейнера или пользователя.
Дальше таблица типовых сбоев. Форматирование лечится pixi run lint, падение Codecov требует тестов на непокрытые строки, на FreeBSD RTTI меняют dynamic_cast на static_cast вместе с enum типа, а SEGFAULT на macOS ARM64 — на std::vector<T> вместо alloca() и VLA. Для Filament отдельная ветка: конфиг с -DDART_ENABLE_GUI_SMOKE_TESTS=ON, потом pixi run test-gui; нативные оконные падения на headless Linux воспроизводят под xvfb-run. Опция smoke-тестов по умолчанию выключена и требует графического устройства.
Есть карта workflow с платформами: ci_ubuntu.yml, ci_macos.yml, ci_windows.yml, ci_freebsd.yml, ci_gz_physics.yml и остальные. FreeBSD, toolchain, CodeQL, wheels и часть ног запускаются только в nightly.yml, и их падения приходят issue nightly-failure, а не чеком в PR. Искать такой сбой в списке проверок PR не стоит. Про кеш скилл говорит коротко: смотреть шаги restore/save и таймстемпы джобов, а не прикидки по длительности. Полный гайд лежит в docs/onboarding/ci-cd.md.
Какие задачи решает
- разобрать, почему упал конкретный job в PR, по логу
--log-failed - воспроизвести сбой gz-physics локально через
pixi run -e gazebo test-gz - убрать SEGFAULT на macOS ARM64, заменив
alloca()наstd::vector<T> - понять, почему сбой не появился среди чеков PR
- прогнать GUI smoke-тесты Filament и найти, где ломается окно
Примеры запросов агенту
- Посмотри, почему упал
ci_macos.ymlв PR<PR_NUMBER>, и покажи лог упавшего джоба. - Воспроизведи падение gz-physics в окружении gazebo и скажи, что менять.
- Проверь статус прогона
<RUN_ID>и не перезапускай ничего без моего согласия.
Как установить dart-ci
1Через Skills CLI (Vercel)
npx skills add dartsim/dart --skill dart-ci -a claude-code2Вручную: положить файлы
~/.claude/skills/dart-ci/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/dart-ci/
1Через Skills CLI (Vercel)
npx skills add dartsim/dart --skill dart-ci -a codex2Вручную: положить файлы
.agents/skills/dart-ci/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dartsim/dart --skill dart-ci -a cursor2Вручную: положить файлы
.cursor/skills/dart-ci/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dartsim/dart .claude/skills/dart-ci2Вручную: положить файлы
.github/skills/dart-ci/SKILL.md1Через Skills CLI (Vercel)
npx skills add dartsim/dart --skill dart-ci -a gemini-cli2Командой платформы
gemini skills install https://github.com/dartsim/dart --path .claude/skills/dart-ciВручную: положить файлы
.devin/skills/dart-ci/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dartsim/dart --skill dart-ci -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о dart-ci
Как установить dart-ci в Claude Code?
Выполните npx skills add dartsim/dart --skill dart-ci -a claude-code. Скилл появится по пути ~/.claude/skills/dart-ci/SKILL.md.
Что делает dart-ci?
Помогает агенту разбирать упавшие прогоны DART в GitHub Actions: даёт команды gh, таблицу типовых сбоев и порядок локального воспроизведения.
Почему падение не видно среди проверок PR?
Часть ног запускается только в nightly.yml, и их сбои оформляются issue nightly-failure. Причину ищите там.
Исходный текст
SKILL.md · BSD-2-Clause
---
name: dart-ci
description: "DART CI: GitHub Actions, cache debugging, and platform-specific failures"
---
# DART CI/CD Troubleshooting
Load this skill when debugging CI failures or working with GitHub Actions.
When the failing claim depends on model/scene structure, physics behavior, or
Filament output, also load `dart-verify-sim` and reproduce it with a text oracle plus
assessed visual evidence. Document a visual exception when graphics support is
unavailable or not applicable in the failing environment.
## Quick Commands
```bash
# Monitor PR checks
gh pr checks <PR_NUMBER>
gh pr view <PR_NUMBER> --json headRefOid,mergeStateStatus,statusCheckRollup
# View run details
gh run list --branch <BRANCH> -e pull_request -L 20
gh run view <RUN_ID> --json status,conclusion,url
# Debug failures
gh run view <RUN_ID> --job <JOB_ID> --log-failed
gh run view <RUN_ID> --json jobs --jq '.jobs[] | {name, databaseId}'
# Rerun failed jobs only after explicit maintainer/user approval
gh run rerun <RUN_ID> --failed
gh run rerun <RUN_ID> --job <DATABASE_ID>
```
## Full Documentation
For complete CI/CD guide: `docs/onboarding/ci-cd.md`
## Common Failure Modes
| Failure Type | Solution |
| -------------------- | -------------------------------------------------------- |
| Formatting fails | `pixi run lint`; push only after approval |
| Codecov patch fails | Add tests for uncovered lines |
| FreeBSD RTTI fails | Use type enums + `static_cast` instead of `dynamic_cast` |
| macOS ARM64 SEGFAULT | Replace `alloca()`/VLAs with `std::vector<T>` |
| RTD build fails | Use defensive `.get(key, default)` patterns |
| gz-physics fails | Reproduce with `pixi run -e gazebo test-gz` |
| CI Filament fails | Configure with `pixi run config -- -DDART_ENABLE_GUI_SMOKE_TESTS=ON`, then run `pixi run test-gui`; native-window failures with `pixi run ctest --test-dir build/<env>/cpp/Release -L filament-native` (`pixi run ctest --test-dir build/<env>/cpp -C Release -L filament-native` on Windows; under `xvfb-run` on headless Linux); consumer failures with `pixi run python scripts/test_gui_install.py` on that build directory |
## Workflow Architecture
The CI workflows that a failing PR check belongs to (full workflow index:
`docs/onboarding/ci-cd.md` § "Workflow Index"):
| Workflow | Purpose | Platforms |
| ------------------- | -------------------------------------- | ---------- |
| `ci_ubuntu.yml` | AI checks, lint, build, test, coverage | Ubuntu |
| `ci_macos.yml` | Lint, build, test | macOS |
| `ci_windows.yml` | Lint, build, test | Windows |
| `ci_filament.yml` | Filament GUI functional lane (`<runner>-Filament-functional`; not yet required) | Ubuntu, macOS; Windows nightly |
| `ci_freebsd.yml` | Build + test (VM) | FreeBSD |
| `ci_simd.yml` | SIMD x86 instruction-level matrix | Ubuntu x86_64 |
| `ci_toolchain.yml` | Alternate toolchain build + test | Ubuntu |
| `ci_gz_physics.yml` | Gazebo integration | Ubuntu |
| `api_doc.yml` | Doxygen API docs build | Ubuntu |
FreeBSD, toolchain, CodeQL, wheels, Linux ASan/coverage/Eigen alignment, macOS
install, the Windows VS 2022 leg and build-requirement checks, and the Filament
Windows leg run only in `nightly.yml`; their failures arrive as
`nightly-failure` issues, not PR checks.
Default test gates exclude device-dependent CTests labeled `gui-device` and
Python rendering tests; device-free GUI tests still run. `pixi run test-gui`
selects all `gui` CTests except `filament-native`. The capture smoke option
`DART_ENABLE_GUI_SMOKE_TESTS` defaults to `OFF`, needs a graphics device, and
replaces `DART_ENABLE_GUI_OSG_SMOKE_TESTS`; `CI Filament` enables it.
## Downstream Compatibility Policy
Package, exported-target, collision, constraint, and dependency changes can
affect Gazebo/gz-physics even when local unit tests pass. Reproduce those
failures with the Gazebo Pixi environment when practical:
`pixi run -e gazebo test-gz`.
## Fast Iteration Loop
1. Identify failing step from job logs
2. Reproduce locally with same build toggles
3. Fix the smallest failing test
4. Push only after explicit maintainer/user approval, then monitor:
`gh run view <RUN_ID> --json status,conclusion,url`
## Caching And Duration
Treat the current run and job logs as authoritative. Inspect cache restore/save
steps and job timestamps before changing a key; do not rely on fixed duration
or cache-speed estimates in this skill.
© dartsim · BSD-2-Clause · dartsim/dart