该技能是面向 ROS 2 机器人开发的系统性工程指南,强调渐进式披露:先通过决策路由确定开发场景,再阅读对应的参考文档,最后在生成的每份代码中贯彻核心工程原则;当任务跨多个领域时,需同时阅读相关文档,并在建议冲突时按安全、确定性、简洁性的优先级取舍。
按用途划分,决策路由覆盖:工作空间、软件包与构建配置;节点、执行器与回调组;话题、服务、动作、自定义接口与 QoS;生命周期节点、组件加载与组合;Launch 文件、条件逻辑与事件处理器;tf2、URDF、xacro 与 robot_state_publisher;ros2_control、硬件接口与控制器;实时约束、PREEMPT_RT、内存与抖动;Nav2、SLAM、代价地图与行为树;MoveIt 2、规划场景与抓取流水线;相机、LiDAR、PCL、cv_bridge 与深度处理;单元测试、集成测试、launch_testing 与 CI;ros2 doctor、追踪、性能剖析与 rosbag2;Docker、交叉编译、集群部署与 OTA;Gazebo、Isaac Sim、sim-to-real 与 use_sim_time;SROS2、DDS 安全、证书与供应链;micro-ROS、MCU/RTOS、XRCE-DDS 与 rclc;多机器人集群、Open-RMF 与 DDS 发现规模;消息类型、单位、协方差与坐标系约定;ROS 1 迁移、ros1_bridge 与混合运行。
主要工程原则包括:明确目标发行版(未指定时默认最新 LTS 即 Jazzy)并固定版本;按节点角色选择 C++ 或 Python;遵循约定式包结构并将接口独立为 _interfaces 包;参数必须声明类型、描述、范围与默认值;错误必须显式处理而非静默吞掉;给出传感器流、控制速度、地图、诊断、参数事件、动作反馈、安全心跳等场景的 QoS 默认配置,并提醒 QoS 不匹配是“发布了却收不到”的首要原因;统一命名约定;区分互斥与可重入回调组,避免在回调中同步调用服务导致死锁;资源型节点优先采用生命周期设计;以及构建与 CI 卫生实践。文中还列出全局变量存状态、硬编码话题名、无界 KEEP_ALL、在回调中 sleep、构造函数内发布、忽略 QoS 兼容性、关闭时未发送安全指令等常见反模式及修复方式,并附发行版升级(Foxy→Humble、Humble→Jazzy、Jazzy→Kilted、ROS 1→ROS 2)的破坏性变更清单与 ros2 CLI 速查。使用方式为:识别用户构建目标,阅读匹配的 references/.md,再应用核心原则生成代码。具体代码模板与完整示例位于各参考文件中,本页暂未展开。