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

dart-ci — скилл для Claude Code: отладка CI в GitHub Actions

Скилл dart-ci помогает агенту разобраться, почему упал CI в DART: команды gh для логов, таблица типовых сбоев по платформам и порядок локального воспроизведения.

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

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

Что делает 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-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «DevOps и инфраструктура» →
fix-ci cursor Скилл fix-ci для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — находит упавшие проверки PR, читает логи и применяет минимально нужный фикс. CX Codex +1 2 600установок mcore-create-issue Philip Petrakian Скилл mcore-create-issue исследует упавшие прогоны GitHub Actions в NVIDIA/Megatron-LM, находит причину сбоя и оформляет готовый баг-репорт. CX Codex +1 1 800установок ci-pipeline davila7 Команда ci-pipeline для Claude Code, которая настраивает и проверяет CI/CD в GitHub Actions. Создаёт пайплайны с тестами, матрицей версий и деплоем на staging и production. CX Codex +1 470установок gha ykdojo Скилл gha разбирает падения GitHub Actions: находит, на каком коммите воркфлоу сломался, проверяет историю запусков и ищет открытые PR с исправлением. CX Codex +1 ★ 10 363звёзд репо openai-gh-fix-ci OpenAI Скилл openai-gh-fix-ci разбирает упавшие проверки PR в GitHub Actions через gh: находит причину по логам, предлагает план правки и вносит её только после вашего согласия. CX Codex +1 ★ 540звёзд репо pr-babysitter mblode Скилл pr-babysitter отслеживает открытый пуллреквест на GitHub: устраняет конфликты слияния, чинит упавший CI и разбирает замечания ревьюеров. CX Codex +1 604установок

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

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

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