跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

yam-motion-planner

Use for YAM cuRobo planning/IK failures, no-motion vs real-robot planning mismatch, waypoint robustness sweeps, perturbation testing, and recovery after motion planner failures.

NVlabs · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add NVlabs/ASPIRE --skill yam-motion-planner

技能说明


name: yam-motion-planner description: "Use for YAM cuRobo planning/IK failures, no-motion vs real-robot planning mismatch, waypoint robustness sweeps, perturbation testing, and recovery after motion planner failures."

YAM Motion Planner

cuRobo is sensitive to the real start state. A no-motion/pre-motion plan can pass, then a real run can fail because physical execution replans from the actual EEF pose, joint state, gripper load, or a slightly different scene pose.

When cuRobo fails:

  1. Inspect the current scene, robot state, failed target pose, and failed stage.
  2. Decide whether the target is physically unreasonable or just planner-sensitive.
  3. If the motion is feasible, do not treat one IK/path failure as final.
  4. Try nearby target offsets and extra waypoints that make the same task easier: retreat lanes, lift-before-shift, shift-before-approach, lower/higher staging poses, or less extreme rack/bin/place coordinates.
  5. Preview from the current robot state, not only from an ideal scripted state.
  6. Prefer waypoint sets that pass perturbation sweeps, not just one clean pass.

Robustness sweep pattern:

  • Perturb candidate waypoints and final targets by small XYZ/RPY offsets that represent likely real-world variance.
  • Include start-state sensitivity when possible: preview from the current arm posture, or rerun previews after moving to the actual preceding waypoint.
  • Record pass/fail rate, first failed stage, pose, and planner error in logs/<run>/plans/.
  • Pick the candidate with high pass rate, clear margins from obstacles, and simple task semantics.

Useful sweep examples:

  • legacy_codes/kitkat_trash_waypoint_robustness_sweep.py
  • legacy_codes/kitkat_handover_clearance_waypoint_sweep.py
  • legacy_codes/bottle_rack_waypoint_robustness_sweep.py
  • legacy_codes/bottle_fixed_pour_waypoint_robustness_sweep.py

Typical useful perturbations:

  • placement/drop targets: x,y,z +/- 2-5 cm
  • staging/retreat waypoints: x,y,z +/- 3-8 cm
  • orientation: yaw/roll/pitch variants near the intended gripper axis
  • approach order: split compound moves into one-axis waypoints

If a real run stops after a cuRobo failure while holding an object, first reason from the current scene. If the object is still safely held, plan a held-object recovery from the current EEF pose: preview nearby rack/bin/table targets, add intermediate waypoints, release, retreat, then home/open. Ask the human to reset only if the scene is physically broken or unsafe for the robot to fix.