ibrobot-env

name	ibrobot-env
description	Handles environment setup and command execution. Use BEFORE running any scripts or ROS 2 commands to 'setup environment', 'source .shrc_local', 'set ROS_DOMAIN_ID', '环境变量', '环境初始化', '初始化环境', 'fix import errors', 'ModuleNotFoundError', or 'PYTHONPATH issues'. Triggers whenever environment inheritance is required for correct execution.

IB_Robot Environment Skill

This skill ensures proper environment variable setup before executing Python or ROS 2 commands in the IB_Robot workspace.

Core Requirement

All commands that depend on project environment variables must include environment setup in the same shell call.

Since the Bash tool runs in isolated subshells, environment variables set via source in one call are not retained across different calls. Therefore, source .shrc_local must be combined with the target command in a single call.

Standard Execution Patterns

Running Python Scripts

source .shrc_local && python3 <script.py>

Running ROS 2 Commands

source .shrc_local && ros2 <command>

Running Tests

source .shrc_local && pytest <args>

Building the Project

When ROS 2 source code changes require recompilation:

source .shrc_local && ./scripts/build.sh

Environment Provided by .shrc_local

• Activates Python virtual environment (venv).
• Sets PYTHONPATH including libs/lerobot/src and src directories.
• Sources ROS 2 Humble setup.
• Defines common aliases (cb, cbp, src, etc.).

Common Error Resolution

Error	Cause	Solution
ModuleNotFoundError	PYTHONPATH not set	Prefix with source .shrc_local &&
ros2: command not found	ROS 2 environment not loaded	Prefix with source .shrc_local &&
ImportError: lerobot	venv not activated	Prefix with source .shrc_local &&

Quick Reference

Before executing any operation, always check if you need:

source .shrc_local && <your_command>