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

robodojo-motion-control — скилл для Claude Code: IK и установка

Скилл robodojo-motion-control для Claude Code объясняет планирование движений RoboDojo, восстановление после отказа IK и диагностические счётчики. Помогает разобрать, почему робот не достиг заданной позы.

MIT ★ 488 обновлён 2026-11-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Open-RUA/uni-robot-agent --skill robodojo-motion-control -a claude-code
Открыть на GitHub

Что делает robodojo-motion-control

Скилл объясняет, как RoboDojo строит маршрут по точкам и что означают результаты восстановления после отказа IK. Он различает исходную цель target_pose и временную точку исполнения, которую показывает execution_target_position и execution_target_quaternion.

Проверка IK для каждой точки остаётся строгой: 1 mm и 0.02 rad. После отказа поиск может один раз подобрать временную цель в пределах 80% допусков конечной позиции и ориентации; фактическое положение всё равно должно соответствовать исходным допускам. Автоматического возврата в центр цели нет.

Скилл разбирает счётчики ik_statistics и recovery.stats, причины отказа и обратную связь выполнения. Успешный вызов инструмента сам по себе не подтверждает достижение позы или захват объекта: нужны измеренное состояние и изображения. Проверки конечной точки не гарантируют отсутствие столкновений на всём пути.

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

  • разобрать причины отказа IK по диагностическим счётчикам
  • отличить временную цель восстановления от исходной позы
  • проверить, достиг ли робот заданной позиции
  • оценить, подтверждает ли обратная связь захват объекта

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

  • Объясни, что означают ik_statistics и recovery.stats после отказа движения.
  • Сравни target_pose с execution_target_position и объясни, куда направлена рука.
  • По feedback.pose_reached и фактической позе определи, достиг ли робот цель.

Как установить robodojo-motion-control

1Через Skills CLI (Vercel)

npx skills add Open-RUA/uni-robot-agent --skill robodojo-motion-control -a claude-code

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

~/.claude/skills/motion-control/SKILL.md

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

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

Вопросы о robodojo-motion-control

Как установить robodojo-motion-control в Claude Code?

Выполни npx skills add Open-RUA/uni-robot-agent --skill robodojo-motion-control -a claude-code. Файл скилла находится по пути ~/.claude/skills/motion-control/SKILL.md.

Что делает robodojo-motion-control?

Скилл объясняет нативный IK RoboDojo, временные цели восстановления, ограничения движения и диагностические счётчики. Он также описывает, как сверять обратную связь с фактическим состоянием робота.

Какие ограничения IK и восстановления описывает скилл?

Проверка IK для точки использует допуски 1 mm и 0.02 rad. После отказа RoboDojo может один раз найти временную цель в пределах 80% исходных допусков, но измеренное положение должно удовлетворять исходной цели.

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

SKILL.md · MIT
---
name: robodojo-motion-control
description: Interpret RoboDojo native IK, temporary recovery goals, motion guards and diagnostic counters.
---

# Interpret RoboDojo motion and recovery

Use `general/gripper/pose-targeting/SKILL.md` to construct pose targets and
`general/gripper/motion-recovery/SKILL.md` to choose a changed recovery from
observed evidence. The details below describe this backend, not other robots.

## Waypoint planning and temporary goals

Profiles set waypoint limits and final arrival tolerances; they add no approach
height. RoboDojo keeps strict native waypoint IK (1 mm / 0.02 rad). After a
planning rejection, one recovery search per move may choose a temporary execution
goal within 80% of the original final position and orientation tolerances.
The requested target remains unchanged for measured arrival checks. Read
`goal_recovery` and per-arm `execution_target_position`/`execution_target_quaternion`
to distinguish the route's temporary endpoint from the original `target_pose`.
There is no automatic return to the exact goal center or coarse-to-fine phase.
Choose tolerances that the intended operation permits before submitting move.

## Recovery diagnostics

Per-arm `recovery.rejected` records stages for finally rejected candidates.
`native_not_converged` and `native_constraint_rejected` are distinct; a candidate
can have both. `collision_or_native_constraint` means a sampled joint connection
failed a native constraint check, not necessarily that endpoint IK failed.

`goal_recovery` records the optional once-per-move final-region search. A found
candidate is only a temporary execution goal: subsequent waypoints still need
IK and measured arrival must satisfy the original goal's tolerances. There is
no automatic tightening phase. Inspect actual feedback before dependent actions.

## Execution feedback and limits

A successful tool call does not prove physical arrival or task success. Inspect
`feedback.pose_reached`, actual position/orientation, executed steps and stop
reason. `grasp` or `release` does not prove object attachment or detachment.
Use measured state and images to verify the intended effect.

The current native IK includes modelled self/table constraints. Other action
routes do not necessarily have identical checks. Endpoint checks and joint
jump guards do not establish collision-free swept motion; task objects, the
other arm and carried objects are not automatically represented by the public
robot geometry. Plan short observable approaches and check clearances.

This interface does not add a timed-trajectory guarantee. Control steps consume
native episode budget; model thinking and network delay are separate wall time.
On a partial or uncertain action, inspect returned state/status instead of
replaying the same physical request.

## IK recovery goals and counts

RoboDojo keeps each native waypoint solve at 1 mm / 0.02 rad. After a rejected
waypoint, move may search once for a temporary endpoint inside 80% of the original
final position/orientation tolerances. `target_pose` remains the requested goal;
`execution_target_position` and `execution_target_quaternion` identify the
possibly adjusted endpoint. `goal_recovery` reports that search, not physical
arrival. Actual pose must still satisfy the original tolerances; there is no
automatic return to the center or coarse-to-fine phase.

Primitive per-arm `recovery.stats` and move's aggregate `ik_statistics` count:

- `ik_requests`: one arm's strict waypoint planning request, including held arms
  when actually solved; arms skipped after an earlier rejection are not counted.
- `ik_request_failures`: requests still rejected after candidate recovery.
- `solver_calls` / `seeds_attempted`: 32 then 128 means two calls and 160 seeds.
- `candidates_returned`: distinct seed results, with the true top1/topN alias removed.
- `candidates_checked` / `candidates_rejected`: candidates examined / finally rejected.
  Raw and legal whole-turn representations are branches of one candidate.

`seed_budget` retains its existing meaning: the largest single solve's seed
budget, not the sum. Different seeds with equal joint vectors remain distinct.
`rejected` counts each finally rejected candidate at most once per stage; stages
can overlap, so their sum is not a count of failures. Raw top1 convergence, native
feasibility and pose errors are reported separately from its combined success.
`ik_candidate_rejected` covers validation/connection failures and mixed stages;
none of these finite searches proves the requested pose mathematically impossible.

The waypoint IK rejection rate is `ik_request_failures / ik_requests` when the
denominator is nonzero. Region-search calls are separately recorded under
`goal_recovery.diagnostics` and are excluded from that fraction. Do not sum move
aggregates and their primitive receipts together. Across logs, identify each
primitive request and arm once. `ik_statistics=null` means this backend provided
no such counters, not that zero IK requests failed.

## Recovery and episode stopping

IK failure and joint-jump rejection are recoverable planning feedback, not task
failure or an environment failure preventing interaction. While the task remains
incomplete, interaction is available and budget remains, continue recovery.
Neither one rejection nor repeated rejections justify finish, ending the turn,
or declaring the task impossible. Abandon an ineffective route, not the goal.

© Open-RUA · MIT · Open-RUA/uni-robot-agent

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

Каталог скиллов SKILL.md →
admission-control grafana Скилл admission-control помогает писать валидаторы и мутаторы для приложений на grafana-app-sdk: проверка и правка ресурсов до сохранения в Kubernetes. CX Codex +1 4 600установок openclaw-control-center reason-machines Скилл openclaw-control-center для Claude Code показывает агентов OpenClaw, задачи, токены, связи сессий, память и документы. Режим чтения включён по умолчанию для аудита операций. CX Codex +1 4 400установок Desktop Control patrickporto Скилл Desktop Control для Claude Code и других агентов: управляет мышью, клавиатурой и экраном через CLI uvx desktop-agent. Решает задачи, недоступные в терминале. CX Codex +1 4 000установок tigris-security-access-control tigrisdata Скилл tigris-security-access-control настраивает доступ к объектному хранилищу Tigris: ключи, роли, CORS и подписанные URL. Нужен при защите бакетов и проверке настроек доступа. CX Codex +1 3 900установок control-cli cursor Скилл control-cli для Claude Code, Codex, Cursor и других агентов собирает локальный стенд для управления интерактивным CLI или TUI. Запускает детерминированные сценарии ввода, снимает транскрипты и профили — без сетевых зависимостей. CX Codex +1 2 700установок control-ui cursor Скилл control-ui подключает локальную автоматизацию браузера или CDP для проверки интерфейсов веб-приложений и Electron. Помогает собирать скриншоты и профили производительности. CX Codex +1 2 600установок

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

Весь набор →
held-object-geometry Скилл held-object-geometry для Claude Code определяет положение нужной части предмета относительно захвата. Включается, когда робот переносит груз, проходит рядом с препятствием или готовится к контакту с инструментом. CX Codex +1 ★ 488звёзд репо reachability-and-recovery Скилл reachability-and-recovery для Claude Code выбирает руку, подход и допустимую передачу для полного маршрута захвата. Запускается, когда доступ к месту назначения сомнителен или нужно переназначить маршрут. CX Codex +1 ★ 488звёзд репо handover Скилл handover для Claude Code передаёт удерживаемый объект из одной роботизированной руки в другую. Агент использует его для передачи между руками, а не для обычной укладки одной рукой. CX Codex +1 ★ 488звёзд репо scene-memory Скилл scene-memory для Claude Code сохраняет связи между объектами, их исходными положениями и событиями. Агент подключает его, когда следующий шаг зависит от демонстрации, прошлого наблюдения или действия другого участника. CX Codex +1 ★ 488звёзд репо supported-contact Скилл supported-contact для Claude Code планирует контакт с объектом и движение вспомогательной руки. Включается, когда нужно удержать груз и одновременно поправить или зафиксировать его приёмник. CX Codex +1 ★ 488звёзд репо pose-targeting Скилл pose-targeting для Claude Code задаёт позицию и ориентацию цели движения робота. Используется при смене инструмента, повороте или выравнивании детали в захвате. CX Codex +1 ★ 488звёзд репо contact-effect Скилл contact-effect для Claude Code проверяет контакт с целью по наблюдаемым изменениям и помогает скорректировать движение. Включается при новом контакте или после изменения хвата, геометрии инструмента либо опоры. CX Codex +1 ★ 488звёзд репо placement-and-engagement Скилл placement-and-engagement для Claude Code планирует размещение и механическое соединение объектов по их видимым признакам. Включается, когда нужно проверить опору, вложение детали или её посадку в соединение. CX Codex +1 ★ 488звёзд репо

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

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