| 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>
