ros2-workspace-ops
Build, test, and source ROS 2 colcon workspaces (ament_cmake/python, rosdep, overlays, parallel-workers). Use for colcon build/test failures, package.xml / CMakeLists issues, workspace setup, or when the user mentions colcon, ament, rosdep, or ROS 2 packages.
Datos de origen
- Repositorio
- guilyx/dotfiles
- Última actividad en el origen
- 12 de agosto de 2026 a las 19:39
- Idioma detectado de SKILL.md
- inglés
- Estrellas
- 0
- Forks
- 0
Opciones de instalación
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Revisa los archivos de origen
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Mostrando SKILL.md
SKILL.md
Instrucciones de origen · Vista previa de solo lectura- name
- ros2-workspace-ops
- description
- Build, test, and source ROS 2 colcon workspaces (ament_cmake/python, rosdep, overlays, parallel-workers). Use for colcon build/test failures, package.xml / CMakeLists issues, workspace setup, or when the user mentions colcon, ament, rosdep, or ROS 2 packages.
# ROS 2 Workspace Ops
## Hard constraints (this machine)
- **`colcon` parallel workers: max 2** (`--parallel-workers 2`) unless the user overrides — more can OOM/crash the host.
- Prefer container builds when the project rule says so (e.g. SIRB `./sirb build-ws`); never fight that rule.
## Standard loop
```bash
source /opt/ros/$ROS_DISTRO/setup.bash
cd <ws>
rosdep install --from-paths src --ignore-src -y # when deps changed
colcon build --symlink-install --parallel-workers 2 --packages-select <pkg>
source install/setup.bash
colcon test --parallel-workers 2 --packages-select <pkg>
colcon test-result --verbose
```
Useful flags:
```bash
colcon build --packages-up-to <pkg> --parallel-workers 2
colcon build --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo
colcon build --event-handlers console_direct+
```
## Overlay order
Source **underlay → shared overlay → your overlay**. Always `install/setup.bash`, never `build/`.
## Triage
| Symptom | Likely fix |
|---------|------------|
| Package not found | `colcon list`; wrong cwd / not sourced |
| Missing CMake package | source underlay; `rosdep install` |
| Msgs unknown at runtime | rebuild interface pkg + re-source overlay |
| Python edits ignored | `--symlink-install` or clean rebuild |
| OOM mid-build | `--parallel-workers 2` or `--executor sequential` |
| Duplicate package name | two copies under `src/` |
## Report format
- Workspace + package scope
- Commands run
- Pass/fail + first actionable error
- Recommended next fix
Ver en GitHub