ros2-engineering-skills — плагин
Навык для ROS 2: агент сверяет граф, типы и QoS с живой системой, прежде чем править код, и проверяет результат валидаторами
- 238 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки запускают Python-скрипты на каждый вызов инструмента, а навык направляет агента к командам `ros2`, которые могут двигать оборудование.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/ros2-engineering-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки запускают Python-скрипты на каждый вызов инструмента, а навык направляет агента к командам `ros2`, которые могут двигать оборудование.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет объединяет корневой `SKILL.md`, справочники по темам ROS 2 и скрипты статической проверки. Навык ведет агента по задачам из разработки роботов: рабочие пространства и пакеты, executor-ы, DDS QoS, жизненный цикл узлов, tf2, ros2_control, Nav2, MoveIt 2, восприятие, безопасность, тесты и развертывание. Подробные таблицы и 22 типичные ошибки лежат в `references/engineering-principles.md` и подгружаются только при необходимости. Главная привычка, которую навык прививает агенту: отличать правдоподобное объяснение от наблюдаемого поведения. Перед правкой QoS агент смотрит `ros2 topic info -v` и список узлов, а не угадывает причину. Для нового драйвера он собирает пакет с launch-файлом, параметрами, тестами и объявленными контрактами по кадрам, меткам времени и пределам. В плагине Claude Code есть хуки. PreToolUse предупреждает о командах `ros2`, которые могут двигать железо, например `ros2 topic pub /cmd_vel`, цель навигации, переключение контроллера или сброс аварийной остановки. Хук Stop выдает итоговый отчет с советами.
Для кого. Инженерам-робототехникам на ROS 2, которые поручают агенту драйверы, launch-файлы, Nav2 и ros2_control и не хотят правок наугад.
Подходит, если
- Подписчик не получает сообщения, и причину надо искать по графу, типам и QoS, а не гадать.
- Нужен новый C++ или Python пакет драйвера лидара с тестами и launch-файлом.
- Конфигурация Nav2 или ros2_control правится, и агент должен проверять, какой YAML реально загружен.
- Проект переезжает между дистрибутивами ROS 2, и нужны API нужной версии.
Не подходит, если
- Проект на ROS 1 без плана миграции: навык ориентирован на ROS 2.
- Нужна сертификация безопасности робота: авторы прямо исключают такую замену.
- Агент должен управлять реальным оборудованием без оператора: хук лишь предупреждает и не заменяет аварийный останов.
Пример запроса к агенту
Подписчик на `/camera/image_raw` ничего не получает. Проверь граф, тип и QoS у издателя и только потом описывай правку.Ограничения
Хук PreToolUse по умолчанию только напоминает модели и ничего не блокирует. Режим `ROS2_SKILL_ACTUATION=ask` помечен экспериментальным и включает вопрос перед опасной командой, значение `off` отключает проверку. Хук ищет имена в командах POSIX shell и функцией безопасности не считается: оператор и независимый канал остановки нужны всегда. Для хуков и установщика нужен `python3` версии 3.10 или новее, сборка и запуск проверок требуют целевой стек ROS. Установленная копия фиксируется в `INSTALL_PROVENANCE.json` с хешами файлов, но это не подписанная аттестация.
Как отключить. Для плагина выполните `/plugin uninstall ros2-engineering@ros2-engineering-skills`. Копию навыка, поставленную установщиком, удалите из каталога навыков агента.
Частые вопросы
Как поставить ros2-engineering-skills в Claude Code?
Выполните `claude plugin marketplace add dbwls99706/ros2-engineering-skills`, затем `claude plugin install ros2-engineering@ros2-engineering-skills`.
Как поставить навык в Codex, Cursor или Gemini CLI?
Склонируйте репозиторий, поставьте зависимости из `requirements.txt` и запустите `python3 scripts/install_skill.py --client codex`. Вместо `codex` подойдут `cursor`, `gemini` и `claude`.
Блокирует ли хук опасные команды `ros2`?
По умолчанию нет, он только дописывает заметку для модели. Режим `ROS2_SKILL_ACTUATION=ask` включает вопрос перед запуском.
Как убедиться, что установка не повреждена?
Команда `python3 scripts/install_skill.py --verify --client codex` сверяет файлы с манифестом и возвращает код 0 только для чистой установки.
Какие версии Python нужны?
Python 3.10 или новее, в CI проверяются версии с 3.10 по 3.14.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныДесять скиллов по робототехнике: ROS 1 и ROS 2, QoS, тесты, Docker, запуск робота, восприятие и защита для агентов-программистов
MCP-сервер для ROS 2: агент смотрит топики, сервисы и действия робота, читает карты и облака точек и при желании управляет им
Плагин Grid Dynamics загружает в сессию кодового агента общие инженерные стандарты, архитектуру и рабочие процессы команды
Скиллы по робототехнике для Claude Code, Codex, Gemini CLI и Cursor: ROS 2, симуляторы, навигация и готовые демо.
Набор независимых скиллов против дрейфа в больших кодовых базах: hard-cut, поиск первопричины, тесты и проверка CI.
Набор из 29 скиллов, которые заставляют агента думать как старший инженер до написания кода: планы, причины сбоев и ревью
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ros2-engineering-skills (эта карточка) | нет | 238 | ||
| Robotics Agent Skills | нет | 401 | Robotics Agent Skills охватывает робототехнику шире, а этот набор целиком про ROS 2 и содержит валидаторы и хуки. | |
| ROS2 MCP | да | не нужна | 99 | ROS2 MCP дает агенту доступ к живому роботу через MCP, а здесь только знания, проверки кода и предупреждения. |
Коротко о README
Это руководство по ROS 2 для агентов с маршрутизатором задач в `SKILL.md`, справочниками, статическими валидаторами и регрессионными тестами. Версия источника 1.8.0, проверки идут в CI на нескольких дистрибутивах.